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 can draw on at checkout.

Gift cards

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

1. Issue

   Mint a new gift card with an initial balance. The gift-cards screen lists cards with their balance and status (including bearer cards).

2. Reload

   Add value to an existing card.

3. Void

   Cancel a card so it can no longer be redeemed.

4. Look up & report

   Find a card by code, check its balance, and review breakage (unspent value).

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 for full details, and customers for the account credit is held against.