POS Integration¶
Gift Card Hero adds a tile to Shopify POS that gives in-store staff gift card tools without leaving the POS screen. You control what staff can do on the Shopify POS tab of POS tools in Gift Card Hero.
Not using Shopify POS? If your store runs on a non-Shopify register — Square, Clover, Lightspeed, Zettle, and similar — see Gift Hero POS instead: a web app that sells, prints and redeems Shopify gift cards next to your register.
What staff can do from POS¶
- Check a gift card balance — enter or scan a code to see the current balance
- Register a physical gift card — turn a printed card's code into an active gift card with a balance
- Reload a card — set a new balance, or add or deduct an amount, optionally with a payment in the cart
- Process a refund to a gift card — issue a refund amount as store credit on a new or existing gift card
- View a customer's gift cards — see all cards linked to a customer, and reload them
- Sync a card to your store network — for multistore setups
Setup¶
Step 1 — Add the tile to your POS home screen¶
- Open the Shopify POS app
- Press the Add tile button
- Go to the Apps menu item
- Select Gift Card Hero from the list
- Press the POS UI Extension button
- Press Done
The Gift Hero tile ("Manage gift cards and rewards") now appears on the POS home screen. Pressing it opens the Gift Card Hero tools. The same steps are shown in Gift Card Hero under POS tools → Shopify POS, in the Add the tile to Shopify POS card at the side of the page.
Use the POS UI Extension, not the App link
Shopify also offers an App link tile. It is deprecated and not recommended.
Step 2 — Choose what staff can do¶
Open POS tools in the left navigation and stay on the Shopify POS tab. If the page opens on the Gift Hero POS app tab, click Shopify POS. Changes are saved with the Save button in the save bar.

