Sign in

v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-012382333.4 MB

Update a Card's PIN

post/cards/{card_id}/update_pin

Path parameters

card_idstring required

The identifier of the Card to update the PIN for.

Request body

pinstring required

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

Example request

{
  "pin": "1234"
}

Response

Card Details

card_idstring required

The identifier for the Card for which sensitive details have been returned.

expiration_monthinteger required

The month the card expires in M format (e.g., August is 8).

expiration_yearinteger required

The year the card expires in YYYY format (e.g., 2025).

pinstring required

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

primary_account_numberstring required

The card number.

type'card_details' required

A constant representing the object's type. For this resource it will always be card_details.

verification_codestring required

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).

Example response

{
  "card_id": "card_oubs0hwk5rn6knuecxg2",
  "expiration_month": 7,
  "expiration_year": 2025,
  "pin": "1234",
  "primary_account_number": "4242424242424242",
  "type": "card_details",
  "verification_code": "123"
}