メインコンテンツへスキップ
技術

Shopifyのチェックアウト検証の仕組み(そしてアプリがそれで注文をブロックする方法)

Jahangir Alam2026年5月3日2026年10月8日更新2026年10月8日に事実確認済み17 min read
CheckoutShop PayApple PayBuy it nowone checkserver-side

Shopifyのチェックアウト検証とは、アプリがストアにインストールする、Cart and Checkout Validation APIのShopify Functionです。 カートやチェックアウトが変わるたびに、Shopifyが自社のサーバーでそれを実行します。Functionがエラーを返すと、チェックアウトにメッセージが表示され、購入者は問題を解消するまで注文を完了できません。通常のチェックアウト、Shop PayやApple Payなどのエクスプレスボタン、ヘッドレスのチェックアウト、下書き注文で実行され、公開アプリのものであればどのShopifyプランでも動作します。POS、サブスクリプションの更新、注文の編集、APIで作成された注文では実行されません。注文をブロックすることはできますが、カートを変更したり在庫を確保したりはできません。

最終確認日:2026年10月8日。Shopifyの開発者ドキュメントとヘルプセンターと照合しています。出典は末尾にあります。

開示:OrderRulesはチェックアウト検証アプリです。このガイドでは、まずShopifyのプラットフォームを説明し、その後で私たちの使い方を説明します。

標準チェックアウト、Shop Pay、Apple Pay、Google Pay、チェックアウト直リンク、ヘッドレスストアフロントにおける、チェックアウト検証とカートスクリプト型アプリの比較

検証Functionとは

Shopify Functionsを使うと、アプリはShopifyのバックエンドに独自のロジックを追加できます。Function APIはそれぞれ1つの役割を担います。ディスカウント、配送オプション、支払い方法などです。検証は、カートがチェックアウトに進めるかどうかを決めるAPIです。

仕組みは次のとおりです。

  1. アプリがFunctionを提供する。 FunctionはWebAssemblyにコンパイルされ、アプリと一緒にデプロイされます。あなたはアプリをインストールするだけで、コードには触れません。
  2. 実行するのはテーマではなくShopify。 Functionは買い物客のブラウザではなく、Shopifyのインフラの中で実行されます。JavaScriptをオフにしても、ページを書き換えても、スキップできません。
  3. 入力を読み、エラーを返す。 Shopifyがカートと関連データを渡します。Functionはエラーのリストを返し、各エラーにはメッセージと対象(カート全体、または特定のフィールド)があります。
  4. チェックアウトにメッセージが表示される。 リストが空ならチェックアウトは続行。エラーがあれば、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 App StoreからOrderRulesをインストールしてください。チェックアウト検証はすべてのプランに含まれ、有料プランには14日間の無料トライアルがあります。

よくある質問

Shopify FunctionsのAPIの一つ、Cart and Checkout Validation APIです。アプリが小さなFunctionをインストールし、カートやチェックアウトが変わるたびにShopifyが自社のサーバーでそれを実行します。Functionはエラーのリストを返します。リストが空でなければ、Shopifyがメッセージを表示し、問題が解消されるまで購入者はチェックアウトを完了できません。

いいえ。検証Functionを含むApp Storeの公開アプリは、どのプランのストアでも使えます。Shopify Plusが必要なのは、Functionsを使うカスタムアプリだけです。

はい。Shopifyはアクセラレーテッドチェックアウトを対応対象に挙げているため、Shop Pay、Apple Pay、Google Pay、PayPalのエクスプレスボタンでも同じFunctionが実行されます。ヘッドレス(Storefront API)のチェックアウト、B2Bのチェックアウト、下書き注文でも実行されます。

Shopifyは、POS、サブスクリプションの更新注文、注文の編集、Create Order APIで作成された注文、予約注文やお試し購入(try-before-you-buy)の購入オプションを非対応として挙げています。これらの経路の注文は、検証Functionではブロックされません。

いいえ。検証Functionが返せるのはエラーだけです。数量の変更、商品の削除、価格の編集はできません。購入者がメッセージを見て、自分でカートを直します。

それだけでは保証されません。公開アプリのFunctionはネットワーク通信ができないため、アプリはメタフィールドを通じて件数を渡し、Functionはそのスナップショットを読みます。在庫や枠を確保することはできないので、最後の1枠に対してほぼ同時に完了した2つのチェックアウトが、両方とも通ることがあります。

アプリを比較中ですか?

このカテゴリの他のShopifyアプリすべてとOrderRulesを比較してご覧ください。

注文管理を手中に収める準備はできていますか?

OrderRulesを無料で試す