支払い方法のためにドメインを登録する

支払い方法 (Link、Apple Pay、Google Pay など) を Elements または Checkout の埋め込み可能な決済フォームで使用するには、ドメインを登録して確認します。

実装で 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 を使用する必要があります。

ドメインを登録する

ドメインを登録するには、以下のようにします。

支払い方法のドメインページで、新しいドメインを追加するをクリックします。
ドメイン名を入力します。
保存して続けるをクリックします。
Apple Pay を設定している場合は、このページで後ほど説明する手順に従って、Apple でドメインの所有権を確認します。
(オプション) 登録する必要がある他のドメインについて、ステップ 1 ～ 4 を繰り返します。

これらのステップを完了すると、「支払い方法のドメイン」ページにドメインが表示されます。

iframe を使用する

Elements での iframe の使用 : iframe を使用する場合は、そのオリジンがトップレベルのオリジンと一致している必要があります (Safari 17 以降で allow="payment" 属性を指定する場合を除く)。プロトコル、ホスト (フルドメイン名)、ポート (指定されている場合) が 2 つのページで同一である場合、そのオリジンは同一です。
トップレベルドメインと iframe ドメイン: トップレベルドメインが iframe のドメインと異なる場合、トップレベルドメインと iframe のソースドメインの両方が、関連アカウントに登録された支払い方法のドメインでなければなりません。

Apple Pay でのドメインの所有権を確認する

登録中、Stripe は自動的に Apple Pay に登録されたドメインの所有権を確認しようとします。ドメインが確認されなかった場合、ご自身でドメインを登録し、以下の手順に沿って Apple Pay に登録されたドメインを確認します。

よくある間違い

Apple はお客様のドメインのアソシエーションファイルをリクエストしようとしているため、Apple のサーバーに公開されている必要があります。

ドメインアソシエーションファイルをダウンロードします。
このファイルを /.well-known/apple-developer-merchantid-domain-association でホストします。たとえば、https://yourdomain.com を登録する場合、https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association でこのファイルを入手できるようにします。
確認するをクリックします。

ドメインを管理する

すべてのドメインのリストをダッシュボードで表示できます。

ドメインを無効にするには、行アクションをクリックして、無効にするをクリックします。ドメインが無効になると、そのドメインの Elements や Checkout の埋め込み可能な決済フォームに支払い方法は表示されなくなります。

無効になっているドメインを有効にするには、行アクションをクリックして、有効にするをクリックします。

Connect の使用時にドメインを登録する

上記の支払い方法が Elements または Checkout の埋め込み可能な決済フォームに表示されるすべてのドメインを、Connect プラットフォームに登録する必要があります。支払いが実行中のドメインは、その支払いを実行しているユーザー用に登録する必要があります。

プラットフォームでダイレクト支払いを作成する場合、リクエストの認証にはプラットフォームのシークレットキーを使用し、Stripe-Account ヘッダーには連結アカウントの Stripe ID を設定します。

プラットフォームでデスティネーション支払いまたは支払いと送金別方式を作成する場合は、リクエストの認証にプラットフォームのシークレットキーを使用し、Stripe-Account ヘッダーを省略します。

連結アカウントに対する API コールの実行の詳細をご確認ください。