Reload Balance (Top-up)¶
The Reload Balance page lets you find gift cards and manually adjust their balances. Go to Reload Balance in the left navigation.
Finding a gift card¶
The page shows a searchable, paginated list of gift cards.
- Search by code — enter the last characters of the gift card code
- Search by email — enter the customer's email address
The list shows each card's code (partially masked), customer email, current balance, initial value, and status. Use the Previous / Next buttons to page through results.
If the feature requires an additional Shopify permission scope, a warning banner appears with a Give additional scope button to grant access.
Adjusting a balance¶
Click the adjust button on a card in the list to change its balance.
This is useful for:
- Store credit programs — manually add credit as a goodwill gesture or compensation
- Loyalty rewards — top up a card when a customer reaches a spending threshold
- Corrections — fix a balance that was set incorrectly
At POS, staff can also reload cards directly through the GiftCard Hero POS tile. See POS Integration for details.
Configuration¶
Click Configuration in the page header to open the reload settings.
Reload limit¶
A badge shows whether the $10,000 reload limit is Enabled or Disabled.
- Click Increase limit to raise the maximum allowed top-up amount (requires the
write_draft_ordersShopify scope) - Click Decrease limit to return to the standard $10,000 cap
If the write_draft_orders scope is missing, a warning banner appears with a Give additional scope button.
Email notification template¶
Configure the email sent to the cardholder after a balance is reloaded.
| Field | Notes |
|---|---|
| Email subject | Required. Subject line of the notification |
| Email body | Required. Body text of the notification |
Available placeholders:
| Placeholder | Outputs |
|---|---|
{first_name} |
Customer's first name |
{last_name} |
Customer's last name |
{email} |
Customer's email address |
{initial_value} |
Original face value of the gift card |
{balance} |
Balance before the reload |
{new_balance} |
Balance after the reload |
{last_characters} |
Last digits of the gift card code |
{reload_amount} |
Amount added in this transaction |
Both fields are required — if either is left empty, validation errors appear on save.
Storefront reload¶
