When a customer redeems a portion of a Shopify gift card balance, the remaining funds should update immediately on the gift card record. If the card displays its original full balance, drops to $0.00 prematurely, or fails to show the updated balance across online and retail channels, your store has encountered an inventory or checkout ledger synchronization failure.
This issue typically stems from unfinalized or pending payment authorizations, delayed offline syncs on Shopify POS hardware, or currency conversion locks inside Shopify Markets.
Why is a Shopify gift card balance not updating after a partial purchase?
A Shopify gift card balance fails to update after partial use when the order’s secondary payment method is only authorized rather than captured, the transaction was run on a Shopify POS device operating in offline mode, or a multi-currency conversion calculation delayed balance settlement in Shopify Markets.
Fast Diagnostic Snapshot
| Parameter | Diagnostic Focus |
|---|---|
| Observed State | Gift card balance does not decrease, or displays an inaccurate remaining balance |
| Ledger System | Shopify Native Gift Card Engine / Payment Transaction Ledger |
| Primary Root Cause | Payment authorization delays on mixed-tender orders (Gift Card + Credit Card) |
| Secondary Root Cause | POS local transaction caching failing to push to the cloud |
| Admin Route | Shopify Admin > Products > Gift cards |
How Shopify Processes Gift Card Ledgers
In Shopify’s financial architecture, gift cards are treated as liabilities rather than standard promotional discount codes:
[Customer Applies $100 Gift Card to $40 Cart]
│
▼
[Shopify Verifies Active Card Balance]
│
▼
[Split Tender: $40 from Card, $0 Remaining Balance Due]
│
├── ONLINE CHECKOUT
│ └── Balance decrements immediately upon successful checkout completion.
│
└── SHOPIFY POS (In-Person Retail)
├── ONLINE: Card updates instantly across Shopify cloud.
└── OFFLINE: Local app records transaction; cloud balance
WILL NOT UPDATE until tablet reconnects to internet.
If the customer applied a gift card to cover part of the order (e.g., $50 gift card applied to a $75 purchase, with the remaining $25 charged to a credit card), the gift card ledger balance is tied directly to the settlement status of the credit card transaction.
Root Causes and Step-by-Step Fixes
1. Uncaptured Authorizations on Mixed-Tender Checkouts
If your store is configured to Manually capture payment rather than Automatically capture payment for orders:
- When a customer checks out using a gift card plus a credit card, the credit card portion enters an
Authorizedstate. - While Shopify places a temporary hold on the gift card funds to prevent double-spending, the final balance deduction on the customer-facing gift card pass does not settle until the order status transitions to
Paid.
The Fix:
- Navigate to Shopify Admin > Orders.
- Select the order where the gift card was used.
- Check the financial status badge:
- If it displays Authorized, click Capture payment.
- Once the credit card funds are captured and the order reads Paid, check the gift card record under Products > Gift cards. The balance will reflect the accurate decremented amount.
- If you want payments to settle automatically, go to Settings > Payments, find the Payment capture method card, and change the setting to Automatically at checkout.
If your credit card transactions routinely get stuck in an uncaptured holding pattern, see Fix: Shopify “Payment Pending” for Valid Transactions.
2. Shopify POS Device Operating in Offline Mode
If a partial gift card redemption occurred at your physical retail store using Shopify POS, and the iPad or POS Go terminal lost Wi-Fi connectivity:
- The POS device approves the transaction locally.
- The physical receipt shows the remaining balance calculated locally.
- However, Shopify’s online servers have no record of the sale until the device syncs. If the customer goes home and attempts to use the card online, the online checkout still displays the full previous balance.
The Fix:
- Open the Shopify POS app on the retail tablet.
- Tap the menu icon and navigate to Orders.
- Check if there are orders marked with an orange or yellow cloud icon (indicating pending cloud synchronization).
- Verify the tablet’s Wi-Fi connection. Force a manual sync by navigating to Settings > Support > Diagnostics > Network and connectivity.
- Once all queued retail orders are uploaded, the gift card balance will reflect accurately across the online store.
- If the POS tablet experiences recurring drops that halt sync queues, follow How to Resolve: Shopify “Point of Sale (POS)” Hardware Disconnection Loop.
3. Multi-Currency Conversion Rate Freezes in Shopify Markets
Shopify allows gift cards to be issued in one currency (e.g., USD) and spent in another (e.g., EUR or CAD).
When a multi-currency transaction occurs:
- Shopify converts the order total into the currency of the gift card using the market exchange rate active at checkout.
- If you use automated dynamic exchange rates under Shopify Markets, currency conversion rounding can cause small remaining fractional balances (e.g., $0.02) to appear on the card, or cause the balance display to delay updating while currency reconciliation clears.
The Fix:
- Open Settings > Markets.
- Click Preferences and inspect your Currency conversion settings.
- Open Products > Gift cards and click on the customer’s card.
- Under the timeline, review the Transaction details. Shopify logs the exact exchange rate applied and the base currency deduction.
- If the card displays an incorrect balance due to currency conversions, click Adjust balance on the gift card page to manually credit or debit the card.
For broader cross-border currency and pricing complications, review Troubleshooting: Shopify “Markets” showing incorrect Currency to International Users.
4. Third-Party Loyalty or Custom Gift Card App Collisions
If your store uses third-party loyalty or store credit apps (such as Rise.ai, Govalo, or Loyoly), these platforms often maintain a shadow ledger outside of Shopify’s native gift card database.
If the app’s API connection drops, an order placed through native checkout might deduct Shopify’s native balance without updating the third-party app’s balance widget, leading to conflicting numbers between what the customer sees on their account page and what works at checkout.
The Fix:
- Open the third-party gift card app from Shopify Admin > Apps.
- Search for the customer’s gift card code inside the app’s dashboard.
- Click Re-sync with Shopify to force the app to align its database with Shopify’s core ledger.
- If digital gift cards are stalling and failing to fulfill automatically upon purchase, consult Fix: Shopify “Fulfillment” stuck on “In Progress” for Digital Goods.