MppCardDataParameters

@interface MppCardDataParameters : NSObject

Class describing card data parameters.

MppCardDataParameters properties

  • Get Tokenization Receipt parameter type.

    Declaration

    Objective-C

    @property (nonatomic, readonly) CardDataType type;

Properties for card secret

  • Contains Card ID selected by the Issuer, which is later used by the WSP to send to the Issuer for validation. Max length 64.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *cardId;

    Return Value

    The card id.

  • Contains secret value generated by the Issuer, which is later used to the WSP to exchange it versus real card data from the Issuer. Max length 64.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *cardSecret;

    Return Value

    The card secret.

Properties for encrypted PAN

  • Encrypted card data

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *encryptedCardData;

    Return Value

    Encrypted card data.

  • Public Key Fingerprint. Used to recognise the key to be used for AES key decryption.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *publicKeyFingerprint;

    Return Value

    Public Key Fingerprint.

  • Encrypted AES key used for encrypted card data.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *encryptedKey;

    Return Value

    Encrypted AES key.

  • Initial Vector used for encrypted card data.

    Declaration

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSString *initialVector;

    Return Value

    Initial Vector.

MppCardDataParameters methods

  • Create card data parameters with card secret.

    Declaration

    Objective-C

    + (nonnull instancetype)cardDataParametersWithCardId:(NSString *_Nonnull)cardId
                                              cardSecret:
                                                  (NSString *_Nonnull)cardSecret;

    Parameters

    cardId

    Contains Card ID selected by the Issuer, which is later used by the WSP to send to the Issuer for validation. Max length 64.

    cardSecret

    Contains secret value generated by the Issuer, which is later used to the WSP to exchange it versus real card data from the Issuer. Max length 64.

    Return Value

    MppCardDataParameters object instance.

  • Create card data parameters with encrypted PAN data.

    Declaration

    Objective-C

    + (nonnull instancetype)
        cardDataParametersWithEncryptedCardData:
            (NSString *_Nonnull)encryptedCardData
                           publicKeyFingerprint:
                               (NSString *_Nonnull)publicKeyFingerprint
                                   encryptedKey:(NSString *_Nonnull)encryptedKey
                                  initialVector:(NSString *_Nonnull)initialVector;

    Parameters

    encryptedCardData

    Encrypted card data.

    publicKeyFingerprint

    Public Key Fingerprint. Used to recognise the key to be used for AES key decryption.

    encryptedKey

    Encrypted AES key used for encrypted card data.

    initialVector

    Initial Vector used for encrypted card data.

    Return Value

    MppCardDataParameters object instance.

  • Verify if card data parameters are valid.

    Declaration

    Objective-C

    - (BOOL)isValid;

    Return Value

    Bool value if card data parameters are valid.

  • Verify if card data parameters are valid.

    Declaration

    Objective-C

    - (nonnull NSError *)validate;

    Return Value

    nil if card data parameters are valid, NSError* otherwise.