Review issued gift cards and ledger history

What the ledger shows

Every issued gift card has a ledger of value events. The ledger explains how the card moved from purchase or venue credit to reservation usage, and it helps the team answer guest questions about remaining value.

Open Settings / Gift Cards. The page title is Gift Cards, and the product list and Issued Cards list remain visible even when gift-card selling is disabled. When selling is disabled, product edits and public checkout stay blocked until gift-card eligibility is ready.

The issued card list shows the code, recipient, status badge, and Remaining {remaining} of {initial}. Select a card to load its detail panel.

Review an issued card

1. Open Settings / Gift Cards.
2. In Issued Cards, select the card by its code or recipient.
3. Confirm the list status badge and remaining amount.
4. In the detail panel, review the code and the purchaser/recipient line: Purchaser {purchaser} · Recipient {recipient}.
5. Read Balance, Expires, Status, and Attachment.
6. Read Ledger from oldest to newest. Each ledger row shows the event type, amount, and timestamp.

Understand statuses

The card status is resolved dynamically:

1. Expired when the current time is at or after Expires.
2. Depleted when the remaining balance is zero or below.
3. Active otherwise.

The attachment field shows whether value is connected to a reservation:

1. Not attached means there is no current reservation attachment.
2. Attached means value is reserved on a reservation.
3. Consumed means attached value was spent.
4. Released means the reservation attachment was returned.

Common ledger events

Ledger entries may include:

1. Issued when a paid gift-card purchase is issued, or when compensation venue credit is issued after paid-commitment settlement.
2. Attached when a guest applies the card to a reservation and value is reserved.
3. Consumed when attached value is spent.
4. Released when a reservation flow is cancelled or released and the attachment is returned.

Expired is a card status, not a ledger event in the current panel.

Use the ledger for support

If a guest asks why their balance changed, read the ledger before making assumptions. Start with Issued, then follow later entries in order: Attached means value was reserved, Consumed means it was spent, and Released means the reservation attachment was returned.

The panel ledger currently shows event type, amount, and timestamp. It does not show backend notes or reservation IDs, so check the reservation detail separately if the support question needs reservation context.