Gift Cards

📄️List Gift Cards

Paginated list of gift cards with their computed balance (N+1-safe). Filterable by status/customer/digital and searchable by code or recipient. Requires pos.operate.

📄️Issue Gift Card

Issue (create + fund) a new gift card. The initial `amount` is written as an activation ledger entry and becomes the card's opening balance.

📄️Lookup Gift Card by Code

Resolve a gift card by its code (POS entry) and return it alongside its current balance. Use this when a customer presents a card at checkout.

📄️Get Gift Card

Show a single gift card by id, including its current balance and lifecycle status.

📄️Get Gift Card History

Paginated ledger history for a gift card, newest first. Each entry records a value movement (activation, reload, redemption, refund, adjustment, or void), the resulting balance, and who created it.

📄️Reload Gift Card

Add value to an existing gift card. Writes a reload ledger entry and returns it with the card's new balance.

📄️Void Gift Card

Void a gift card. Drains any remaining balance (via a void ledger entry) and marks the card `voided` so it can no longer be redeemed. No request body.