This API is used by financial institutions to get information on tokens linked to accounts, perform life cycle management operations on tokens and update token restrictions.
| Endpoint | Usage |
|---|---|
| /gettokens | Used to get all the tokens linked to an account. |
| /tokenlifecyclemanagement | Used to perform state change operation on a Token. |
| /replacerealaccount | Used to replace the underlying account of a token. |
The diagrams below provide an overview of the FI API message flows for Get Tokens, Lifecycle Management and Replace underlying real routing and account.
Note that when the Financial Institution state is disabled or closed, all API requests are rejected with statusCode 13011: Financial Institution is not in valid state.
Financial Institutions have comprehensive control over the lifecycle of tokens associated with their accounts. This includes the ability to activate, suspend, deactivate, and delete tokens as needed for risk management and operational requirements.
Financial institutions can replace the underlying real account information for existing tokens using real routing and account numbers. This operation allows FIs to update the account backing a token without affecting the token itself.
Financial institutions can replace the underlying account information for tokens using token-based routing and account information. This allows for more flexible account management within the tokenized environment.
Financial institutions can use the Get Tokens API to retrieve all tokens that are linked to their real account numbers. This operation provides visibility into all tokenized versions of their accounts.
This section includes detailed information about the API Response fields statusCode and statusMessage.
Start a Project
API Overview
API Reference
{
"messageId": "6fdf4f09-7fbb-48ae-be1e-ac412a2949a7",
"statusCode": "00000",
"statusMessage": "Success.",
"encTokens": "..."
}
| HTTP Code | statusCode | statusMessage | Applicable Message |
|---|---|---|---|
| 200 | 00000 | Success. | - |
| 400 | 13001 | Invalid request. The data field is not in the correct data type format or length or pre-defined values or the required data field is missing. | - |
| 400 | 13003 | Token not found. | - |
| 400 | 13004 | Real account not found. | - |
| 400 | 13005 | Token is not in valid state. | - |
| 400 | 13007 | New account belongs to a range different than the existing account. | - |
| 400 | 13008 | No account range found for new account. | - |
| 400 | 13009 | Feature not supported. | - |
| 400 | 13010 | Token Requestor is not in valid state. | - |
| 400 | 13011 | Financial Institution is not in valid state. | - |
| 401 | 13022 | Unauthorized request | - |
| 500 | 13100 | Unknown internal server error. Try again later. | - |
| 500 | 13199 | Unknown error. | - |