開発者向けの変更です。
API バージョン 2027-01 から、アプリが定期購入のストアクレジットを読み書きできるようになります。
客が選べば、更新のたびにストアクレジットが先に充てられます
発表は2026年11月19日の developer changelog。
出典: Shopify developer changelog「Subscriptions now support store credit with allowStoreCredit」2026年11月19日
https://shopify.dev/changelog/posts/subscriptions-now-support-store-credit-with-allowstorecredit
Version は 2027-01、フラグは「New」です。
タグは「Customer Account API」と「GraphQL Admin API」。
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.
(客がチェックアウトで、対象の定期購入にストアクレジットを使うと選ぶと、Shopify は更新のたびに客のストアクレジットを先に充て、残りを保存された支払い方法に請求します)
選ぶのは客で、場所はチェックアウト。
順番は、ストアクレジットが先で、残りが支払い方法です。
中心になる欄は paymentConfiguration.allowStoreCredit です
GraphQL Admin API には、次の欄と入力が加わります。
- 販売プラン:
SellingPlanRecurringBillingPolicyのpaymentConfiguration.allowStoreCredit。sellingPlanGroupCreateとsellingPlanGroupUpdateで設定する - 契約:
SubscriptionContractとSubscriptionBillingCycleEditedContractのpaymentConfiguration.allowStoreCreditで設定を見る - 契約の計算: 作成と更新の計算の入力に、任意の
paymentConfigurationが加わる - 下書き:
SubscriptionDraftInput.paymentConfigurationを、subscriptionDraftUpdate・subscriptionContractCreate・subscriptionContractAtomicCreateで使える
販売プランの値は、そのプランの定期購入でストアクレジットを使えるかの印。
顧客ポータルからは読むだけです
Customer Account API の SubscriptionContract.paymentConfiguration.allowStoreCredit は読み取り専用です。
顧客ポータルは、この設定を表示できます。
Customer Account API の検証の決まりは次の4つです。
- 契約に明細が無いと、
allowStoreCredit: trueは通らない - どれかの明細の販売プランでストアクレジットが切ってあると、true は通らない。固定の販売プランも「切ってある」扱い
- 販売プランの無い明細では、true が通る
- false は、いつでも通る
計算が検証で落ちると、INVALID のエラーが返ります。
今ある販売プランと契約は false のままです
今ある販売プランと契約は変わらず、allowStoreCredit の既定値は false です。
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.
(対応は要りません。今ある販売プランと定期購入はこれまでどおり動きます。アプリの手直しが要るのは、ストアクレジットに対応したいときだけです)
対象は、販売プランや契約を扱うアプリと、契約を表示する顧客ポータル。
対応するアプリは計算の結果を見てから確定します
公式の手順は次の3つです。
- 販売プランに
allowStoreCreditを設定する - 契約に、下書きの入力か、契約の計算で設定する
- 計算のたびに
calculatedContract.paymentConfiguration.allowStoreCreditを読み、送った値と違えば確定しない
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 「eligible subscription」の条件は書かれていません
- この仕組みを使える国や地域は書かれていません
- 客がチェックアウトで選ぶ画面の見た目と文言は書かれていません
- ストアクレジットで全額をまかなえたときの請求の扱いは書かれていません。書かれているのは「charges the remaining balance」です
- 定期購入アプリを使わずに、店が管理画面だけで設定できるかは書かれていません
- 🔴 Related docs の7本は読んでいません。開発ストアでも試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の2つです。
- ストアクレジットに対応するなら、販売プランと契約に
allowStoreCreditを設定する処理を足す - 計算のあとに値を読み、送った値と違う計算は確定しない
店がやることは次の2つです。
- 定期購入でストアクレジットを使わせたいなら、使っている定期購入アプリが
allowStoreCreditに対応する予定かを開発元に問い合わせる - 何もしなければ、今の定期購入は false のまま動く
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Subscriptions now support store credit with allowStoreCredit」2026年11月19日
https://shopify.dev/changelog/posts/subscriptions-now-support-store-credit-with-allowstorecredit
上記の Shopify 公式の情報だけを一次情報として使っています。

