Skip to main content
The Gift cards counter manages stored value: issue a card or credit note, redeem a balance as a tender, and void a card.

​
Issue

Mint stored value — a gift card, a store_credit, or a credit_note (POST /v1/giftcards). This is the path to hand a customer a redeemable balance, including as the outcome of a store-credit return.

​
Redeem

Draw a balance by its bearer code and use it as a tender on a sale (POST /v1/giftcards/redemptions). A card’s current balance is looked up by code (GET /v1/giftcards/by-code/:code).

​
Void

Cancel a card (POST /v1/giftcards/:id/void).
Redemption is not concurrency-safe under simultaneous draws on the same card — this is a documented backend hardening item, deferred for the pilot.