Gift card manager
Use Gift card manager to review gift-card records by status. It is an operational and transaction-sensitive overview, not a place to test card issuance, redemption, or customer delivery.
Gift card manager is available to Dashboard administrators when the Gift cards add-on is enabled. If the add-on is not enabled for your project, the /gift-cards route is not available.
Review card status records
- Open Gift card manager.
- Select Pending to review cards with pending or sent status, or Redeemed to review activated cards.
- Use Search only when necessary. It matches card ID and purchaser name, email, or phone.
- Use page navigation to review additional records.
The current table shows ID, purchaser, redeemer, purchased date, and redeemed date. It does not display the card code/password, amount, recipient, wallet balance, or card message in the reviewed list view.
Gift-card responses can include purchaser, recipient, and redeemer contact information as well as transaction and order data. Use a synthetic fixture for screenshots and support examples. Never share card codes, passwords, balance/value, emails, phone numbers, addresses, messages, or real customer identities.
Understand status and balance boundaries
The Pending tab requests pending and sent cards; Redeemed requests activated cards. Current API source shows that redemption is not simply a label change: its controller validates the card and availability, creates or uses a wallet, records a wallet movement, changes wallet value, activates the card, and dispatches wallet-event jobs. This source trace is an effect inventory, not permission to redeem a card or proof that a particular backend build performed those effects.
Do not infer a card’s balance from this page. The manager does not display balances, codes, passwords, or a manual status switch. It also does not provide the reviewed UI controls to create, send, redeem, or delete an individual card.
Loading or searching the manager sends an authenticated GET to the gift-card collection with status and optional purchaser search conditions. The reviewed API route family also contains register, redeem, delete, and send mutations, but the manager list does not expose them as row actions. Do not call those routes for inspection, and do not treat the list GET as safe merely by verb.
Use Setup Gift Cards with care
Setup Gift Cards opens a separate configuration panel for gift-card platform products. That panel can contain name, amount, image, enabled state, and Save/Add/Delete actions.
Saving a platform product, toggling its enabled state, uploading an image, or deleting it changes live configuration. Do not open or use these controls merely to inspect production values. Follow your approved catalog/configuration process.
The image picker currently accepts PNG, JPEG, and JPG files up to 2 MB before its crop step. That client-side check is not a guarantee of every server-side validation or customer-facing presentation.
No immutable serving receipt connects these current source paths to a deployed Dashboard or API. Configuration, card delivery, redemption, wallet value, queued notifications, and customer-facing results remain outside this guide's verified claims.
Troubleshooting
Why is Gift card manager unavailable?
The Gift cards add-on must be enabled and you must be a Dashboard administrator. Ask an administrator to verify add-on availability rather than trying a direct route.
Why is a card in Pending rather than Redeemed?
Pending includes cards that are pending or sent. A card becomes activated only through the redemption process after its validation and wallet checks succeed.
Can I use this page to find a card balance or code?
No. The reviewed list does not show balance, code, or password. Treat those values as sensitive and use your approved customer-support or financial process when they are required.
Related guides: Open carts overview · Platform settings