> 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-v1/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>                                                                                                                                                                                                  |
| 1.2.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> |
| 1.2.1   | 08/01/2021                                | <ul><li>Add support of OAEP padding for encrypted payloads sent by TSH to TSP.</li><li>Added <a href="https://developer.dbp.thalescloud.io/docs/tsh-token-requestor-tsp-api/branches/version_1.3/docs/api-reference/guidelines.md">Guidelines</a> section</li></ul>                                                                                                                                 |
| 1.3.0   | 12/05/2021                                | <ul><li>Add listTokens function for CCI purpose</li><li>Add transmac function for PSD2 cryptogram swap use case</li></ul>                                                                                                                                                                                                                                                                           |
| 1.3.1   | 21/06/2021                                | <ul><li>Updated cardRefId description</li></ul>                                                                                                                                                                                                                                                                                                                                                     |
| 1.3.2   | 30/03/2023                                | <p>Google Pay updates:</p><ul><li>Added Google Pay data preparation section</li><li>Updated description of transactionIdentifier used in transaction notification</li><li>Added replenishment APIs for Google Pay</li><li>Added creationDate on token object returned in listTokens API</li></ul>                                                                                                   |
| 1.3.3   | 25/09/2023                                | <ul><li>Added type in 'deviceInfo' object which is sent in createToken request and returned in listTokens response</li><li>Added cardRefId and cipheredTokenInfo which can be provided as inputs to listTokens API</li></ul>                                                                                                                                                                        |
| 1.3.4   | 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>Increase x-request-id header length to 64</li></ul>                                                                                                                                                                                                |
| 1.3.5   | 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>                                                                                                                                                                           |
| 1.3.6   | 15/01/2015                                | <ul><li>Added Google Pay Discover perso data format</li></ul>                                                                                                                                                                                                                                                                                                                                       |
| 1.3.7   | 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>                                                                                                                                                          |
| 1.3.8   | 17/03/2026                                | <p>eCom enablement updates:</p><ul><li>Added createMerchant API</li><li>createTransaction API</li><li>Updated createToken API</li></ul><p></p><p>xPay enablement updates:</p><ul><li>Added repersoedTokenId in submitNewTokenData request and newTokenProductId in repersoToken request for DPAN BIN update support</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-v1/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.