Shopify adds subscription store-credit controls in API 2027-01

Shopify’s API version 2027-01 introduces controls for store credit on subscriptions. The 19 November changelog describes an optional capability for subscription apps, rather than a mandatory change…

SSophie Harrington1 min read

Shopify’s API version 2027-01 introduces controls for store credit on subscriptions. The 19 November changelog describes an optional capability for subscription apps, rather than a mandatory change to existing plans.

When a customer opts in at checkout for an eligible subscription, Shopify applies available store credit to each renewal first and charges the remainder to the saved payment method. Existing plans and contracts are unchanged, with allowStoreCredit defaulting to false.

Eligibility and version matter

The new fields are available in the GraphQL Admin API and Customer Account API from version 2027-01. Customer portals can read the setting; the Customer Account field is read-only. Fixed selling plans count as having store credit disabled, and validation can reject an attempted enabled setting for an ineligible contract.

Shopify tells app developers to inspect the calculated contract’s setting before committing it and avoid committing when it differs from the requested value. No action is required unless an app wants to support the capability.

Ask your subscription provider before promising it

Our recommendation for merchants is to confirm which API version and workflow their subscription provider supports before advertising credit-funded renewals. An API announcement does not prove that a particular customer portal or installed app already exposes the option.

Ask the provider to demonstrate a renewal with enough credit, one with only partial credit, and one with no available credit. Check that customer messages explain the amount charged to the saved payment method and that support staff can trace the result.

Treat the rollout as a change to payment expectations as well as integration behaviour. Clear opt-in language and a checked renewal receipt are more useful than assuming every subscription will automatically consume store credit.

ℹ️
Optional support in API version 2027-01. Existing plans and contracts stay unchanged, and allowStoreCredit defaults to false. Check your app’s version and eligibility before promising customers the feature.
Filed underShopify

More from Shopify

See all →