Card lifecycle - PointZero Developers Hub

Every card has a status that decides whether it can be used. You change it with dedicated endpoints rather than by updating the card.

Status	Meaning
`pending`	The card is created but cannot be used yet. Physical cards stay `pending` until delivery.
`active`	The card can be used.
`frozen`	New authorizations are declined. Refunds and already authorized payments still go through.
`terminated`	The card is closed permanently.

Freeze and unfreeze

Use freeze when a cardholder misplaces a card or you need to pause spending.

curl -X POST https://api.pointzero.io/v1/cards/card_01JZ8N2K4M/freeze \
  -H "Authorization: Bearer $POINTZERO_API_KEY"

Call unfreeze to make it active again.

Terminate

Terminate closes the card. This cannot be undone. Wallet tokens linked to the card are removed.

Replace

Replace a card issues a new card for the same customer and copies its spending and authorization controls. The new card has replaced_card_id set to the old card.

`reason`	Old card
`lost`, `stolen`	Always terminated
`damaged`, `expired`, `other`	Terminated unless `terminate_existing` is `false`