MENU
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
  1. ホーム
  2. Shopifyニュース
  3. 【Shopify最新ニュース2026・開発者向け】定期購入の更新にストアクレジットを使えるように、API に allowStoreCredit

【Shopify最新ニュース2026・開発者向け】定期購入の更新にストアクレジットを使えるように、API に allowStoreCredit

2026 11/20
2026年11月20日
Shopifyニュースのアイキャッチ:竹のすだれの上で、クラフト紙の封筒と薄紙に並ぶ小さな丸い缶に手を添える写真に「定期購入の更新でストアクレジットが選べる」の見出し

開発者向けの変更です。

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つです。

  1. ストアクレジットに対応するなら、販売プランと契約に allowStoreCredit を設定する処理を足す
  2. 計算のあとに値を読み、送った値と違う計算は確定しない

店がやることは次の2つです。

  1. 定期購入でストアクレジットを使わせたいなら、使っている定期購入アプリが allowStoreCredit に対応する予定かを開発元に問い合わせる
  2. 何もしなければ、今の定期購入は 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 公式の情報だけを一次情報として使っています。

Shopifyニュース
API変更 shopify Shopifyアプリ 顧客アカウント
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • 【Shopify最新ニュース2026・開発者向け】abandonedCheckoutUrl を読むアプリに、顧客データ4項目の承認が必要に

この記事を書いた人

テスタのアバター テスタ

さっぱりした性格で、率直。テンションは一定で、感情に流されない。褒めるときは短く的確、厳しいこともちゃんと言うが、人格否定はしないフェアさがある。遠回りが嫌いで、結論までの道筋をシンプルにしたがる。

関連記事

  • Shopifyニュースのアイキャッチ:段ボール箱の中のベージュのスニーカーに両手を添える写真に「カゴ落ちの回復URLに顧客データの承認が必要」の見出し
    【Shopify最新ニュース2026・開発者向け】abandonedCheckoutUrl を読むアプリに、顧客データ4項目の承認が必要に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:紺色の台の上で、灰色のニットを白い薄紙で包む両手と段ボール箱の写真に「12月1日以降の新しいカスタムアプリに期限付きトークンが必須」の見出し
    【Shopify最新ニュース2026・開発者向け】12月1日以降に作るカスタムアプリは期限付きのオフライントークンが必須に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:木の机の上で、クラフト紙に包んだ陶器のマグカップを両手で持つ写真に「ストアで動くアプリに接続先の宣言が必須に」の見出し
    【Shopify最新ニュース2026・開発者向け】オンラインストアで動くアプリに network access の宣言が必須に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:灰色の台の上で、段ボール箱の中のニットを包む薄紙を整える両手の写真に「下書き注文APIの割引にスタッフ権限が必要に」の見出し
    【Shopify最新ニュース2026・開発者向け】下書き注文の API で割引を足すには、スタッフの権限が必要に
    2026年11月19日
  • Shopifyニュースのアイキャッチ:木の机の上で、小箱に詰めたジャムの瓶2つに手を添える写真に「App Eventsを管理画面から送れるように」の見出し
    【Shopify最新ニュース2026・開発者向け】App Events を管理画面の拡張と埋め込みアプリから送れるように
    2026年11月19日
  • Shopifyニュースのアイキャッチ:開いた段ボール箱の上で、白いカードを持ちペンで書こうとする両手の写真に「管理画面のカスタムアプリがDev Dashboardに」の見出し
    【Shopify最新ニュース2026】管理画面で作ったカスタムアプリが Dev Dashboard に
    2026年11月19日
  • Shopifyニュースのアイキャッチ:灰色の台の上で、白い箱に畳んだ麻の布を収める両手の写真に「B2Bの拠点と注文の見え方を絞る」の見出し
    【Shopify最新ニュース2026・開発者向け】Customer Account API で B2B の拠点と注文の見え方を絞る
    2026年11月18日
  • Shopifyニュースのアイキャッチ:大理石の台の上で、段ボール箱に白いふたのボトルを詰める両手の写真に「EventBridgeの上限が1MBに」の見出し
    【Shopify最新ニュース2026・開発者向け】Amazon EventBridge の webhook の上限が1MBに
    2026年11月18日

最近の投稿

  • 【Shopify最新ニュース2026・開発者向け】定期購入の更新にストアクレジットを使えるように、API に allowStoreCredit
  • 【Shopify最新ニュース2026・開発者向け】abandonedCheckoutUrl を読むアプリに、顧客データ4項目の承認が必要に
  • 【Shopify最新ニュース2026・開発者向け】12月1日以降に作るカスタムアプリは期限付きのオフライントークンが必須に
  • 【Shopify最新ニュース2026・開発者向け】オンラインストアで動くアプリに network access の宣言が必須に
  • 【Shopify最新ニュース2026・開発者向け】下書き注文の API で割引を足すには、スタッフの権限が必要に

運営: 株式会社ギャザリング

  • プライバシーポリシー
  • 運営者情報
  • お問い合わせ

© ECサイトshopifyならキクシル.

目次