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

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

一部の決済手段において、システムで *Elements* (A set of UI components for building a web checkout flow. They adapt to your customer's locale, validate input, and use tokenization, keeping sensitive customer data from touching your server) または [Checkout の埋め込み可能な支払いフォーム](https://docs.stripe.com/payments/checkout/how-checkout-works.md?payment-ui=embedded-form)を使用している場合は、決済手段を表示するウェブドメインをすべて登録する必要があります。この登録には、トップレベルドメインとサブドメインも含まれます。たとえば、**example.com** というドメインと、**shop.example.com**、**www.example.com** のようなサブドメインを使用する場合の登録方法を、このガイドで説明します。

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

以下の決済手段のためにドメインを登録します。

- [Apple Pay](https://docs.stripe.com/apple-pay.md) (Required)
- [Amazon Pay](https://docs.stripe.com/payments/amazon-pay.md)
- [Google Pay](https://docs.stripe.com/google-pay.md)
- [Klarna](https://docs.stripe.com/payments/klarna.md)
- [Link](https://docs.stripe.com/payments/wallets/link.md)
- [PayPal](https://docs.stripe.com/payments/paypal.md)

> #### Apple Pay と加盟店の検証
> 
> Apple Pay のドキュメントでは、「加盟店の検証」プロセスについて説明されていますが、これは Stripe がバックグラウンドで処理しているため、Apple Merchant ID や CSR を作成する必要はありません。代わりに、このガイドの次のステップを実行してください。

## テスト

また、テスト用のドメインを登録する必要もあります。ローカルでテストする場合は、[ngrok](https://ngrok.com/) などのツールを使用して HTTPS ドメインを取得できます。*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)に登録するか、本番環境で登録すると自動的にサンドボックスにもドメインが登録されます。本番環境に移行する前に、必ず本番環境でドメインを登録してください。

# ダッシュボード

> This is a ダッシュボード for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/payments/payment-methods/pmd-registration?dashboard-or-api=dashboard.

ダッシュボードの[支払い方法のドメインページ](https://dashboard.stripe.com/settings/payment_method_domains)で、本番環境とテスト環境で使用するドメインを作成して管理することができます。

> #### Connect を使用する
> 
> ダイレクト支払いを作成する Connect プラットフォームでは、[連結アカウント](https://docs.stripe.com/payments/payment-methods/pmd-registration.md#register-a-domain-using-connect)のドメインを管理するために、ダッシュボードではなく API を使用する必要があります。

## ドメインを登録する

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

1. [支払い方法のドメインページ](https://dashboard.stripe.com/settings/payment_method_domains)で、**新しいドメインを追加する**をクリックします。
1. ドメイン名を入力します。
1. **保存して続ける**をクリックします。
1. (オプション) 登録する必要がある追加のドメインについて、手順 1 から 3 を繰り返します。

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

### iframe を使用する

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

## ドメインを管理する

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

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

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


# API

> This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/payments/payment-methods/pmd-registration?dashboard-or-api=api.

## ドメインを登録する

ドメインを登録するには、以下を実行します。

```curl
curl https://api.stripe.com/v1/payment_method_domains \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "domain_name=example.com"
```

登録する必要があるすべてのドメインについて繰り返します。

### iframe を使用する

- iframe を使用する場合は、そのオリジンがトップレベルのオリジンと一致している必要があります (Safari 17 以降を使用する場合を除く)。プロトコル、ホスト (フルドメイン名)、ポート (指定されている場合) が 2 つのページで同一である場合、そのオリジンは同一です。
- Safari 17 以降でクロスオリジンの iframe を使用する場合は、`allow=“payment”` 属性を指定する必要があります。Apple Pay を有効にするには、iframe が読み込むソースドメインも登録する必要があります。

## ドメインを管理する

[PaymentMethodDomain API](https://docs.stripe.com/api/payment_method_domains/object.md) を使用すると、以下を実行できます。

- ドメインを取得します。
- すべてのドメインのリストを表示します。
- ドメインを有効または無効にします。ドメインが無効になると、そのドメインの Elements や Checkout の埋め込み可能な決済フォームに支払い方法は表示されなくなります。

次のサンプルは、ドメインを無効にする方法を示しています。

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


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

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

プラットフォームで[ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)を作成する場合、リクエストの認証にはプラットフォームのシークレットキーを使用し、Stripe-Account ヘッダーには連結アカウントの Stripe ID を設定します。

プラットフォームで[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)または[支払いと送金別方式](https://docs.stripe.com/connect/separate-charges-and-transfers.md)を作成する場合は、リクエストの認証にプラットフォームのシークレットキーを使用し、Stripe-Account ヘッダーを省略します。

[連結アカウントに対する API コールの実行](https://docs.stripe.com/connect/authentication.md)の詳細をご確認ください。

```curl
curl https://api.stripe.com/v1/payment_method_domains \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "domain_name=example.com"
```