Renew card

PATCH/issuing/cards/{card_id}/renew

Renew a card to extend its expiration date while keeping the same PAN. The card's sequence_number is incremented. Only active or paused cards can be renewed. A card can't be renewed while another card with the same PAN, such as an earlier renewal, isn't deactivated, or if any card with the same PAN was deactivated as lost, stolen, or fraud.

Path Parameters

card_id

stringRequired

Unique identifier for the card.

Body Parameters

encrypted_pin

stringOptional

Debit card programs only. Omit to keep the original card's PIN on the renewed card. A carried-over PIN starts unblocked, with no wrong attempts counted, even if the original card's PIN was blocked. Pass a base64-encoded encrypted PIN to set a new PIN, or SKIP to create the renewed card without a PIN (pin_status is unset) and set one later with PATCH /issuing/cards/\{card_id\}/pin. To have Column choose a new PIN instead, omit this and pass generate_pin. Treat an encrypted PIN like the PIN itself: never log, store, or reuse it.

expiration_month

integerOptional

Optional new expiration month (1-12)

expiration_year

integerOptional

Optional new expiration year (4-digit year, e.g. 2025)

generate_pin

booleanOptional

Debit card programs with PIN reveal enabled only. Pass true to have Column set a new random 4-digit PIN on the renewed card instead of keeping the original card's PIN or providing encrypted_pin, which must then be omitted. The PIN is never returned in the response; the cardholder learns it through PIN reveal.

status

stringOptional

Optional status for the renewed card