Cancel Card
Cancels a single card. The card leaves circulation immediately: it stops counting as
balance, stops being redeemable and reads as canceled everywhere.
A card carries no status column - canceled is derived from the cancellation timestamp,
so this endpoint is what "set the card status to canceled" means.
Canceling a card is a change of state, not a movement of money: the balance is neither debited nor returned, and no line is written to the card flow ledger. The card simply drops out of every balance query. Pick the operation by intent:
- the whole card should stop existing for the customer - this endpoint;
- value should leave a card that stays alive - Adjust Card Balance (
manual_debit, recorded in the ledger); - a purchase was reverted and its cashback must go with it - cancel the transaction, not the card.
Reversible through Reactivate Card.
A card holding an open redemption reservation is refused with 409: the reserved value
was already debited and is waiting to be settled or returned, so canceling the card would
strand it. Settle or cancel that redemption first.
Try-it values populated from environment ACME (Demo)
Authentication
Token
Send your user token in the x-guper-authorization header. Endpoints that
support a Public mode (e.g. acúmulo and resgate previews) accept the same
request without the header — Private mode adds customer data and a
confirmation token to the response.