Update a Card's PIN

Changed on
post/cards/{card_id}/update_pin

Request

  • Base URL
    https://api.increase.com
  • URL
    https://api.increase.com/cards/{card_id}/update_pin
  • Auth
    HTTP bearer

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"
}

Changes

  • 64a92a8cc343Revision changes
    • info

      added subschema #8 subschema #10 to the /// response property anyOf list for the response status

    • info

      added subschema #8 subschema #10 to the /// response property anyOf list for the response status

    • info

      removed subschema #8 subschema #10 from the /// response property anyOf list for the response status

    • info

      removed subschema #8 subschema #10 from the /// response property anyOf list for the response status

  • 8976b540ed44Revision changes
    • breaking

      added the pattern ^[0-9]*$ to the request property