Get Card Payment Token Details - Field Descriptions
The following page details each of the fields received in the response when using the Get Card Payment Token Details endpoint.
Response Fields
A successful request to the Get Card Payment Token Details endpoint returns an HTTP 200 response.
| Field | Description |
|---|---|
| id | Unique payment token identifier for the Mastercard Digital Enablement Services (MDES) or Visa Digital Enablement Program (VDEP) card. |
| walletId | Unique identifier of the wallet provider linked to the payment token. For example: APPLE, ANDROID, or SAMSUNG. |
| walletProvider | Name of the wallet provider linked to the payment token. For example: Apple, Android, or Samsung. |
| tokenPAN | Funding PAN (card PAN), with only the last four digits shown. |
| statuses | Object containing the statuses associated with the payment token. |
| statuses.tokenisedStatus | Tokenisation status of the payment token. The object contains a U = Unknown |
| statuses.authorisationStatus | Status of the authorisation to digitise the payment token. The object contains a U = Unknown Note: This is not the same as a transaction authorisation. |
| statuses.authorisationDecision | Final tokenisation decision. The object contains a U = Unknown |
| statuses.transactionStatus | Status of the payment token as received from the payment token creator, normally Visa or Mastercard. After tokenisation, this status is not changed by Thredd. The object contains a A = Active |
| statuses.gpsStatusInfo | Status of the payment token on the Thredd system. The object contains a A = Active |
| tokenisedDate | Date on which the payment token was tokenised. Format: YYYY-MM-DD. |
| expiryDate | Expiry date of the payment token. Format: YYYY-MM-DD. |
| tokenType | Type of payment token. For example: C (Contactless Device PAN) or CF (Card on File PAN). |
| deviceType | Type of device or technology linked to the payment token. For example: F (Fob or key-fob), M (Mobile phone), or P (Personal computer). |
| deviceName | Name assigned to the device by the cardholder in the wallet. |
| activationCode | Activation code associated with the payment token and used to activate the token. |
| threddDecisionAt | Date and time at which Thredd made the decision associated with the payment token. |
| threddDecision | Thredd decision associated with the payment token. |
| creatorTokenReference | Token creator's unique reference for the payment token, such as the Mastercard Token Unique Reference (TUR) or Visa Token Reference ID. |
| cardUsageGroup | Usage group of the card linked to the payment token. The usage group determines where the payment token can be used, for example at a Point of Sale terminal, ATM, or ecommerce merchant. |
| paymentTokenUsageGroup | Payment Token Usage Group linked to the payment token. Defines configuration options specific to the provisioning of a digital payment token. |
| paymentTokenUsageGroupId | Identifier of the payment token usage group linked to the payment token. If null, the issuer has not configured a usage group for the token. |
| walletAccountScore | Risk score for the account, received from the wallet provider during digitisation: 1 = Highest risk |
| walletDeviceScore | Risk score for the device, received from the wallet provider during digitisation: 1 = Highest risk |
| walletReasons | Wallet service provider tokenisation recommendation reason codes. For details, see Wallet Tokenisation Reason Codes. |
| transactionID | Unique identifier for the transaction. |
| responseCode | Response code indicating the status of the request. |
| transactionDate | Date and time of the transaction. |
| cardAcceptorNameLocation | Name and location of the entity accepting the card payment. |
| bnReference | Banknet or network reference used for transaction tracking or reconciliation. |
| mtid | Message Type Identifier (MTID) for the transaction. For example: 0100 for an authorisation. |
| ehiRequestTime | Date and time at which the External Host Interface (EHI) received the request. |
| ehiResponseTime | Date and time at which the External Host Interface (EHI) responded to the request. |
| activationMethod | Activation method used: 0 = None |
| activationStatus | Activation status of the payment token. R = Reason code 00 |
| merchantName | Merchant name associated with the payment token. |
| linkedToken | Linked 16-digit public token. |
| deviceLanguage | Language code associated with the device. |
| location | Device location, represented by latitude and longitude. |
| endOfPhoneNumber | Telephone number information associated with the device. |
| firstname | Cardholder's first name. |
| lastname | Cardholder's last name. |
| finalDecisionBy | Identifies who made the final tokenisation decision. |
| panSource | Source of the clear PAN used in the Tokenisation Authorisation Request to create the payment token. |
| creator | Creator of the payment token. |
| txnStatusChanged | Date and time at which the transaction status was last changed. |
| activationCodeExpdate | Date and time at which the activation code expires. |
| replacementCount | Number of times the payment token has been replaced. |
| oldExpDate | Previous expiry date associated with the payment token. |
| deviceID | Identifier of the device associated with the payment token. |
| deviceIP | IP address of the device associated with the payment token. |
| walletAccountHash | Wallet account hash associated with the payment token. |
| digitisationReference | Digital reference supplied by the token creator. |
| termsAndConditions | Terms and conditions information associated with the payment token. |
| externalStatusSetBy | Identifies who or what set the external status. |
| creatorPanReference | PAN reference supplied by the token creator. |
| groupCode | Payment token usage group rule name or code. |
| groupDescription | Description of the payment token usage group rule. |
| panSourceDescription | Description of the PAN source. |
Updated 15 days ago