Gift cards

Gift cards are digital store credit you issue directly from the admin — no storefront purchase flow required. This guide covers issuing a card, adjusting its balance, and disabling one.

Find a gift card

1. Go to Commerce → Gift cards in the left nav.
2. The list shows the most recently issued cards. There’s no search or pagination today — it’s a single capped page of the 50 most recent cards.
3. Click a card to open its detail view: status, initial and remaining balance, expiry, who it was issued to and purchased by, and its full transaction history.

Issue a gift card

1. On the Gift cards page, fill in the Issue new gift card form.
2. Enter an Initial balance and a Currency (ISO 4217, defaults to USD).
3. Optionally pick an Issued-to customer — this is fully optional. A card issued without a customer is just as valid; you’d hand off or redeem the code some other way.
4. Optionally set an Expires at date.
5. Click Issue gift card.

The raw code is shown to you once, immediately after issuing — copy it now. Orchard stores only a hash of the code, never the raw value, so there is no way to look it up again later; the detail and list views only ever show a masked form of the code. If the card was issued to a customer, Orchard also emails them the code directly.

Adjust a gift card’s balance

Open a card’s detail page and use Adjust balance:

1. Enter a Delta — a positive number credits the card, a negative number debits it.
2. Enter a Reason. This is required: a balance adjustment is customer-visible money movement, and the reason is the audit-trail justification.
3. As you type, the form shows the current balance and the projected new balance. You can’t submit a debit that would push the balance below zero — the form blocks it before you can submit.
4. Click Adjust. For a debit (negative delta), a confirmation dialog (“Debit this gift card?”) repeats the amount and the resulting balance — confirm to apply it. Credits (positive deltas) submit directly, no confirmation needed.

Disable a gift card

Open a card’s detail page and click Disable this card under Disable card. A confirmation dialog explains that disabled cards can’t be redeemed and that there is no admin path to re-enable a disabled card — disabling is a one-way, permanent retirement of that card. Confirm to disable.

Disable and adjust are only available while the card isn’t already disabled.

Common questions

• A customer says they never got their code. If the card was issued to a customer, Orchard emails it at issue time. Check the customer’s email is correct and ask them to check spam. There is no way to re-send or re-reveal the raw code — you’d need to disable it and issue a new one.
• Can I re-enable a card I disabled by mistake? No — disabling is permanent. Issue a new card instead.
• Do I have to attach a customer when issuing a card? No. The customer picker is optional; an unattached card is fully functional, it just has no emailed recipient and won’t show up on a customer’s profile.

Next: look up who a card belongs to in Customers.