Skip to main content

CardTokenization

Card Tokenization contains the needed information in order specific card to be added to APPLE/GOOGLE Pay. Depending on the mobile device, some of the fields are optional.

  • opaquePaymentCard - it will be returned only for Google Pay.
  • encryptedPassData - will be returned only for Apple Pay.
  • ephemeralPublicKey - will be returned only for Apple Pay.
  • activationData - will be returned only for Apple Pay.
    opaquePaymentCard string

    Opaque payment card - needs to be shared with Google Pay 'as is' and will be presented to TSP to receive a token.

    encryptedPassData string

    An encrypted info containing the sensitive information needed to add a card to Apple Pay.

    ephemeralPublicKey string

    The ephemeral public key used by elliptic curve cryptography (ECC) used with Apple Pay.

    activationData string

    This property contains the data provided to the payment network as a cryptographic one-time pad (OTP), per the Payment Network API specification.

    cardNetwork stringrequired

    Possible values: [CARD_NETWORK_VISA, CARD_NETWORK_MASTERCARD]

    tokenProvider stringrequired

    Possible values: [TOKEN_PROVIDER_VISA, TOKEN_PROVIDER_MASTERCARD]

    customer

    object

    Customer information about specific card holder.

    address1 stringrequired

    Possible values: >= 4 characters and <= 40 characters

    address2 string

    Possible values: <= 30 characters

    address3 string

    Possible values: <= 30 characters

    city stringrequired

    Possible values: <= 30 characters

    Max 30 characters: letters, spaces, hyphen and period

    countryCode stringrequired

    Possible values: >= 2 characters and <= 2 characters

    Country code in ISO-3166 Alpha 2

    state string

    Possible values: <= 3 characters

    For US Customers: 2,3-character state or province abbreviation Example: "UT"

    postalCode stringrequired

    Possible values: non-empty and <= 16 characters

    For EU customers: maximum length 16

    For US customers: Pattern: ^[a-zA-Z0-9-\ ]*$

    minimum 4, maximum 10

    name stringrequired
    mobile stringrequired

    Possible values: Value must match regular expression ^\+\d+\s?\d{1,16}$

    Mobile phone number used during card creation.

    cardLastDigits stringrequired

    Possible values: >= 4 characters and <= 4 characters

    Last four digits of the card.