Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

API de gestión de PIN

Descargar D1-Public-OUT-v1-PIN-Management.yaml

Get Card PIN

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

This request is used by D1 to retrieve the PIN value of a physical card.

Autorizaciones
AuthorizationstringRequerido

A JWT generated by the Get Authorization Token API.
The server checks the validity of the provided token to control access to this protected resource. Please refer to Get OAuth 2.0 access token for more details on the flow and on how to get this JWT.

Parámetros de ruta
issuerIdstring · mín: 10 · máx: 10Requerido

The id of the issuer

cardIdstring · mín: 1 · máx: 48Requerido

Unique identifier of the card.

Pattern: ^[A-Za-z0-9_-]{1,48}$
Parámetros de encabezado
x-correlation-idstringOpcional

Random identifier which can be used to correlate the different API calls done as part of a single use-case. This identifier will be the one primarily used for troubleshooting.

There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.

Respuestas
200

The response body to get PIN to be displayed. This value is encrypted using the JWE encryption

application/json
get
/cms/api/v1/issuers/{issuerId}/cards/{cardId}/pin

Set Card PIN

put
/cms/api/v1/issuers/{issuerId}/cards/{cardId}/pin

This request is used by D1 to push securelly in core banking system the PIN value for a physical card.

Autorizaciones
AuthorizationstringRequerido

A JWT generated by the Get Authorization Token API.
The server checks the validity of the provided token to control access to this protected resource. Please refer to Get OAuth 2.0 access token for more details on the flow and on how to get this JWT.

Parámetros de ruta
issuerIdstring · mín: 10 · máx: 10Requerido

The id of the issuer

cardIdstring · mín: 1 · máx: 48Requerido

Unique identifier of the card.

Pattern: ^[A-Za-z0-9_-]{1,48}$
Parámetros de encabezado
x-correlation-idstringOpcional

Random identifier which can be used to correlate the different API calls done as part of a single use-case. This identifier will be the one primarily used for troubleshooting.

There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.

Cuerpo
typestring · enumRequerido

The type of the PIN Block.

Valores posibles:
encryptedPinBlockstring · máx: 8192Requerido

The value is the encrypted json (cf http://www.json.org/ ) representation of the PIN Block.
This value is encrypted using the JWE encryption (please refer to the Sensitive Information Encryption for more details)

Schemas of the PIN Block once decrypted
PIN Block ISO0
PIN Block 3DES Seccos
Respuestas
put
/cms/api/v1/issuers/{issuerId}/cards/{cardId}/pin

Sin contenido

Get PIN Change Counter

get
/cms/api/v1/issuers/{issuerId}/cards/{cardId}/pin/changeCounter

API used by D1 retreive from Issuer Backend the PIN Change Counter for a given card. The PIN Change counter is used to compute PRW and MAC

Autorizaciones
AuthorizationstringRequerido

A JWT generated by the Get Authorization Token API.
The server checks the validity of the provided token to control access to this protected resource. Please refer to Get OAuth 2.0 access token for more details on the flow and on how to get this JWT.

Parámetros de ruta
issuerIdstring · mín: 10 · máx: 10Requerido

The id of the issuer

cardIdstring · mín: 1 · máx: 48Requerido

Unique identifier of the card.

Pattern: ^[A-Za-z0-9_-]{1,48}$
Parámetros de encabezado
x-correlation-idstringOpcional

Random identifier which can be used to correlate the different API calls done as part of a single use-case. This identifier will be the one primarily used for troubleshooting.

There is no strong guarantee of the uniqueness of this identifier, so please refrain from using it for other purpose than logging and troubleshooting.

Respuestas
200

Successful

application/json
pccstringRequerido

The PIN Change Counter value.

Example: 0003Pattern: ^[0-9]{4}$
intdatagstring · mín: 20 · máx: 20Requerido

Identifier used to correlate the call to get Pin Change Counter and the call to set Pin.

Example: 21430919092023091909
get
/cms/api/v1/issuers/{issuerId}/cards/{cardId}/pin/changeCounter

Última actualización

¿Te fue útil?