> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/xpay-enablement/api-reference/tsp-api-v2/release-history.md).

# Release history

| Release | Date                                      | Modifications                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1.0     | First release of the Token Requestor API. |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.0.1   | 23/01/2018                                | <ul><li>Update API method name.</li><li>Add deviceInfo in create token.</li><li>Add additionalCardInfos in cipheredCardInfo.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.0.2   | 19/03/2018                                | <ul><li>Increase tokenStorageId max length to 64.</li><li>Specify additionalCardInfos max length.</li><li>Specify tokenPersoInfo#value max length.</li><li>Specify lengths of requestReplenisment and replenishmentDone parameters.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.0.3   | 07/05/2018                                | <ul><li>Add new request to let TSP renew the token.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.0.4   | 31/05/2018                                | <ul><li>Health check methods return HTTP 204 instead of HTTP 200.</li><li>Increase cardRefId length to 64.</li><li>Add optional parameter “initialState” to createToken API.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.0.5   | 19/07/2018                                | <ul><li>Add new optional parameter in updateToken for providing new cardRefId in case it has been changed by Issuer.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 1.0.6   | 14/08/2018                                | <ul><li>Add possible error codes per API.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.0.7   | 25/09/2018                                | <ul><li>Add new optional parameter reason in updateTokenState API.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.0.8   | 22/11/2018                                | <ul><li>Add submitNewTokenDataStatus operation to notify the TSP after token re-personalization.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.0.9   | 17/12/2018                                | <ul><li>add information about retryable errors.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.0.10  | 17/12/2018                                | <ul><li>Add tokenInfo in submitTokenData and submitNewTokenData requests.</li><li>Increase the maximum length of the data element values in submitTokenData and submitNewTokenData requests.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.1.0   | 07/05/2020                                | <ul><li>Add repersoToken for token reperso flow when it is triggered by TSH.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.1.1   | 26/06/2020                                | <ul><li>Fix wrong description of mCommerce transactionIdentifier for Apple Pay.</li><li>Fix error on flow described in “Card Update”. The request ‘updateToken’ is sent by TSH (not TSP)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 2.0.0   | 04/06/2020                                | <p>Non backward compatible version<br><br></p><ul><li>Add new HTTP header x-correlation-id on all requests (except health check) used for correlating calls across systems.</li><li>x-request-id has been removed (except health check).</li><li>Add new "Guidelines" page which includes some details about linkage between API calls.</li><li>walletProviderId has been removed since it's duplicated with tokenRequestorId</li><li>cardRefId parameter in createToken has been removed. New parameters issuerCardRefId and walletCardRefId are used instead.</li><li>newCardRefId parameter in updateToken has been removed. New parameter newIssuerCardRefId is used instead.</li><li>Update "Data Model" page to reflect issuerCardRefId and walletCardRefId.</li><li>Fix error on flow described in "Card Update". The request 'updateToken' is sent by TSH (not TSP)</li></ul> |
| 2.0.1   | 26/06/2020                                | <ul><li>Fix wrong description of mCommerce transactionIdentifier for Apple Pay.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.1.0   | 21/09/2020                                | <ul><li><p>Update APIs managing PKCS7 encryption. Key identifier that represents the RSA public key that has been used for encryption is added on:</p><ul><li>createToken (for cipheredCardInfo)</li><li>updateToken (for newCipheredCardInfo)</li></ul></li><li>Update incorrect description for token transaction notification API, transactionIdentifier is not mandatory (for refund)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2.2.0   | 16/12/2020                                | <ul><li>New API introduced for Apple Iron applet update notification</li><li>Added device language, applet version and ecommerce certificate in createToken</li><li>Add support of OAEP padding for encrypted payloads sent by TSH to TSP.</li><li>Added development considerations section in <a href="https://developer.dbp.thalescloud.io/docs/tsh-token-requestor-tsp-api/docs/api-reference/guidelines.md">Guidelines</a>.</li><li>Added type in 'deviceInfo' object sent in createToken request</li></ul>                                                                                                                                                                                                                                                                                                                                                                       |
| 2.2.1   | 24/11/2023                                | <ul><li>Added new HTTP header on token transaction notification API in order to indicate which wallet type has performed the transaction</li><li>Added Google Pay and Samsung Pay data preparation sections</li><li>Updated description of transactionIdentifier used in transaction notification</li><li>Increase x-request-id and x-correlation-id headers length to 64</li><li>Added replenishment APIs for Google Pay</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2.2.2   | 08/04/2024                                | <ul><li>Added new value 'REALITY' in device type enum</li><li>Fix error in replenishToken response: paymentKeys is a string, not an array of strings</li><li>Added 'HCE Issuer Wallets personalization' section</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.2.3   | 20/11/2024                                | <ul><li>Fix incorrect HTTP header description in Google replenishment APIs ('x-correlation-id' instead of 'x-request-id')</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2.2.4   | 15/01/2025                                | <ul><li>Added Google Pay Discover perso data format</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 2.2.5   | 05/06/2025                                | <ul><li>Parameter 'linkedTransactionId' added in token transaction notification API request. Applicable to Google Pay solution. Used in the case of refund in order to link the notification to a previous purchase transaction.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 2.2.6   | 13/08/2025                                | <ul><li>Added Google Pay CPACE Girocard perso data format</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2.2.7   | 22/05/2026                                | <ul><li>Add listTokens function for CCI purpose</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/xpay-enablement/api-reference/tsp-api-v2/release-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.