ADadyen
Manage card PIN

Change a card PIN

Changed on

Changes the personal identification number (PIN) of a specified card.

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

  • Bank Issuing PIN Change Webservice role
post/pins/change

Request

  • Base URL
    https://balanceplatform-api-test.adyen.com/bcl/v2
  • URL
    https://balanceplatform-api-test.adyen.com/bcl/v2/pins/change
  • 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.

encryptedPinBlockstring required

The encrypted PIN block.

paymentInstrumentIdstring required

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

tokenstring required

The 16-digit token that you used to generate the encryptedPinBlock.

Response

OK - the request has succeeded.

status'completed' | 'pending' | 'unavailable' required

The status of the request for PIN change.

Possible values: completed, pending, unavailable.

Changes