v1

latestOpenAPI 3.0.02026-07-2352269214.0 KB

Get Card Credentials

API used by D1 to call the CMS for retrieving the card credentials (PAN, expiry date, cardholder name and CVV) using a card identifier. It can be used, for example, for displaying the card details to an end user who wants to perform an e-commerce transaction or for registering a 'legacy card' in the D1 system.

get/cms/api/v1/issuers/{issuerId}/cards/{cardId}/credentials

Headers

Authorizationstring

Oauth Access Token (optional)

Response

encryptedDatastring required

The encryptedData is the encrypted json (cf http://www.json.org/ ) representation of the card credentials. This value is encrypted using the JWE encryption (please refer to the Sensitive Information Encryption for more details) Content Once deciphered, the plaintext contains:

JSON field parameter name	description	MOC	Format
pan	The funding pan value.	M	string - from 10 to 19 digits
exp	The expiry date of the card.	M	string - 4 digits, following the format MMYY
name	The card holder name.	O	string - up to 128 characters
cvv	The CVV2 value of the funding card	M	string - 3 or 4 digits
auxiliaryPan	The auxiliary funding pan value.It shall be provided when cobadge is supported and if the card has an auxiliary pan.	C	string - up to 19 digits
auxiliaryExp	The auxiliary expiry date of the card.It shall be provided when cobadge is supported and if the card has an auxiliary pan.	C	string - 4 digits, following the format MMYY
customSuffix	last 4 digits of the display pan which is different than the actual funding pan	O	string - 4 digits