---
title: >-
  Subscriptions now support store credit with allowStoreCredit - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/subscriptions-now-support-store-credit-with-allowstorecredit
  md: >-
    https://shopify.dev/changelog/posts/subscriptions-now-support-store-credit-with-allowstorecredit.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: Customer Account API
      handle: customer-account-graphql
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-11-12T12:07:33-05:00'
  postedAt: '2026-11-19T12:00:00-05:00'
  updatedAt: '2026-11-16T14:00:01-05:00'
  effectiveAt: '2026-11-19T12:00:00-05:00'
---

November 19, 2026

# Subscriptions now support store credit with allowStoreCredit

DateNovember 19, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

FlagsNew

Tags[Customer Account API](https://shopify.dev/changelog?api_type=customer-account-graphql)[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

As of API version `2027-01`, apps can read and manage store credit on subscriptions. When a customer opts in to store credit for an eligible subscription at checkout, Shopify applies the customer's store credit to each renewal first and charges the remaining balance to the saved payment method. The change is available in the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql/2027-01) and the [Customer Account API](https://shopify.dev/docs/api/customer/2027-01), and doesn't require any mandatory action.

## What changed

The GraphQL Admin API adds the following fields and inputs:

* **Selling plans:** [`SellingPlanRecurringBillingPolicy.paymentConfiguration.allowStoreCredit`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SellingPlanRecurringBillingPolicy) shows whether subscriptions on a selling plan can use store credit. You set it through `paymentConfiguration` on [`SellingPlanRecurringBillingPolicyInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SellingPlanRecurringBillingPolicyInput), in `sellingPlansToCreate` and `sellingPlansToUpdate` on [`sellingPlanGroupCreate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/sellingPlanGroupCreate) and [`sellingPlanGroupUpdate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/sellingPlanGroupUpdate).
* **Contracts:** [`SubscriptionContract.paymentConfiguration.allowStoreCredit`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SubscriptionContract) and [`SubscriptionBillingCycleEditedContract.paymentConfiguration.allowStoreCredit`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SubscriptionBillingCycleEditedContract) show the contract's store credit setting.
* **Contract calculation:** `paymentConfiguration` is a new optional input on [`SubscriptionContractCalculationContractCreateInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SubscriptionContractCalculationContractCreateInput) and [`SubscriptionContractCalculationContractUpdateInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SubscriptionContractCalculationContractUpdateInput). [`SubscriptionCalculatedContract.paymentConfiguration`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SubscriptionCalculatedContract) shows the value that the commit applies.
* **SubscriptionDraft:** [`SubscriptionDraftInput.paymentConfiguration`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SubscriptionDraftInput) is available on [`subscriptionDraftUpdate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/subscriptionDraftUpdate), [`subscriptionContractCreate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/subscriptionContractCreate), and [`subscriptionContractAtomicCreate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/subscriptionContractAtomicCreate).

In the Customer Account API, [`SubscriptionContract.paymentConfiguration.allowStoreCredit`](https://shopify.dev/docs/api/customer/2027-01/objects/SubscriptionContract) returns the store credit setting. Customer portals can display it, and the field is read-only.

The Customer Account API applies the following validation rules:

* The API rejects `allowStoreCredit: true` when the contract has no lines.
* The API rejects `allowStoreCredit: true` when any line's selling plan has store credit off. A fixed selling plan counts as store credit off.
* The API accepts `allowStoreCredit: true` on lines that have no selling plan.
* The API always accepts `allowStoreCredit: false`.

If a calculation fails validation, then the API returns an `INVALID` error on `calculatedContract.paymentConfiguration.allowStoreCredit`. On a [`subscriptionDraftCommit`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/subscriptionDraftCommit), it returns an `INVALID` user error.

## Who's affected

This change affects:

* Apps that create or manage subscription selling plans or subscription contracts using the GraphQL Admin API.
* Customer portals that read and display subscription contracts using the Customer Account API.

The new `paymentConfiguration.allowStoreCredit` fields are available in API version `2027-01` and later. Existing selling plans and contracts are unchanged, and their `allowStoreCredit` default value is `false`.

## What to do

No action is required. Existing selling plans and subscriptions continue to work as before, and you only need to update your app if you want to add support for store credit.

To add store credit support in your app:

1. Set `allowStoreCredit` on your selling plans through [`SellingPlanRecurringBillingPolicyInput.paymentConfiguration`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SellingPlanRecurringBillingPolicyInput).
2. Set `allowStoreCredit` on your contracts, either directly through [`SubscriptionDraftInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SubscriptionDraftInput) or through contract calculations.
3. After each calculation, read `calculatedContract.paymentConfiguration.allowStoreCredit`, and don't commit the calculation if the value differs from the value that you sent.

For implementation details, end-to-end examples, and request shapes, see [Use store credit with subscriptions](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/store-credit).

## Related docs

* [Use store credit with subscriptions](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/store-credit)
* [About subscriptions](https://shopify.dev/docs/apps/build/purchase-options/subscriptions)
* [Admin API: `SellingPlanRecurringBillingPolicy`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SellingPlanRecurringBillingPolicy)
* [Admin API: `SubscriptionContract`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SubscriptionContract)
* [Admin API: `SubscriptionDraftInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/SubscriptionDraftInput)
* [Admin API: `SubscriptionCalculatedContract`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/SubscriptionCalculatedContract)
* [Customer Account API: `SubscriptionContract`](https://shopify.dev/docs/api/customer/2027-01/objects/SubscriptionContract)
