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

一部の決済手段において、システムで Elements または Checkout の埋め込み可能な支払いフォームを使用している場合は、決済手段を表示するウェブドメインをすべて登録する必要があります。この登録には、トップレベルドメインとサブドメインも含まれます。たとえば、ドメイン (yourdomain.com) とサブドメイン (shop.yourdomain.com、www.yourdomain.com など) がある場合、このガイドではそれらの登録方法について説明します。

ドメインを登録すると、そのドメインは、今後有効にする可能性のある他の支払い方法で使用できるようになります。

以下の支払い方法では登録が必要です。

• Google Pay
• Link
• PayPal
• Amazon Pay
• Klarna
• Apple Pay

テスト

また、テスト用のドメインを登録する必要もあります。ローカルでテストする場合は、ngrok などのツールを使用して HTTPS ドメインを取得できます。サンドボックスに登録するか、本番環境で登録すると自動的にサンドボックスにもドメインが登録されます。本番環境に移行する前に、必ず本番環境でドメインを登録してください。

curl https://api.stripe.com/v1/payment_method_domains \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d domain_name="example.com"

curl https://api.stripe.com/v1/payment_method_domains/{{PAYMENT_METHOD_DOMAIN_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d enabled=false

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

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

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

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

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

curl https://api.stripe.com/v1/payment_method_domains \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d domain_name="example.com"