Skip to main content

Replace a card

POST 
/v1/card/cards/:id/replace

For a lost, stolen or damaged card. The old card is CANCELED and a new card is returned, with a new id, a new PAN and a new expiry; the spending limit is inherited. There is no lineage field — keep the old id against the new one from this response. Virtual cards only — a physical card cannot be replaced (422 REPLACE_NOT_APPLICABLE); cancel it and issue a new one. Replacing an already-canceled card is 409 CARD_TERMINAL. Concurrent replaces of the same card are serialized: exactly one succeeds and the other gets 409 OPERATION_IN_FLIGHT.

Request​

Responses​

The NEW card. The card in the path is now CANCELED.