> ## Documentation Index
> Fetch the complete documentation index at: https://docs-pos.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Gift cards

> Issue, redeem and void gift cards and credit notes as stored value.

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`).

<Note>
  Redemption is not concurrency-safe under simultaneous draws on the same card — this
  is a documented backend hardening item, deferred for the pilot.
</Note>

## Related

* [Returns & exchanges](/en/caisse/retours-echanges) — issue a card to hand back
  store credit.
* [Take payment](/en/caisse/encaissement) — redeem a card as a tender.