For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Last updated

Was this helpful?