支払い方法のためにドメインを登録する
Elements または Checkout の埋め込み可能な支払いフォームで決済手段 (Link、Apple Pay、Google Pay など) を使用するためのドメインを登録します。
実装で Elements または Checkout のオンライン決済フォームを使用している場合、特定の決済手段では、決済手段を表示するウェブドメインをそれぞれ登録する必要があります。これには、最上位のドメインとサブドメインの登録が含まれます。たとえば、yourdomain.com というドメインと、shop.yourdomain.com、www.yourdomain.com のようなサブドメインを使用する場合の登録方法を、このガイドで説明します。
ドメインを登録すると、そのドメインは、今後有効にする可能性のある他の支払い方法で使用できるようになります。
以下の支払い方法では登録が必要です。
- Google Pay
- Link
- PayPal
- Amazon Pay
- Apple Pay
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 コールの実行の詳細をご確認ください。