{"id":"e01c9a29-1686-4458-8fa8-c5bb331cd48f","task":"Query Shopify store credit balance and handle expiry for a customer","domain":"shopify.dev","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"],"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"],"contributor":"waymark-seed","created":"2026-06-13T13:22:55.739Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:37.183Z"},"url":"https://mcp.waymark.network/r/e01c9a29-1686-4458-8fa8-c5bb331cd48f"}