This section provides instructions to update the status of your cardholders' cards in a variety of situations, including when a card is lost, damaged or stolen.

Card statuses

While some card statuses are read-only, others may be updated by sending a PUT request. Any PUT requests that attempt to change the status to a read-only value will fail.

Available from PUT and GET

• active
• inactive
• lost
• stolen
• damaged
• frozen

Only available from GET (read-only)

• waiting_for_funds
• embossing
• shipped
• expired

Final statuses

Some statuses put the card into a final state and can no longer be updated. These include the following:

• lost
• stolen
• damaged
• inactive

Use cases for updating a card's status

Lost card

In the event of a lost card, update the card status to lost. The card is deactivated immediately and a replacement card is shipped. The new card has a new PAN. If the lost card is found, it may not be reactivated, as lost is a final status.

Stolen card

In the event of a stolen card, update the card status to stolen. The card is deactivated immediately and a new card is shipped. The new card has a new PAN. If the stolen card is recovered, it may not be reactivated, as stolen is a final status.

Damaged card

In the event of a damaged card, update the card status to damaged. A replacement card is shipped, but the damaged card is not deactivated immediately. The damaged card is deactivated only after the new card is activated. The new card has the same PAN as the damaged card. This allows subscriptions and other recurring expenses to continue uninterrupted by the card replacement. Once a card has been declared damaged, the replacement process can't be stopped, as damaged is a final status.

Freeze a card

If your cardholder wishes to freeze their card, update the card status to frozen. This action will render the card useless. All transactions will fail as long as the card is frozen. The card may be unfrozen by updating the card status to active.

Deactivate a card without a replacement

If your cardholder wishes to deactivate their card without receiving a replacement, update the card status to inactive. This action will render the card useless. The card may not be reactivated, as inactive is a final status.