ADadyen
Manage card PIN

Reveal a card PIN

Changed on

Returns an encrypted PIN block that contains the PIN of a specified card. You can use the decrypted data to reveal the PIN in your user interface.

To make this request, your API credential must have the following role:

  • Bank Issuing PIN Reveal Webservice role
post/pins/reveal

Request

  • Base URL
    https://balanceplatform-api-test.adyen.com/bcl/v2
  • URL
    https://balanceplatform-api-test.adyen.com/bcl/v2/pins/reveal
  • Auth
    • API key in query parameter clientKey
    • or HTTP basic
    • or API key in header X-API-Key

Request body

encryptedKeystring required

The symmetric session key that you encrypted with the public key that you received from Adyen.

paymentInstrumentIdstring required

The unique identifier of the payment instrument, which is the card for which you are managing the PIN.

Response

OK - the request has succeeded.

encryptedPinBlockstring required

The encrypted PIN block.

tokenstring required

The 16-digit token that you need to extract the encryptedPinBlock.

Changes