Shopifyのチェックアウト検証とは、アプリがストアにインストールする、Cart and Checkout Validation APIのShopify Functionです。 カートやチェックアウトが変わるたびに、Shopifyが自社のサーバーでそれを実行します。Functionがエラーを返すと、チェックアウトにメッセージが表示され、購入者は問題を解消するまで注文を完了できません。通常のチェックアウト、Shop PayやApple Payなどのエクスプレスボタン、ヘッドレスのチェックアウト、下書き注文で実行され、公開アプリのものであればどのShopifyプランでも動作します。POS、サブスクリプションの更新、注文の編集、APIで作成された注文では実行されません。注文をブロックすることはできますが、カートを変更したり在庫を確保したりはできません。
最終確認日:2026年10月8日。Shopifyの開発者ドキュメントとヘルプセンターと照合しています。出典は末尾にあります。
開示:OrderRulesはチェックアウト検証アプリです。このガイドでは、まずShopifyのプラットフォームを説明し、その後で私たちの使い方を説明します。

検証Functionとは
Shopify Functionsを使うと、アプリはShopifyのバックエンドに独自のロジックを追加できます。Function APIはそれぞれ1つの役割を担います。ディスカウント、配送オプション、支払い方法などです。検証は、カートがチェックアウトに進めるかどうかを決めるAPIです。
仕組みは次のとおりです。
- アプリがFunctionを提供する。 FunctionはWebAssemblyにコンパイルされ、アプリと一緒にデプロイされます。あなたはアプリをインストールするだけで、コードには触れません。
- 実行するのはテーマではなくShopify。 Functionは買い物客のブラウザではなく、Shopifyのインフラの中で実行されます。JavaScriptをオフにしても、ページを書き換えても、スキップできません。
- 入力を読み、エラーを返す。 Shopifyがカートと関連データを渡します。Functionはエラーのリストを返し、各エラーにはメッセージと対象(カート全体、または特定のフィールド)があります。
- チェックアウトにメッセージが表示される。 リストが空ならチェックアウトは続行。エラーがあれば、Shopifyがメッセージを表示し、購入者が何かを変えるまで完了をブロックします。
ShopifyはFunctionを購入の流れの複数の時点で実行します。カートでの操作時、チェックアウトでの操作時、チェックアウト完了時です。Functionは今どのステップかを確認し、チェックアウトでだけブロックすることもできます。そうすれば、カートへの追加が失敗することはありません。
ShopifyはFunctionを小さく高速に保つよう求めています。1回の実行には命令数と入力サイズに厳しい制限があるため、ロジックはシンプルに、データはコンパクトにする必要があります。
以下は、現在のターゲット cart.validations.generate.run を使ったJavaScriptの簡略化した例です。説明用であり、OrderRulesのコードではありません。
// Simplified example, not production code.
// Input comes from a GraphQL input query (cart lines, buyer identity, metafields).
export function cartValidationsGenerateRun(input) {
const limits = input.shop.limits?.jsonValue ?? {}; // written by the app ahead of time
const errors = [];
for (const line of input.cart.lines) {
const productId = line.merchandise.product?.id;
const remaining = limits[productId];
if (remaining !== undefined && line.quantity > remaining) {
errors.push({
message: `Only ${remaining} left for today. Lower the quantity to continue.`,
target: "$.cart",
});
}
}
return { operations: [{ validationAdd: { errors } }] };
}
ないものに注目してください。データベースへの問い合わせも、API呼び出しも、「今日の注文数を数える」処理もありません。Functionに見えるのは入力に含まれるものだけです。以下のすべてはこの前提から決まります。
実行される場所、されない場所
Shopifyは、検証Functionが実行される場所をドキュメントで示しています。この表はCart and Checkout Validation APIのリファレンスに沿っています。
| 経路 | 検証は実行される? | 備考 |
|---|---|---|
| オンラインストアのカートとチェックアウト | はい | カートとチェックアウトは別々に記載され、どちらも対応 |
| Shop Pay、Apple Pay、Google Pay、PayPalエクスプレス、今すぐ購入 | はい | Storefront Accelerated Checkoutとして記載 |
| ヘッドレスストアフロント(Storefront API) | はい | Hydrogenや独自のフロントエンドを含む |
| B2Bチェックアウト | はい | 会社の購入者にも同じ検証 |
| 下書き注文(管理画面と請求書チェックアウト) | はい | Draft Order(Admin and Checkout)およびShopify Adminとして記載 |
| Shopify POS | いいえ | 店頭での販売は検証されない |
| サブスクリプションの更新注文 | いいえ | 検証されるのは最初のサブスクリプションのチェックアウトのみ |
| 注文の編集 | いいえ | 購入後に注文を編集すると検証をスキップ |
| Create Order API | いいえ | 他のアプリや連携サービスが作成した注文 |
| 予約注文とお試し購入 | いいえ | 後払い型の購入オプションは非対応 |
つまり、「回避できない」という表現は正確ではありません。オンラインストアやエクスプレスボタンから、買い物客が検証をスキップすることはできません。しかし、POS、更新、編集、APIからの注文は、そもそも検証を通りません。上限に頼るなら、ストアがこれらのどの経路を使っているか確認してください。
Functionに見えるもの
Functionは入力クエリをGraphQLで宣言し、Shopifyが実行のたびにそれを埋めます。役に立つフィールドには次のものがあります。
- カートの明細: 数量、バリエーション、商品、重量、明細の属性。
- 購入者の情報: ログインしているかどうか。顧客であれば、注文回数や購入金額などのフィールド。
- メタフィールド: ショップ、商品、バリエーション、顧客のもの。
- カートの属性: 例えば、カートページで選んだ配送日。
- 購入の流れのステップ: カートでの操作、チェックアウトでの操作、チェックアウト完了。
公開アプリでできないこと:ネットワーク通信です。チェックアウト中に、アプリのサーバーに「今日の注文は何件?」と問い合わせることはできません。代わりに、アプリは別の場所で集計します。Shopifyの注文通知を受け取り、合計を更新し、メタフィールドに書き込みます。Functionは次の実行時にそのメタフィールドを読みます。
だから、Functionの中の件数はスナップショットです。鮮度は最後にメタフィールドが書き込まれた時点までで、リアルタイムではありません。
できること、できないこと
メッセージ付きでブロックできる。 出力はそれだけです。メッセージはカート全体またはチェックアウトの特定のフィールドを対象にでき、アプリによっては文言を自分で書けます。
数量は変更できない。 検証Functionは数量を減らすことも、明細を削除することも、価格を変えることもできません。旧来のShopify Scriptsはカートを黙って編集できましたが、検証にはできません。購入者がメッセージを読んで、カートを直します。カートの変更はCart Transformやディスカウントなど他のFunction APIが担い、それらはチェックアウトをブロックしません。
在庫や枠を確保できない。 Functionはスナップショットを読んで可否を答えるだけで、何も押さえません。2人の購入者が最後の1点や配送枠の最後の1枠に対してほぼ同時にチェックアウトすると、両方が「残り1」と読み、両方とも通ることがあります。検証は通常のトラフィックで上限を確実にしますが、絶対に超えないことを保証するものではありません。
検証Functionはストアあたり最大25個。 Shopifyは同時に有効にできる検証Functionの数に上限を設けています。複数のアプリがそれぞれ1つずつ追加でき、すべてが実行されます。どれか1つがエラーを返せば、チェックアウトはブロックされます。
プラン
- Functionsを使うApp Storeの公開アプリは、すべてのShopifyプランで動作します。 検証アプリをインストールするのにPlusは不要です。
- Functionsを使うカスタムアプリにはShopify Plusが必要です。 これは自社専用のFunctionを開発するストア向けです。
- Shopify Scriptsは廃止されました。 Scriptsは2026年6月30日に停止しました。多くの数量制限はラインアイテムスクリプトで実装されていました。あなたのストアもそうなら、数量とチェックアウトのルールをShopify ScriptsからFunctionsに置き換える方法を参照してください。
テーマのJavaScriptと検証の違い
多くの制限ツールはテーマ上で動きます。ボタンを隠したり、数量入力に上限をかけたり、カートページに警告を出したりします。上限を早めに見せるには便利ですが、適用(エンフォースメント)ではありません。
| テーマやカートページのJavaScript | 検証Function | |
|---|---|---|
| 通常のオンラインストアのチェックアウト | 購入者がJavaScript有効のままカートページを通った場合のみ | はい |
| 商品ページのShop Pay、Apple Pay、Google Payボタン | いいえ。カートページを経由しない | はい |
| チェックアウト直リンク | いいえ | はい |
| ヘッドレスストアフロント | いいえ。テーマがない | はい |
| 下書き注文 | いいえ | はい |
| POS | いいえ | いいえ |
| サブスクリプションの更新、注文の編集、APIからの注文 | いいえ | いいえ |
| チェックアウト前に上限を表示できる | はい | いいえ。カートがチェックされたときのメッセージのみ |
| JavaScriptをオフにするとスキップされる | はい | いいえ |
どちらもPOSと更新はカバーしません。最善の構成は両方を使うことです。ストアフロントのメッセージで買い物客に上限を早めに見せ、検証Functionをチェックアウトでの最終的なストッパーにします。
配送日も同じです。日付ピッカーはブラウザ上で満枠の日や休業日をグレーアウトしますが、エクスプレスボタンやチェックアウト直リンクはカレンダーのあるページを経由しません。選ばれた日付をチェックアウトで再チェックできるのは検証Functionだけです。チェックアウト検証の観点で比較したShopifyの配送日ピッカーアプリを参照してください。
OrderRulesでの使い方
OrderRulesは検証Functionを1つインストールします。あなたがアプリでルールを設定し、アプリが件数を管理してメタフィールドに書き込み、Functionがチェックアウトでそれを読んで、ルールに反する注文をブロックします。チェックする内容は次のとおりです。
- 営業時間と休業日: 営業時間外はチェックアウトを閉じます。
- 注文上限: ストア全体の1日の上限。有料プランでは週次・月次の上限も。
- 商品・バリエーション・コレクションの上限: すべての買い物客で共有する合計。
- 最小注文数量と購入単位数: 商品またはバリエーションごと、注文ごと。
- 顧客ごとの制限: ログインした顧客について、期間ごとの注文数、点数、購入金額、重量。
- 配送日と店舗受け取りの時間帯(Advancedプラン):締め切り時刻、休業日、時間帯ごとの上限。
各ルールの種類ごとのメッセージは「設定」で編集できます。ルールは、上の表で検証が実行されるすべての経路でチェックされます。POSの注文と更新はブロックされませんが、上限にはカウントされます。件数はスナップショットなので、最後の1枠に対するほぼ同時の2つのチェックアウトが、両方とも通ることがあります。
チェックアウトでの適用は、無料のStarterプランを含むすべてのプランに含まれます。詳しくは、OrderRulesのルールがチェックされる場所:互換性と制限を参照してください。
関連記事
- Shopifyで注文上限を設定する方法
- 売り越しを防ぐ:キャパシティに制約のあるストアの戦略
- 顧客ごとの注文制限ガイド
- 動的なストアフロントメッセージ
- チェックアウト検証で比較したShopifyの配送日ピッカーアプリ
- Shopify の配送日検証:チェックすべき項目と、お客様に表示されるメッセージ
- Shopifyの標準の注文制限とアプリの比較(2026年)
- OrderRulesのルールがチェックされる場所:互換性と制限
- 数量とチェックアウトのルールをShopify ScriptsからFunctionsに置き換える
出典
- Shopify.dev:Cart and Checkout Validation Function API(ターゲット、対応・非対応の経路、ストアあたりの上限)
- Shopify.dev:Build a cart and checkout validation Function
- Shopify.dev:Shopify Functions(公開アプリとカスタムアプリのプラン対応)
- Shopify.dev変更履歴:Shopify Scripts will be deprecated on June 30, 2026
- Shopifyヘルプセンター:Transitioning from Scripts to Functions
あなたのストアで試す
Shopify App StoreからOrderRulesをインストールしてください。チェックアウト検証はすべてのプランに含まれ、有料プランには14日間の無料トライアルがあります。