GET
/
v2
/
{plasticId}
Get encrypted PIN
curl --request GET \
  --url https://integration-api-cat1./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/pin/v2/{plasticId}
{
  "pinBlock": "<string>"
}

​
Example

var pinResponse = pinApiClient.get()
        .uri("/pin/v2/{plasticId}?zpkIndex={zpk}&auditUser={user}", 123456, 0, "test")
        .retrieve()
        .bodyToMono(PinResponse.class)
        .block();
// preshared zpk
var zpk = Hex.decode("00112233445566778899AABBCCDDEEFF0011223344556677");
// decrypt pinBlock with zpk
var des = Cipher.getInstance("DESede/ECB/NoPadding");
des.init(Cipher.DECRYPT_MODE, new SecretKeySpec(zpk, "DESede"));
var decryptedPinBlock = Hex.toHexString(des.doFinal(Hex.decode(pinResponse.getPinBlock())));

Path Parameters

​
plasticId
string
required

The plastic id for given card

Query Parameters

​
auditUser
string
required

The audit user to log the request

​
zpkIndex
string
required

The PIN encryption key (ZPK) index. This index is used to point out which key to use in case there are multiple keys available.

Example:

"0"

Response

200
application/json

Successful lookup of the card

The response is of type object.