The card What staff can do in Shopify POS asks three questions. Checking a balance is always available, so there is no setting for it. Under the title, a line such as "Staff last used Gift Hero in Shopify POS yesterday" shows when staff last used the tile. It appears once the tile has been used.
Register gift cards¶
Tick Register gift cards (it's on by default) to let staff load a balance onto a new or pre-printed card without a sale. Untick it if every card must be sold through the cart. The Register Gift Card button in the tile's menu then shows "Gift card registration is not allowed."
Balance changes¶
Choose what staff can do with the balance of a card:
| Choice | What staff can do |
|---|---|
| Add and deduct (default) | Top up a card or spend from it in Reload Gift Card. |
| Deduct only | Spend from a card. Adding to a balance is not offered: staff can deduct an amount, or set a new balance that is not higher than the current one. |
| Off | Reload Gift Card is turned off. Staff can still check balances. A customer's gift cards no longer offer Reload balance, and the button in the tile's menu shows "Gift card reload is not allowed." |
The questions below only appear when they apply to your choice. A question that is hidden keeps its earlier answer, so switching back brings it back.
How staff enter a change¶
Shown unless Balance changes is Off. It decides which adjustment methods staff see in Reload Gift Card:
| Choice | In POS |
|---|---|
| Either way (default) | Set final balance and Add or deduct amount, side by side |
| Type the new balance | Only Set final balance |
| Type the amount to add or deduct | Only Add or deduct amount. Under Deduct only it reads Type the amount to deduct |
Payment for a top-up¶
Shown only under Add and deduct, as a top-up is the only change that can take payment. Choose when the customer pays:
| Choice | What happens |
|---|---|
| Staff decide, no payment by default (default) | The balance goes up at once. Staff can add a payment to the cart if they need one. |
| Staff decide, payment in the cart by default | The balance goes up at once. Add payment to cart is preselected, and staff can switch it off. |
| Always take payment first | The balance goes up only once the customer has paid in Shopify POS. |
Quick mode¶
The Quick mode card makes the tile skip its menu and open straight to Reload Gift Card. In the tile that is the card list headed Reload Balance.
- Tick Open straight to Reload Gift Card
- Under Hide in Reload Gift Card, tick what your staff don't need: How staff enter a change, Payment, Internal note, Email to the customer and Transaction history
- Save
The hide list only appears while quick mode is on. Hiding Payment takes the payment controls off the Reload Gift Card screen, but the rule you chose under Payment for a top-up still applies.
Quick mode isn't available while Balance changes is Off, as Reload Gift Card is turned off. The card says so. If you choose Off and save, quick mode is turned off as well. The fields you chose to hide are kept for when you turn it on again.

Which tab opens first¶
POS tools has two tabs: Shopify POS (this page) and the Gift Hero POS app tab for Gift Hero POS, the web app for other registers. The page opens on the tab of the POS your store uses:
- Your store has active staff accounts in the Gift Hero POS app and no Shopify POS use in the last 60 days (an order rung up at Shopify POS, or staff opening the Gift Card Hero tile): the Gift Hero POS app tab.
- Both are in use: the tab you opened last. Your browser remembers it for each store. If you haven't picked one yet, the one used more recently opens.
- Anything else, including a store that hasn't started with either: Shopify POS.
- If Gift Card Hero can't tell, it opens the tab you opened last, or Shopify POS.
A link to a tab opens that tab. Bookmarks and links to the old 3rd party POS tab open the Gift Hero POS app tab.
POS extension capabilities¶
The Gift Card Hero POS extension adds several pieces to Shopify POS:
Home tile¶
The Gift Hero tile opens Gift Hero Tools, with Check Balance, Reload Gift Card and Register Gift Card. (With quick mode on, it opens the card list of Reload Balance instead.)
Check Balance¶
Tap Scan gift card QR code or type the code in Search gift cards and tap Search. The result shows the gift card (last characters), its Balance, and — where they apply — the date it was deactivated or when it expires. If the code isn't found, Register this gift card is offered, unless Register gift cards is turned off in POS tools → Shopify POS; then staff only see that the code wasn't found.
On a device with no camera, or without camera permission, the screen says so and suggests a hardware scanner.
Register Gift Card¶
Activates a printed gift card at the register. Staff scan the card's QR code or type its code (at least 8 characters), enter the Gift card value and tap Register Gift Card. The code becomes an active Shopify gift card with that balance; a code that already exists as a gift card is refused.
Registering creates the card without taking payment, so staff make sure the card's value has been paid. To turn this option off for staff, untick Register gift cards in POS tools → Shopify POS. See Physical Gift Cards for the other ways to activate printed cards.
Reload Balance¶
Staff open it with Reload Gift Card in the tile's menu; its screens are headed Reload Balance. Add funds to a gift card at the register. Search for the card by code, or leave the search empty to list cards, then tap the card (disabled cards can't be opened). The reload screen shows the Current balance and:
- Adjustment method — Set final balance, or Add or deduct amount (then Add to balance or Deduct from balance). Your Balance changes and How staff enter a change settings (see Step 2) decide which of these staff see: under Deduct only, Add to balance is missing.
- The New balance, Amount to add or Amount to deduct.
- No payment required or Add payment to cart — with a Payment amount that follows the amount added. Which one is preselected, and whether staff can change it, follows Payment for a top-up. Under Deduct only there is no payment choice.
- An optional Internal note.
- Send email notification to tell the customer — available when the card is linked to a customer. The subject and message are prefilled and editable; the wording comes from the reload balance email.
- Apply changes. Recent transactions for the card are listed below.
Order Refund¶
On an order's details screen, staff tap Refund to gift card. The refund screen offers:
- Refund to existing gift card — the customer's cards (the first three), when the order has a customer.
- Items to refund — a quantity for each line item. The Refund amount follows the selection and can be edited.
- An internal Note, and the customer's email — if the order has none, staff can add one.
- No expiration or Add expiration date for the new card.
Tap the Refund button (it shows the amount) to issue it. The Gift Card Details screen then shows the card's value and code, and lets staff reissue the card if needed. For the policy side, see Refunds as gift cards.
Customer Gift Cards¶
When a customer is open in POS, the customer details screen has a Manage gift cards button (and View gift cards in the action menu). It opens the customer's gift cards, each with its balance, transaction history and a Reload balance button. That button works like Reload Balance and follows the same settings: it isn't shown when Balance changes is Off, it only deducts under Deduct only, and a top-up takes payment as set under Payment for a top-up. A top-up under Always take payment first is added to the POS cart and credited once the sale is paid.
Sync a card to the network¶
For stores in a multistore network, order details and the post-purchase screen offer Sync gift card to network: scan or enter a gift card code and tap Sync to network to make the card available across all stores in the network.
Accepting a gift card as payment¶
Gift card redemption at checkout is handled natively by Shopify POS — no Gift Card Hero action is needed. When a customer wants to pay with a gift card:
- Add items to the cart as normal
- Tap Charge
- Select Gift Card as the payment method
- Scan or type the code
Shopify POS deducts from the balance automatically.
If you turn on redemption notifications, the cardholder — or the purchaser, or both, depending on Who gets notified — is also told what was spent, what is left and at which branch.
Troubleshooting¶
The Gift Card Hero tile doesn't appear in POS¶
- Update the Shopify POS app to the latest version
- Open the tile picker (Add tile → Apps) and check that Gift Card Hero is listed, then add it again using POS UI Extension
- On iPads: force-close and reopen the POS app
"Failed to load" error in the POS tile¶
The POS device can't reach the Gift Card Hero API. Check: - Is the device connected to the internet? - Is there a firewall or content filter blocking outbound connections? - Try switching from WiFi to cellular (or vice versa) to isolate a network issue
"Action not allowed"¶
The action has been turned off in POS tools → Shopify POS. For Register Gift Card, tick Register gift cards. For Reload Gift Card, set Balance changes to Add and deduct or Deduct only. Then save.
The camera shows a black screen when scanning (iPad)¶
The Gift Card Hero extension relies on a recent Shopify POS API version (2026-07 or later) to show the camera on iPad. Update the Shopify POS app to the latest version and reopen the tile. If the camera is still black, type the code in Search gift cards, or use a hardware scanner.
The scan button is missing¶
The device either has no camera or hasn't been given camera permission. Allow the camera for Shopify POS in the device settings, or use a hardware scanner or type the code.
Balance check showing wrong amount¶
The balance shown is fetched live from Shopify. If it looks stale, check the device's internet connection and try again.
QR code in gift card email/balance page won't scan in POS¶
Symptoms: - Every gift card email shows what looks like the same QR code - Scanning that QR in Shopify POS does nothing or returns "not found" - The QR added to Apple Wallet does scan correctly
Cause: the gift card balance page (/gift_cards/{id}/{token}) is missing the dynamic QrCode Liquid object that's needed to render the per-card QR. When that object isn't exposed, Gift Card Hero falls back to a static placeholder image, so every email ends up with the same non-scannable code.
Fix: contact Gift Card Hero support with the affected store domain - we'll patch the rendering on our side so the per-card QR is generated correctly. After the fix, both the email and the balance page will show the unique QR that scans into POS.