RocketKOR

COMING SOON

Reset PIN

Automatically generate a new PIN for a card. You cannot reset the PIN if the Financial Account for the card is suspended.

To reset the pin, you will need:

  • ID of the integrated Financial Account for the card

Note  To create a new PIN, use the Create PIN API.

Endpoint

POST /v1/integrated-cards/{financialAccountId}/reset-pin

Authorization Header

Authorization: Bearer <access_token>

Idempotency-Key Header

Idempotency-Key: <key>

where <key> is a v4 UUID or any other unique string with a minimum length of 6 characters and a maximum length of 255 characters.

The idempotency key identifies the request. If a network error occurs, you can safely retry the request using the same idempotency key and the request will only be executed once. This ensures that calling the API multiple times will not result in duplicate requests. For more information, see Idempotent Calls.

Path Parameters

financialAccountId  REQUIRED

string (UUID)

ID of the integrated Financial Account. The issued card is linked to this Financial Account.

Request Body

None

Returns

Returns the new PIN as an encrypted PIN block.

newPin

string, min length: 4, max length: 12

New PIN. Provided as an encrypted PIN block.

SAMPLE RESPONSE

				
					{
  "newPin": "32880532"
}