開発者向けの変更です。
カゴ落ちの回復 URL を読むアプリに、保護された顧客データの承認が要るようになります。
公開アプリは2026年12月1日から承認が要ります
発表は2026年11月19日の developer changelog。
出典: Shopify developer changelog「
abandonedCheckoutUrlnow requires level 2 protected customer data access」2026年11月19日
https://shopify.dev/changelog/posts/abandonedcheckouturl-now-requires-level-2-protected-customer-data-access
フラグは「Breaking API Change」と「Action required」です。
タグは次の3つです。
- Admin REST API
- Events & webhooks
- GraphQL Admin API
GraphQL での対象の欄は abandonedCheckoutUrl です。
REST と webhook では abandoned_checkout_url です。
この決まりは、サポート中の全ての Admin API のバージョンと unstable に掛かります。
承認が要るのは、次の4項目の全てです。
- 名前
- メールアドレス
- 電話番号
- 住所
If your app reads
AbandonedCheckout.abandonedCheckoutUrlorabandoned_checkout_urlbut doesn’t need it, stop using the field. If your app needs it, request access before your date. This is a breaking change made for security reasons.
(アプリがこの欄を読んでいても要らないなら、使うのをやめます。要るなら、期限より前に承認を求めます。安全のための、互換性の無い変更です)
期限はアプリの種類で分かれます
種類ごとの期限と取り方は次のとおりです。
| アプリ | 期限 | 取り方 |
|---|---|---|
| 公開アプリ | 2026年12月1日 | 申請する。データ保護の審査がある |
| パートナーが特定の店のために作るカスタムアプリ | 2027年1月1日 | Dev Dashboard で4項目を自分で有効にする。審査なし |
| 店が Dev Dashboard で作るアプリ | 2027年1月1日 | Dev Dashboard で4項目を自分で有効にする。審査なし |
| 管理画面で作ったアプリ | 対象外 | 何もしなくてよい |
4項目の一部だけの承認では足りません。
Approval for only some of them isn’t enough.
(一部だけの承認では足りません)
回復 URL は客の名前や住所が入った画面を開きます
公式は、回復 URL を開くと、客の4項目が入ったチェックアウトが出る点を理由に挙げています。
The recovery URL opens the buyer’s checkout with their name, email, phone, and address filled in. Apps without access to those fields already can’t read that data on the
AbandonedCheckoutobject, so the URL now requires the same access.
(回復 URL は、客の名前・メール・電話・住所が入った状態のチェックアウトを開きます。4項目を読めないアプリは、今もAbandonedCheckoutオブジェクトでその情報を読めません。そのため、URL にも同じ承認を求めます)
URL にも、4項目と同じ承認を求める形。
GraphQL では選んだクエリごと失敗します
4項目の承認がそろっていないアプリがこの欄(abandonedCheckoutUrl)を選ぶと、ACCESS_DENIED のエラーが返ります。
abandonedCheckoutsのような一覧のクエリはdata: nullを返す。URL だけでなく、そのクエリのカゴ落ちのデータが全部失われるnodeやnodesで引くと、そのチェックアウトは null になる- この欄を選ぶ bulk operations は、数分の再試行のあと
ACCESS_DENIEDで失敗する
公式の直し方は、クエリと bulk operations から欄を外すか、承認を求めること。
REST と webhook ではエラーなしで欄が消えます
4項目の承認がそろっていないアプリでは、REST の応答と webhook の中身から abandoned_checkout_url が抜けます。
Warning: If your app uses
abandoned_checkout_url, it won’t be there anymore. From your date, the field is removed from REST responses and webhook payloads for apps without access. There’s no error, so your app won’t be told it’s missing.
(注意: 承認の無いアプリでは、期限の日から REST の応答と webhook の中身からこの欄が消えます。エラーは出ないので、アプリは欄が無いことを知らされません)
対象は次の2つです。
GET /admin/api/{version}/checkouts.jsonの応答checkouts/createとcheckouts/updateの webhook
ほかの欄は変わりません。
REST はこの欄を既定で返します。
使っていなくても、今は受け取っているアプリがある形。
承認の無いアプリでは、カゴ落ちのメールからリンクが消えます
回復 URL を使う機能は、承認が無いとリンクを失います。
If your app reads it, features that use the URL, such as recovery emails, SMS, or direct mail, lose their link, and code that assumes the key is present may fail.
(アプリがこの欄を読んでいるなら、回復メールや SMS、ダイレクトメールのように URL を使う機能はリンクを失います。欄がある前提のコードは失敗することがあります)
カゴ落ちの回復メールや SMS をアプリで送っている店に関わる変更。
承認は Dev Dashboard の Access requests から求めます
求める場所は、Dev Dashboard のアプリの設定です。
- Settings > Access requests > Protected customer data > Manage と進む
- そこで名前・メール・電話・住所の4項目を選び、理由を書く
- カスタムアプリは、審査なしで自分で有効にできる
- 公開アプリは、データ保護の審査を通る必要がある。審査には2週間ほどかかることがあるので、早めの申請を公式は勧めている
- 開発ストアでは承認を求めないので、このエラーは出ない。承認の状態は Dev Dashboard で見る
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 店の管理画面に、承認の無いアプリについての表示が出るかは書かれていません
- どのアプリが回復 URL を使っているかを、店が知る方法は書かれていません
- Shopify が自分で送るカゴ落ちのメールに影響があるかは書かれていません。書かれているのはアプリが API で読む場合です
- 審査にかかる日数の確かな目安は書かれていません。書かれているのは「a couple of weeks」です
- 🔴 Related docs の3本は読んでいません。開発ストアでも試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の4つです。
- アプリが回復 URL を読んでいるかを見る
- 使っていなければクエリから外す。REST では
fieldsで使う欄だけを求める - 使っていれば、期限より前に4項目の承認を求める。公開アプリは審査の日数を見込む
- REST と webhook で欄が無くても壊れないようにする
店がやることは次の2つです。
- カゴ落ちの回復メールや SMS をアプリで送っているなら、その開発元に期限への対応を問い合わせる。公開アプリは2026年12月1日、カスタムアプリは2027年1月1日
- 期限のあと、回復メールのリンクが残っているかを見る
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「
abandonedCheckoutUrlnow requires level 2 protected customer data access」2026年11月19日
https://shopify.dev/changelog/posts/abandonedcheckouturl-now-requires-level-2-protected-customer-data-access
上記の Shopify 公式の情報だけを一次情報として使っています。

