Gift Cards

The gift card records in the current source and what checkout does with them.

Openfront has gift card records and an operator page, but the current checkout does not redeem them.

Model

GiftCard has code, value, balance (integers in minor units), isDisabled, endsAt, metadata, and links to a region, an order, carts and GiftCardTransaction records. A transaction has amount, isTaxable, taxRate, and links to the card and an order. Creating gift cards requires canManageGiftCards. Products also have an isGiftcard flag.

Operator page

/dashboard/platform/gift-cards lists cards with status tabs, shows code, value, balance, expiry and transactions, and can enable or disable a card. Create and edit cards through the list's create drawer or the generic /dashboard/gift-cards editor.

Gift card redemption is not supported in the current checkout. updateActiveCart rejects any change to giftCards with "Gift-card redemption is outside the bounded launch boundary". Nothing in the checkout writes a GiftCardTransaction or lowers a balance. Selling a product with isGiftcard set does not create a gift card.

The cart still has a computed giftCardTotal field and the storefront has gift-card display code. They show nothing because no cart can have gift cards attached through the storefront.

On this page