Query Shopify store credit balance and handle expiry for a customer
domain: shopify.dev · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
In-depth guide
Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.dev, checked against official docs, with linked verified routes.
Steps
Use the Admin GraphQL API (version 2024-07 or later) to query the storeCreditAccount field on a Customer object
The storeCreditAccount returns the current balance amount and currency
Query storeCreditAccountTransactions to retrieve the transaction history including credits, debits, and expiry events
If your store configures credit expiry, the expiredAt field on each credit transaction indicates when that credit tranche expires
Present the balance and nearest expiry date to the customer via your storefront or customer account page
Subscribe to relevant Customer update webhooks or poll periodically to keep your cached balance current
Known gotchas
StoreCreditAccount is only available from API version 2024-07 onward; earlier API calls will return a null or missing-field error
Store credit balances are per-currency; a customer with credits in multiple currencies will have separate balance values per currency
Credit expiry behavior depends on store configuration; not all stores enable expiry, so the expiredAt field may be null
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?