Replace a lost or stolen physical card
/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
Path parameters
Header parameters
Request body
*Responses
Success
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>
{ "mode": "PREPAID_MODE", "balances": { "availableBalance": 120000, "actualBalance": 125000 }}