Replace card

PATCH/issuing/cards/{card_id}/replace

Replace a card with a new card and automatically deactivate the original. Replacements for lost, stolen, fraud, or voluntary reasons get a new PAN; replacements for damaged or expired cards keep the same PAN and increment sequence_number.

Path Parameters

card_id

stringRequired

Unique identifier for the card.

Body Parameters

deactivation_reason

stringRequired

Reason for deactivating the original card during replacement. lost, stolen, fraud, and voluntary requests create a replacement with a new PAN. damaged requests reuse the PAN. expired requests are processed as renewal-style replacements with the same PAN and a new expiration.

encrypted_pin

stringOptional

Optional base64-encoded encrypted PIN

expiration_month

integerOptional

Optional expiration month (1-12)

expiration_year

integerOptional

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

status

stringOptional

Optional status for the replacement card