カスタム統合

開始するには、営業チームにお問い合わせいただき、アカウントを作成し契約に署名してください。契約に署名すると、アカウントに2件の少額入金が行われ、それらを確認する必要があります。

これらの少額入金額を、DashboardストアID（営業担当者をCCに含めて）とともに accounting@zonos.com にメールでお送りください。

確認が完了すると、銀行情報が Dashboard -> Settings -> Billing に表示されます。

Zonosアカウントを作成したら、Checkoutがストアで正しく動作するよう、Dashboardで設定を構成する必要があります。このセクションでは、Dashboardの必須設定をすべて説明します。

入金を設定

Checkoutからの入金をタイムリーに受け取るために、銀行口座を接続します。入金は、決済確定から2日以内の遅延で日次処理されます。手順は以下のとおりです：

1. Dashboard -> Settings -> Checkout settings に移動します。
2. Add bank account をクリックします。
3. Stripeポータルに移動し、セットアップを完了して以下の情報を提供します：
   • 銀行口座情報。
   • 会社のEIN。
   • 会社の25%以上の所有者のSocial Security Number。これが必要な理由の詳細については、Stripeのドキュメントをご覧ください。

Note: 入金スケジュールを更新する必要がある場合は、support@zonos.com までお問い合わせください。

許可ドメインを設定

Zonos JSスクリプトは、セキュリティ上の理由から許可ドメインのリストを必要とします。これにより、許可されていないサイトがスクリプトを読み込むことを防ぎ、承認されたドメインでのみ実行されることを保証します。この設定がない場合、スクリプトは権限エラーを返します。

設定手順：

1. Dashboard -> Settings -> Checkout settings に移動します。
2. URLs の下で、Checkoutを使用する完全なドメインとサブドメインを追加します。例えば、ドメインが example.com の場合、example.com と test.example.com を追加する必要があります。

ブランディング設定をカスタマイズ

Dashboardでブランディング設定を構成し、ストアのルックアンドフィールに合わせます。

手順は以下のとおりです：

1. Dashboard -> Settings -> Checkout settings -> Branding に移動します。
2. 以下の設定を構成します：
   • Logo。
   • Brand and accent color。
   • Theme、Style、Font。

ブランディング設定の詳細については、ドキュメントをご覧ください。

配送キャリアを接続

チェックアウト時に配送料を見積もるには、Zonosアカウントに配送キャリアを接続する必要があります。これにより、チェックアウト時に特定の配送サービスレベルを有効にできます。

配送キャリアを接続する手順：

1. Dashboard -> Settings -> Shipping -> Rates に移動します。
2. Add carrier をクリックします。
3. キャリアのセットアップ手順に従います。

キャリアアカウントの接続の詳細については、ドキュメントをご覧ください。

配送ゾーンを設定

配送ゾーンでは、世界のさまざまな地域で利用可能な配送キャリアとサービスレベルを構成できます。

配送ゾーンを設定する手順：

1. Dashboard -> Settings -> Shipping -> Locations に移動します。
2. New zone をクリックします。
3. ゾーン名を入力し、配送先とする国を選択します。
4. 提供するキャリアとサービスレベルを選択します。

配送ゾーンの詳細については、ドキュメントをご覧ください。

フォールバック原産国とHS codeを設定 

原産国とHS codeは、正確な関税と税金を計算するために使用されます。

特定の原産国またはHS codeを提供しない場合、Dashboardで設定したフォールバックが使用されます。

フォールバック原産国とHS codeを設定するには：

1. Dashboard -> Settings -> Shipping -> Catalog に移動します。
2. 原産国については、製品の大部分が製造されている国を選択します。
3. HS codeについては、最も一般的な製品のHS codeを入力します。HS codeがない場合は、Dashboardの Classify に移動し、製品名と説明を入力して正確なHS codeを生成します。

Zonos JSスニペットは、サイトでグローバルチェックアウト機能を有効にするクライアントサイドJavaScript統合です。eコマースプラットフォームとZonosサービス間のブリッジとして機能し、以下を処理します：

• Checkout Experience: チェックアウトUIをレンダリングし、決済を処理します。
• Location Services: 訪問者の所在地を検出し、通貨換算を管理します。
• Cart Integration: 既存のカートおよび注文システムと接続します。
• Security: ドメインを検証し、APIリクエストを認証します。

スニペットは非同期で読み込まれ、サイトのパフォーマンスへの影響を防ぎます。ストアのAPI認証情報で初期化され、すべてのクライアントサイドのやり取りを安全に処理します。実装は非侵入的に設計されており、既存のチェックアウトフローへの変更を最小限に抑えます。

以下は、Checkout統合時に参照できる、スクリプトの読み込み、初期化、イベント処理を含む完全な例です。

4. Checkout customHTML を通じて対応するIDを渡し、リレーがどのプロパティ/ピクセルに対して発行するかを認識させます：

iframeの手順、完全なイベントリファレンス（purchase / Purchase ペイロードマッピングを含む）、デバッグのヒントについては、以下をご覧ください：

• iframe Checkout向けGoogle Analytics 4
• iframe Checkout向けFacebook Pixel

システムとZonos Dashboard間で注文を同期するには、以下のAPI呼び出しとwebhookを実装します：

必須Mutation 

必須Webhook 

Checkout統合を本番公開する前に、スムーズな顧客体験を確保するため、統合のすべての側面を徹底的にテストすることが重要です。これには、チェックアウトフロー、決済処理、注文作成、webhook機能のテストが含まれます。

テストガイドに従って、統合が正しく動作していることを確認し、本番公開前に問題を特定して修正してください。

以下は、統合プロセスに関するよくある質問です。

Zonosは注文確認をどのように処理しますか？ 

Dashboard -> Settings -> Checkout settings の Success page type で購入後の体験を構成します。3つのオプションがあります：

• 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 をクエリパラメータとして付加します。独自の成功ページへの最速の引き渡しが必要な場合にこのオプションを使用します。

zonosCheckoutSessionId から注文を検索 

リダイレクトURL付きの Close the checkout modal を使用する場合、リダイレクト後にチェックアウトセッションに注文が紐付くまで数秒かかることがあります。URLから zonosCheckoutSessionId を読み取り、秘密の認証トークンを使用してサーバーから checkoutSession GraphQLクエリをポーリングし、注文の準備ができるまで待ちます。ブラウザからこれを呼び出さないでください — 秘密の認証トークンはサーバーサイドに留める必要があります。

Dashboard -> Settings -> Integrations から取得した秘密の認証トークンを credentialToken リクエストヘッダーとして渡し、クエリを https://api.zonos.com/graphql に送信します。

注文が作成されたときに通知を受け取れますか？

はい。注文が作成、発送、またはキャンセルされたときに通知を受け取りたい場合は、Checkout settings の Email セクションで、通知を受け取るチームメンバーのメールアドレスを入力できます。