Release history

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