Show Zonos success page（デフォルト、推奨）— 注文が確定した後、Zonosが組み込みのサンキューページを表示します。注文がシステムにインポートできなかった場合でも、ページは常に表示されるため、買い物客は必ず確認を受け取れます。
Redirect to a success page — Zonosは注文が作成されるまで短い「Order complete」画面で待機し、その後、設定した成功URLに zOrderNumber（レガシーカートの場合は orderId）をクエリパラメータとして付加してリダイレクトします。
Close the checkout modal — 決済が確定すると、Zonosはモーダルを閉じます。成功URLも構成している場合、ZonosはStripeが決済を回収した直後に注文の作成を待たずにそのURLにリダイレクトし、zonosCheckoutSessionId をクエリパラメータとして付加します。独自の成功ページへの最速の引き渡しが必要な場合にこのオプションを使用します。
カスタム統合
カスタム統合
カスタムサイト向けにエンドツーエンドのCheckout統合を構築します。
統合チェックリスト
この包括的なチェックリストに従って、Zonos Dashboardアカウントを設定し、Zonos Checkoutをカスタムサイトまたはプラットフォームに統合します。
Zonosアカウントを作成
開始するには、営業チームにお問い合わせいただき、アカウントを作成し契約に署名してください。契約に署名すると、アカウントに2件の少額入金が行われ、それらを確認する必要があります。
これらの少額入金額を、DashboardストアID（営業担当者をCCに含めて）とともに accounting@zonos.com にメールでお送りください。
確認が完了すると、銀行情報が Dashboard -> Settings -> Billing に表示されます。
DashboardとCheckout設定を構成
Zonosアカウントを作成したら、Checkoutがストアで正しく動作するよう、Dashboardで設定を構成する必要があります。このセクションでは、Dashboardの必須設定をすべて説明します。
入金を設定
Checkoutからの入金をタイムリーに受け取るために、銀行口座を接続します。入金は、決済確定から2日以内の遅延で日次処理されます。手順は以下のとおりです：
許可ドメインを設定
Zonos JSスクリプトは、セキュリティ上の理由から許可ドメインのリストを必要とします。これにより、許可されていないサイトがスクリプトを読み込むことを防ぎ、承認されたドメインでのみ実行されることを保証します。この設定がない場合、スクリプトは権限エラーを返します。
設定手順：
example.comの場合、example.comとtest.example.comを追加する必要があります。ブランディング設定をカスタマイズ
Dashboardでブランディング設定を構成し、ストアのルックアンドフィールに合わせます。
手順は以下のとおりです：
ブランディング設定の詳細については、ドキュメントをご覧ください。
配送キャリアを接続
チェックアウト時に配送料を見積もるには、Zonosアカウントに配送キャリアを接続する必要があります。これにより、チェックアウト時に特定の配送サービスレベルを有効にできます。
配送キャリアを接続する手順：
キャリアアカウントの接続の詳細については、ドキュメントをご覧ください。
配送ゾーンを設定
配送ゾーンでは、世界のさまざまな地域で利用可能な配送キャリアとサービスレベルを構成できます。
配送ゾーンを設定する手順：
配送ゾーンの詳細については、ドキュメントをご覧ください。
フォールバック原産国とHS codeを設定
原産国とHS codeは、正確な関税と税金を計算するために使用されます。
特定の原産国またはHS codeを提供しない場合、Dashboardで設定したフォールバックが使用されます。
フォールバック原産国とHS codeを設定するには：
Zonos JSスニペットをインストール
Zonos JSスニペットは、サイトでグローバルチェックアウト機能を有効にするクライアントサイドJavaScript統合です。eコマースプラットフォームとZonosサービス間のブリッジとして機能し、以下を処理します：
スニペットは非同期で読み込まれ、サイトのパフォーマンスへの影響を防ぎます。ストアのAPI認証情報で初期化され、すべてのクライアントサイドのやり取りを安全に処理します。実装は非侵入的に設計されており、既存のチェックアウトフローへの変更を最小限に抑えます。
以下は、Checkout統合時に参照できる、スクリプトの読み込み、初期化、イベント処理を含む完全な例です。
customHTMLを通じて対応するIDを渡し、リレーがどのプロパティ/ピクセルに対して発行するかを認識させます：iframeの手順、完全なイベントリファレンス（
purchase/Purchaseペイロードマッピングを含む）、デバッグのヒントについては、以下をご覧ください：注文追跡とステータスをDashboardに同期
システムとZonos Dashboard間で注文を同期するには、以下のAPI呼び出しとwebhookを実装します：
必須Mutation
orderUpdateAccountOrderNumberorderAddTrackingNumber必須Webhook
ORDER_CREATEDORDER_STATUS_CHANGED統合をテスト
Checkout統合を本番公開する前に、スムーズな顧客体験を確保するため、統合のすべての側面を徹底的にテストすることが重要です。これには、チェックアウトフロー、決済処理、注文作成、webhook機能のテストが含まれます。
テストガイドに従って、統合が正しく動作していることを確認し、本番公開前に問題を特定して修正してください。
よくある質問
以下は、統合プロセスに関するよくある質問です。
Zonosは注文確認をどのように処理しますか？
Dashboard -> Settings -> Checkout settings の Success page type で購入後の体験を構成します。3つのオプションがあります：
zOrderNumber（レガシーカートの場合はorderId）をクエリパラメータとして付加してリダイレクトします。zonosCheckoutSessionIdをクエリパラメータとして付加します。独自の成功ページへの最速の引き渡しが必要な場合にこのオプションを使用します。zonosCheckoutSessionIdから注文を検索リダイレクトURL付きの Close the checkout modal を使用する場合、リダイレクト後にチェックアウトセッションに注文が紐付くまで数秒かかることがあります。URLから
zonosCheckoutSessionIdを読み取り、秘密の認証トークンを使用してサーバーからcheckoutSessionGraphQLクエリをポーリングし、注文の準備ができるまで待ちます。ブラウザからこれを呼び出さないでください — 秘密の認証トークンはサーバーサイドに留める必要があります。query getCheckoutSession($id: String!) {checkoutSession(id: $id) {order {id}}}Dashboard -> Settings -> Integrations から取得した秘密の認証トークンを
credentialTokenリクエストヘッダーとして渡し、クエリをhttps://api.zonos.com/graphqlに送信します。注文が作成されたときに通知を受け取れますか？
はい。注文が作成、発送、またはキャンセルされたときに通知を受け取りたい場合は、Checkout settings の Email セクションで、通知を受け取るチームメンバーのメールアドレスを入力できます。
このページは役に立ちましたか？