Set PIN

This operation sets the card PIN. Provided PIN must be in ISO format 1 and encrypted with the tzpk received from the “Get tzpk” API call.

Example flow

Step 1, executed on the CARD-HOLDER DEVICE, encrypting the PIN block with the TZPK

// PIN 1234 in ISO format 1 (xxYYYYxxxxxxxxxx) where YYYY is the PIN var pinBlock = “141234AAAAAAAAAA”; // encrypt pinBlock with previously received tzpk var des = Cipher.getInstance(“DESede/ECB/NoPadding”); des.init(Cipher.ENCRYPT_MODE, new SecretKeySpec(tzpk, “DESede”)); var encryptedPinBlock = des.doFinal(Hex.decode(pinBlock.getBytes()));

Step 2, executed on the CLIENT BACK-END, sending the encrypted PIN block recieved from the device, to the API

// var encryptedPinBlock = // Received from the device // make request pinApiClient.post() .uri(“/pin/v3/set?auditUser=”, “test”) .bodyValue(Map.of( “controlId”, controlId, “pinBlock”, Base64.getEncoder().encodeToString(encryptedPinBlock) )) .retrieve() .bodyToMono(Object.class) .block();