Request PIN Control access token by plasticId

POST

card

{cardId}

plastic

{plasticId}

Request PIN Control access token by plasticId

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/pincontrol/v1/card/{cardId}/plastic/{plasticId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scope": "VIEW_PIN"
}
'

{
  "id": "<string>",
  "pinURL": "<string>",
  "pinFrameURL": "<string>"
}

Deprecated: This API endpoint is no longer supported.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

cardId

string<biginteger>

required

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

plasticId

string<biginteger>

required

The id of the card's plastic for which the PIN should be accessed

Query Parameters

auditUser

string

required

The audit user to log the request

Body

application/json

The related PIN control request data

scope

enum<string>

required

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

Available options:

VIEW_PIN,

SET_PIN

Response

Successful creation of the access token

string

required

The ID of this PIN Control access token.

pinURL

string

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

pinFrameURL

string

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

⌘I

Request PIN Control access token by plasticId

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/pincontrol/v1/card/{cardId}/plastic/{plasticId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scope": "VIEW_PIN"
}
'

{
  "id": "<string>",
  "pinURL": "<string>",
  "pinFrameURL": "<string>"
}