支払い方法のためにドメインを登録する
Elements または Checkout の埋め込み可能な支払いフォームで決済手段 (Link、Apple Pay、Google Pay など) を使用するためのドメインを登録します。
For certain payment methods, you must register every web domain that shows the payment method if your integration uses Elements or Checkout’s embeddable payment form. This includes registering top-level domains and subdomains. For example, if you have the domain example.com and subdomains like shop.example.com and www.example.com, this guide explains how to register them.
ドメインを登録すると、そのドメインは、今後有効にする可能性のある他の支払い方法で使用できるようになります。
以下の支払い方法では登録が必要です。
Apple Pay と加盟店の検証
Apple Pay のドキュメントでは、「加盟店の検証」プロセスについて説明されていますが、これは Stripe がバックグラウンドで処理しているため、Apple Merchant ID や CSR を作成する必要はありません。代わりに、このガイドの次のステップを実行してください。
テスト
また、テスト用のドメインを登録する必要もあります。ローカルでテストする場合は、ngrok などのツールを使用して HTTPS ドメインを取得できます。サンドボックスに登録するか、本番環境で登録すると自動的にサンドボックスにもドメインが登録されます。本番環境に移行する前に、必ず本番環境でドメインを登録してください。
ダッシュボードの支払い方法のドメインページで、本番環境とテスト環境で使用するドメインを作成して管理することができます。
Connect を使用する
ダイレクト支払いを作成する Connect プラットフォームでは、連結アカウントのドメインを管理するために、ダッシュボードではなく API を使用する必要があります。
ドメインを登録する
ドメインを登録するには、以下のようにします。
- 支払い方法のドメインページで、新しいドメインを追加するをクリックします。
- ドメイン名を入力します。
- 保存して続けるをクリックします。
- (オプション) 登録する必要がある追加のドメインについて、手順 1 から 3 を繰り返します。
これらのステップを完了すると、「支払い方法のドメイン」ページにドメインが表示されます。
iframe を使用する
- Elements での iframe の使用 : iframe を使用する場合は、そのオリジンがトップレベルのオリジンと一致している必要があります (Safari 17 以降で
allow="payment"属性を指定する場合を除く)。プロトコル、ホスト (フルドメイン名)、ポート (指定されている場合) が 2 つのページで同一である場合、そのオリジンは同一です。 - トップレベルドメインと iframe ドメイン: トップレベルドメインが iframe のドメインと異なる場合、トップレベルドメインと iframe のソースドメインの両方が、関連アカウントに登録された支払い方法のドメインでなければなりません。
ドメインを管理する
すべてのドメインのリストをダッシュボードで表示できます。
ドメインを無効にするには、行アクションをクリックして、無効にするをクリックします。ドメインが無効になると、そのドメインの Elements や Checkout の埋め込み可能な決済フォームに支払い方法は表示されなくなります。
無効になっているドメインを有効にするには、行アクションをクリックして、有効にするをクリックします。
Connect の使用時にドメインを登録する
上記の支払い方法が Elements または Checkout の埋め込み可能な決済フォームに表示されるすべてのドメインを、Connect プラットフォームに登録する必要があります。支払いが実行中のドメインは、その支払いを実行しているユーザー用に登録する必要があります。
プラットフォームでダイレクト支払いを作成する場合、リクエストの認証にはプラットフォームのシークレットキーを使用し、Stripe-Account ヘッダーには連結アカウントの Stripe ID を設定します。
プラットフォームでデスティネーション支払いまたは支払いと送金別方式を作成する場合は、リクエストの認証にプラットフォームのシークレットキーを使用し、Stripe-Account ヘッダーを省略します。
連結アカウントに対する API コールの実行の詳細をご確認ください。