v1

latestOpenAPI 3.0.32026-07-26208618579.9 KB
PIN Control handling

Request PIN Control access token by cardId.

This operation is used to create the PIN control access token. If there are multiple active plastics on one card object, the one with the highest sequence number will be used.

The successful response from this call returns an id and a pinURL if request was for viewing pin. The cardholder device should be instructed to do a POST call to the pinURL with the content of the id in a form field named controlId.

post/v1/card/{cardId}

Path parameters

cardIdstring biginteger required

The id of the card for which the PIN should be accessed

Query parameters

auditUserstring required

The audit user to log the request

Request body

scope'VIEW_PIN' | 'SET_PIN' required

Describes the scope of the operation that is authorized by the user.

Response

Successful creation of the access token

idstring required

The ID of this PIN Control access token.

pinURLstring

The URL that the cardholder's mobile device webview should browse to for accessing the PIN.

pinFrameURLstring

The URL of the iframe for desktop browser based flows for accessing PIN.