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)
1.2.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)
1.2.1	08/01/2021	Add support of OAEP padding for encrypted payloads sent by TSH to TSP. Added Guidelines section
1.3.0	12/05/2021	Add listTokens function for CCI purpose Add transmac function for PSD2 cryptogram swap use case
1.3.1	21/06/2021	Updated cardRefId description
1.3.2	30/03/2023	Google Pay updates: Added Google Pay data preparation section Updated description of transactionIdentifier used in transaction notification Added replenishment APIs for Google Pay Added creationDate on token object returned in listTokens API
1.3.3	25/09/2023	Added type in 'deviceInfo' object which is sent in createToken request and returned in listTokens response Added cardRefId and cipheredTokenInfo which can be provided as inputs to listTokens API
1.3.4	24/11/2023	Added new HTTP header on token transaction notification API in order to indicate which wallet type has performed the transaction Increase x-request-id header length to 64
1.3.5	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
1.3.6	15/01/2015	Added Google Pay Discover perso data format
1.3.7	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.
1.3.8	17/03/2026	eCom enablement updates: Added createMerchant API createTransaction API Updated createToken API xPay enablement updates: Added repersoedTokenId in submitNewTokenData request and newTokenProductId in repersoToken request for DPAN BIN update support