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.
opaquePaymentCardstring

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

encryptedPassDatastring

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

ephemeralPublicKeystring

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

activationDatastring

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

cardNetworkstringrequired

Possible values: [CARD_NETWORK_VISA, CARD_NETWORK_MASTERCARD]

tokenProviderstringrequired

Possible values: [TOKEN_PROVIDER_VISA, TOKEN_PROVIDER_MASTERCARD]

customer object

Customer information about specific card holder.

address1stringrequired

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

Example: Tsarigradsko Shose 73
address2string

Possible values: <= 30 characters

address3string

Possible values: <= 30 characters

citystringrequired

Max 30 characters: letters, spaces, hyphen and period

Possible values: <= 30 characters

Example: Sofia
countryCodestringrequired

Country code in ISO-3166 Alpha 2

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

Example: BG
statestring

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

Possible values: <= 3 characters

postalCodestringrequired

For EU customers: maximum length 16

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

minimum 4, maximum 10

Possible values: non-empty and <= 16 characters

Example: 1000
namestringrequired
Example: John Roger Smith
mobilestringrequired

Mobile phone number used during card creation.

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

cardLastDigitsstringrequired

Last four digits of the card.

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

Example: 4234
CardTokenization
{
  "opaquePaymentCard": "string",
  "encryptedPassData": "string",
  "ephemeralPublicKey": "string",
  "activationData": "string",
  "cardNetwork": "CARD_NETWORK_VISA",
  "tokenProvider": "TOKEN_PROVIDER_VISA",
  "customer": {
    "address1": "Tsarigradsko Shose 73",
    "address2": "string",
    "address3": "string",
    "city": "Sofia",
    "countryCode": "BG",
    "state": "string",
    "postalCode": "1000",
    "name": "John Roger Smith",
    "mobile": "string"
  },
  "cardLastDigits": "4234"
}