Site · Ecommerce
Gift Cards
Last updated 18 November 2026
Issue gift cards, track their balance and apply them to orders.
What gift cards are for
A gift card holds a value that a customer can spend on an order. Each card has a code, the value it started with, the balance left on it, a status and an optional expiry date. Every change to the balance is written to the card's transaction history, so you can see where the money went.
Open Ecommerce > Gift Cards to see every card on the site.
The gift card list
The list shows one row per card. Search by Code, sort by any column, and choose 10, 20, 50 or 100 rows per page.
| Column | What it shows |
|---|---|
| Code | The code the customer enters. Codes are generated by the site in the form XXXX-XXXX-XXXX. |
| Initial Value | The value the card was issued with. |
| Balance Remaining | What is still left to spend. |
| Expiry Date | When the card stops working. Empty when the card never expires. |
| Last Updated | When the card last changed. |
| Status | Active, Cancelled, Spent or Expired. See the table below. |
Statuses
| Status | Meaning | Set by |
|---|---|---|
| Active | The card can be used. | The site when the card is issued, or you |
| Cancelled | The card can no longer be used. | You, on the card's Details tab |
| Spent | The whole balance has been used. | The site |
| Expired | The expiry date has passed. | The site |
You can switch a card between Active and Cancelled. A card that is Spent or Expired shows its status as read-only.
Add a gift card
- Go to Ecommerce > Gift Cards.
- Select Add Gift Card.
- Enter the Initial Value. It is required and must be at least 0.01.
- Leave Expiry Date set to Never Expires, or switch it to Has Expiry Date and pick a date.
- Select Add Gift Card.
The site generates the code and sets the balance to the initial value. You cannot type your own code.
View or change a gift card
Select a card in the list to open it. It has two tabs.
| Tab | What you can do |
|---|---|
| Details | See the Initial Value, Balance Remaining and Code, which are read-only. Change the Status between Active and Cancelled, and change the expiry date. |
| Transaction Histories | See every change to the balance, with the Order, Type, Amount, Balance After and Date. |
Transaction types
| Type | When it is written |
|---|---|
| Issue | The card is created with its full value. |
| Redemption | The card is used to pay for an order. |
| Adjustment | An amount is put back on the card, for example when the card is removed from an order. |
Use a gift card on an order
- Open the order in Ecommerce > Orders.
- Select Apply Gift Card.
- Enter the Gift Card Code and select Apply Gift Card.
You do not enter an amount. The site takes the smaller of the card's balance and what is still owed on the order. It records a gift card payment on the order and a Redemption on the card.
The card is refused when:
- no card has that code
- the card has no balance left
- the card is cancelled or has expired
- nothing is owed on the order
Removing a gift card from an order puts the amount back on the card and writes an Adjustment. Gift card payments on an order cannot be edited or deleted like other payments; remove the card instead.
Gift cards through the API
The Ecommerce API can list gift cards, look one up by code, issue a new card, and apply or remove a card on an order. A website uses these to sell gift cards and to let customers pay with them at checkout. See API for how to call the module endpoints.