Skip to main content
Weavr API
Managed cards

Replace a damaged physical card

POST/managed_cards/{id}/physical/replace_damaged

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.

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.

Request

Available on
SandboxProduction

Path parameters

Header parameters

Request body

*
application/json
{}
objectobject · 1 field

Responses

204No Content

Success - No Content.

Headers