increase-test
POST/cards/{card_id}/update_pin

Update a card PIN

Updates the PIN for a card. Provide the new PIN in pin as exactly four numeric digits, and use card_id to identify the card. The response includes the card's sensitive details with the updated PIN.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
card_idstringrequired
The identifier of the card whose PIN you want to update.

The new PIN for the card.

pinstringrequired
The 4-digit PIN for the card, for use with ATMs.

3 status codes
200Returns the card's sensitive details, including its identifier, primary account number, expiration month and year, verification code, and updated PIN.
card_idstringrequired
The identifier for the Card for which sensitive details have been returned.
expiration_monthintegerrequired
The month the card expires in M format (e.g., August is 8).
expiration_yearintegerrequired
The year the card expires in YYYY format (e.g., 2025).
pinstringrequired
The 4-digit PIN for the card, for use with ATMs.
primary_account_numberstringrequired
The card number.
typestringrequired
A constant representing the object's type. For this resource it will always be `card_details`.
Allowed:card_details
verification_codestringrequired
The three-digit verification code for the card. It's also known as the Card Verification Code (CVC), the Card Verification Value (CVV), or the Card Identification (CID).
4XXReturned when the request fails with a client error.
5XXReturned when the request fails with a server error.

Error handling

The card_id path parameter must identify the card to update. pin is required and must contain exactly four numeric digits.