> ## 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 & store credit

> Issue and manage gift cards and customer store credit from the Solya POS Centrale, including reloads, voids and breakage.

This area manages the network's stored-value instruments: **gift cards** that
customers buy and spend, and **store credit** held on a customer's account. Both
are payment sources the [Caisse](/en/caisse/overview) can draw on at checkout.

## Gift cards

Gift cards are stored-value instruments identified by a code. From the Centrale
you can:

<Steps>
  <Step title="Issue">
    Mint a new gift card with an initial balance. The gift-cards screen lists
    cards with their balance and status (including bearer cards).
  </Step>

  <Step title="Reload">
    Add value to an existing card.
  </Step>

  <Step title="Void">
    Cancel a card so it can no longer be redeemed.
  </Step>

  <Step title="Look up & report">
    Find a card by code, check its balance, and review **breakage** (unspent
    value).
  </Step>
</Steps>

Redemption itself happens at the till; the Centrale manages the instruments and
reports on them. Cards can also be bulk-loaded via import.

## Store credit

Store credit is value owed back to a customer — for example from a return —
usable on a future purchase. It is held against the customer's account and can be
granted, topped up and viewed as a ledger, with an overview of outstanding
balances.

## In the API

| Capability   | Endpoints                                                                                                                                                                                                                                             |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Gift cards   | `GET/POST /v1/giftcards`, `GET /v1/giftcards/{id}`, `GET /v1/giftcards/by-code/{code}`, `POST /v1/giftcards/{id}/reload`, `POST /v1/giftcards/{id}/void`, `POST /v1/giftcards/redemptions`, `POST /v1/giftcards/import`, `GET /v1/giftcards/breakage` |
| Store credit | `POST /v1/credits/grant`, `POST /v1/credits/topup`, `GET /v1/credits/overview`, `GET /v1/credits/billing`, `POST /v1/credits/plan`                                                                                                                    |

See the [API Reference](/en/developers/overview) for full details, and
[customers](/en/centrale/clients) for the account credit is held against.