| Column | Data type | Allowed values / format | Description |
|---|---|---|---|
event_type | string | token | Type of token event represented by the row. |
event_created_at | datetime | ISO 8601 datetime | Date and time when the event occurred or was emitted. |
token_event_id | string | String | Unique identifier of the token event. |
token_unique_reference_id | string | 1–64 characters; letters, numbers, underscore, hyphen | Unique identifier for the token, assigned by the Token Service Provider to manage the lifecycle of the token. |
token_requestor_id | string | String | Identifier used by merchants or wallet providers to request tokens from the Token Service Provider. |
token_requestor | string | APPLE_PAY, GOOGLE_PAY, SAMSUNG_PAY, OTHER | Code of the wallet provider or merchant that requested the token. OTHER is used for tokens not linked to a wallet provider, such as merchant tokens or cloud tokens. |
status | string | ACTIVE, DEACTIVATED, INACTIVE, SUSPENDED | Current status of the token. |
token_suffix | string | Last 4 digits | Last 4 digits of the tokenised PAN, used for display and identification purposes. |
d_pan | string | DPAN value | Device Primary Account Number assigned by the payment network when a card is added to a digital wallet. |
deleted_from_consumer_app | boolean | true, false | Indicates whether the token was deleted from the consumer app. |
authorization_decision | string | GREEN, YELLOW, ORANGE, RED | Wallet authorisation decision. |
card_id | UUID | UUID | Identifier of the card associated with the token. |
device_info_device_name | string | String | User-defined name of the device, provided by the wallet or operating system. |
device_info_device_type | string | Typical values include PHONE, WATCH, TABLET, WEARABLE | Type of device on which the token is provisioned. |
device_info_operating_system | string | Typical values include IOS, ANDROID, WATCHOS | Operating system running on the device. |
token_created_at | datetime | ISO 8601 datetime | Timestamp when the token was created by the Token Service Provider. |
token_updated_at | datetime | ISO 8601 datetime | Timestamp of the most recent update to the token status. |
update_count | integer | Integer | Version number of the token entity. |
File schemas
Token file schema
Columns, data types and allowed values in the Data Files Token file.
The Token file contains events related to tokenised cards. Each row represents one token event. For file naming, format and conventions, see Working with the files.