Replace a damaged physical card

Use this when a card still belongs to the cardholder but no longer works: a broken chip, a worn magnetic stripe, a cracked card.

It reports the physical card identified by the id path parameter as damaged and orders a replacement. The replacement is printed with the same details and delivered to the same address as the original.

:::note If the card is missing rather than faulty, report it lost or stolen first, then use Replace a lost or stolen physical card. This operation rejects a card already marked as lost with INSTRUMENT_MARKED_AS_LOST. :::

Fields

activationCode is required, and is the code the cardholder will use to activate the replacement once it arrives. It is a new code for the new card, not the one used for the original.

Conflicts

The card must be physical and already activated. A replacement that has already been ordered fails with INSTRUMENT_ALREADY_PENDING_REPLACEMENT, and a destroyed card fails with INSTRUMENT_ALREADY_DESTROYED. MAX_PRINT_CHARACTERS_EXCEEDED means the name held on the card is too long for the chosen card design to print. Shorten nameOnCard with Update a card before retrying.