Get token by token unique reference ID
Retrieves details of a token by its card scheme’s unique reference. Typical use case: allow customer systems to display token information.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Optional audit user header
Path Parameters
Token unique reference ID identifying the token to retrieve. A unique identifier for the token assigned by the Token Service Provider (TSP) (eg. Visa or MC) to manage the lifecycle of the token.
1 - 64^[A-Za-z0-9_-]+$"DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a11d9c"
Query Parameters
If true, token will be fetched directly from the card scheme (e.g., Mastercard, Visa).
If false, token will be fetched from the internal system.
If true, the response will include the raw payload from the card scheme for the token (if available).
If false, the card scheme payload will be omitted from the response.
Response
Successful lookup of token for given token unique reference ID.
Represents a digital wallet token.
A unique identifier for the token assigned by the Token Service Provider (TSP) (eg. Visa or MC) to manage the lifecycle of the token.
1 - 64^[A-Za-z0-9_-]+$"DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a11d9c"
Identifier used by merchants or wallet providers to request tokens from the TSP.
"212345678"
Code of the wallet provider or merchant that requested the token (APPLE_PAY /GOOGLE_PAY/SAMSUNG_PAY/OTHER). OTHER is used for tokens not linked to a wallet provider, such as merchant tokens (credential-on-file, subscription payments) or cloud tokens (e.g., Mastercard APANs).
APPLE_PAY, GOOGLE_PAY, SAMSUNG_PAY, OTHER "APPLE_PAY"
Current status of the token:
- ACTIVE - Available for payments
- DEACTIVATED - Permanently deactivated
- INACTIVE - Waiting for activation
- SUSPENDED - Temporarily not available for payments
ACTIVE, DEACTIVATED, INACTIVE, SUSPENDED "ACTIVE"
The last 4 digits of the tokenised PAN (DPAN) used for display and identification purposes.
"7890"
If the token was deleted from the consumer app
The wallets common name for authorization decision.
GREEN, YELLOW, ORANGE, RED "YELLOW"
The id of the card associated with the token.
"20218aae-b15e-406c-9e9f-23735cd86a48"
The timestamp when the token was created by the TSP.
The timestamp of the most recent update to the token’s status.
The version number of the entity.
1
The raw payload from the card scheme, if available.
Device information.

