Skip to main content
Weavr API
Managed cards

Replace a lost or stolen physical card

POST/managed_cards/{id}/physical/replace_lost_stolen

Issues a replacement for the physical card identified by the id path parameter, which has already been reported as lost or stolen.

The replacement is printed with the same details and delivered to the same address as the original. Any funds remaining on the original card are transferred to it automatically, except for amounts still held against a previous authorization.

Prerequisites

The card must already be marked as lost or stolen, otherwise the request fails with INSTRUMENT_NOT_MARKED_LOST_OR_STOLEN. Report it first with Report a physical card as lost or as stolen. For a debit card, the parent managed account must still be active (PARENT_MANAGED_ACCOUNT_NOT_ACTIVE).

This operation requires a stepped-up access token. Step up before calling it by issuing a challenge through Step-up.

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

A card can be replaced once: a second call fails with INSTRUMENT_ALREADY_REPLACED. 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.

Next steps

The replacement arrives inactive. The cardholder activates it with Activate a physical card, using the activationCode supplied here.

Request

Available on
SandboxProduction

Path parameters

Header parameters

Request body

*
application/json
{}
objectobject · 1 field

Responses

200OK

Success

Headers
Body
application/json
{}
ManagedCardManagedCard · object · 33 fields

Accepted shapes

Selected by mode

Prepaid Mode CardPREPAID_MODEobject
mode
enum
balances
object
Debit Mode CardDEBIT_MODEobject
mode
enum
currency
string
parentManagedAccountId*
string
userCurrency
enum
availableToSpend
array<AvailableToSpend · object>
Response example
{  "mode": "PREPAID_MODE",  "balances": {    "availableBalance": 120000,    "actualBalance": 125000  }}