Skip to main content

CardTokenizationEvent

A webhook event related to prepaid card tokenization updates.

iduuidrequired

Change identifier.

Example: af5c8b52-0afd-4799-85ab-fe659a076932
cardIduuidrequired
Example: af5c8b52-0afd-4799-85ab-fe659a076932
customerIdstringrequired

Wallet customer id.

Possible values: <= 50 characters

walletTypeTokenWalletType (string)

Specifies the type of digital wallet used for storing and managing tokens.

  • APPLE - Apple Wallet.
  • GOOGLE - Google Pay Wallet.
  • MRCHTOKEN - Merchant-specific digital wallet.
deviceMobileNumberstring

Telephone number of the device linked to the token(if applicable).

deviceIpstring

IP address (full or last part only) of the device at time of binding / digitisation.

deviceIdstring

Unique ID of the secure element in the device linked to the token.

deviceTypeTransactionDeviceType (string)

Specifies the method used for processing transactions.

  • POS - Point-of-Sale terminal.
  • ATM - Automated Teller Machine.
  • GPT - Gaming Payment Transaction.

Possible values: [POS, ATM, GPT]

creatorStatusCreatorStatus (string)

Status of the payment token as received from the payment token creator (normally Visa or Mastercard).

  • A = Active
  • D = Deleted (once in this status, it is normally never changed)
  • I = Inactive
  • N = Not Tokenised
  • P = Pending
  • S = Suspended
  • U = Unknown
  • X = Deactivated

Possible values: [A, D, I, N, P, S, U, X]

langstring

The language configured on the device linked to the token (if available).

activationMethodstring

Which activation method was used: 0 = none 1 = SMS to mobile phone 2 = email 3 = cardholder called an automated call centre; 4 = cardholder called a human call centre 5 = website 6 = mobile application 7 = voice phone call

Possible values: <= 1 characters

activationMethodDatastring
eventTimestampdate-time

Represents RFC 3339, section 5.6 date-time.

Example: 2021-07-15T17:54:12Z
enrollmentStatusTokenEnrollmentStatus (string)

Represents the various statuses that can occur during the token enrollment process.

  • TOKENIZATION_INITIATED - The process of tokenization has been started but is not yet completed.
  • TOKENIZATION_FAILED - The tokenization process encountered a failure at some point.
  • TOKENIZATION_ENROLLMENT_UNSUCCESSFUL - Attempt to enroll the token was unsuccessful.
  • ENROLLMENT_SUCCESSFUL - The token enrollment process has successfully completed.
  • ACTIVATION_OTP_SENT - An OTP (One-Time Password) for activation has been sent.
  • DEACTIVATION - The token has been deactivated.
  • TOKEN_SUSPENDED - The token has been suspended temporarily.
  • TOKEN_RESUMED - A previously suspended token has been resumed.
  • TOKENIZATION_FAILED_MC - Tokenization failed due to a specific reason related to MasterCard (MC).

Possible values: [TOKENIZATION_INITIATED, TOKENIZATION_FAILED, TOKENIZATION_ENROLLMENT_UNSUCCESSFUL, ENROLLMENT_SUCCESSFUL, ACTIVATION_OTP_SENT, DEACTIVATION, TOKEN_SUSPENDED, TOKEN_RESUMED, TOKENIZATION_FAILED_MC, ACTIVATION_OTP_SENT_MC]

paymentTokenTypePaymentTokenType (string)

Payment token type.

  • C - Contactless Device PAN
  • CF - Card on File PAN
  • CL - Cloud-base payments PAN
  • P - Real PAN (i.e. a normal ISO form factor card)
  • SE - Secure Element PAN
  • U - Unknown
  • V - Virtual PAN (i.e. virtual card)
  • BW - Browser-accessible wallet

Possible values: [C, CF, CL, P, SE, U, V, BW]

paymentTokenIdstring

Payment token identifier for the MDES or VTS Card.

eventIdstring

Possible values: <= 50 characters

Example: 14450949864
CardTokenizationEvent
{
  "id": "af5c8b52-0afd-4799-85ab-fe659a076932",
  "cardId": "af5c8b52-0afd-4799-85ab-fe659a076932",
  "customerId": "string",
  "walletType": "string",
  "deviceMobileNumber": "string",
  "deviceIp": "string",
  "deviceId": "string",
  "deviceType": "POS",
  "creatorStatus": "A",
  "lang": "string",
  "activationMethod": "string",
  "activationMethodData": "string",
  "eventTimestamp": "2021-07-15T17:54:12Z",
  "enrollmentStatus": "TOKENIZATION_INITIATED",
  "paymentTokenType": "C",
  "paymentTokenId": "string",
  "eventId": "14450949864"
}