# Register domains for payment methods

Register domains to use payment methods (including Link, Apple Pay, and Google Pay) in Elements or Checkout's embeddable payment form.

For certain payment methods, you must register every web domain that shows the payment method if your integration uses *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) or [Checkout’s embeddable payment form](https://docs.stripe.com/payments/checkout/how-checkout-works.md?payment-ui=embedded-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.

After you register a domain, that domain is ready for use with other payment methods that you might enable in the future.

Register your domains for the following payment methods:

- [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 and merchant validation
> 
> The Apple Pay documentation describes their process of “merchant validation," which Stripe handles for you behind the scenes. You don’t need to create an Apple Merchant ID or CSR. Instead, follow the steps in this guide.

## Testing

You also need to register domains for testing. When testing locally, you can use a tool such as [ngrok](https://ngrok.com/) to get an HTTPS domain. You can either register in a *sandbox* (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), or register in live mode and the domain will also be registered in sandboxes automatically. Remember to register your domains in live mode before going live.

# Dashboard

> This is a Dashboard 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.

You can create and manage domains in the Dashboard on the [Payment method domains page](https://dashboard.stripe.com/settings/payment_method_domains) for use in production and testing.

> #### Using Connect
> 
> Connect platforms that create direct charges must use the API to manage domains for their [connected accounts](https://docs.stripe.com/payments/payment-methods/pmd-registration.md#register-a-domain-using-connect), not the Stripe Dashboard.

## Register your domain

To register a domain:

1. On the [Payment method domains page](https://dashboard.stripe.com/settings/payment_method_domains), click **Add a new domain**.
1. Enter your domain name.
1. Click **Save and continue**.
1. (Optional) Repeat steps 1-3 for additional domains that you need to register.

After completing these steps, your domain shows up on the Payment method domains page.

### Using an iframe

- **Using an iframe with [Elements](https://docs.stripe.com/payments/elements.md)**: When using an iframe, its origin must match the top-level origin (except for Safari 17+ when specifying `allow="payment"` attribute). Two pages have the same origin if the protocol, host (full domain name), and port (if specified) are the same for both pages.
- **Top-level domain and iframe domain**: If the top-level domain differs from the iframe domain, the top-level domain and the iframe’s source domain must both be registered payment method domains on the associated account.

## Manage your domain

You can see a list of all of your domains in the Dashboard.

To disable a domain, click the row action and then click **Disable**. If a domain is disabled, the payment methods no longer appear in Elements or Checkout’s embeddable payment form on that domain.

To enable a disabled domain, click the row action and then click **Enable**.


# 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.

## Register your domain

To register a domain, do the following:

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

```cli
stripe payment_method_domains create  \
  --domain-name="example.com"
```

```ruby
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

payment_method_domain = client.v1.payment_method_domains.create({
  domain_name: 'example.com',
})
```

```python
client = StripeClient("<<YOUR_SECRET_KEY>>")

payment_method_domain = client.v1.payment_method_domains.create({
  "domain_name": "example.com",
})
```

```php
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$paymentMethodDomain = $stripe->paymentMethodDomains->create([
  'domain_name' => 'example.com',
]);
```

```java
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

PaymentMethodDomainCreateParams params =
  PaymentMethodDomainCreateParams.builder().setDomainName("example.com").build();

PaymentMethodDomain paymentMethodDomain =
  client.v1().paymentMethodDomains().create(params);
```

```node
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const paymentMethodDomain = await stripe.paymentMethodDomains.create({
  domain_name: 'example.com',
});
```

```go
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.PaymentMethodDomainCreateParams{
  DomainName: stripe.String("example.com"),
}
result, err := sc.V1PaymentMethodDomains.Create(context.TODO(), params)
```

```dotnet
var options = new PaymentMethodDomainCreateOptions { DomainName = "example.com" };
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.PaymentMethodDomains;
PaymentMethodDomain paymentMethodDomain = service.Create(options);
```

Repeat for all domains that you need to register.

### Using an iframe

- When using an iframe, its origin must match the top-level origin, except in Safari 17+. Two pages have the same origin if the protocol, host (full domain name), and port (if specified) are the same for both pages.
- When using a cross-origin iframe in Safari 17+ you must specify the `allow=“payment”` attribute. To enable Apple Pay, you must also register the source domain that the iframe loads.

## Manage your domain

Using the [PaymentMethodDomain API](https://docs.stripe.com/api/payment_method_domains/object.md) you can do the following:

- Retrieve a domain.
- See a list of all of your domains.
- Enable or disable a domain. If a domain is disabled, the payment methods no longer appear in Elements or Checkout’s embeddable payment form on that domain.

This sample shows how to disable a domain:

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

```cli
stripe payment_method_domains update {{PAYMENT_METHOD_DOMAIN_ID}} \
  --enabled=false
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

payment_method_domain = client.v1.payment_method_domains.update(
  '{{PAYMENT_METHOD_DOMAIN_ID}}',
  {enabled: false},
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = StripeClient("<<YOUR_SECRET_KEY>>")

# For SDK versions 12.4.0 or lower, remove '.v1' from the following line.
payment_method_domain = client.v1.payment_method_domains.update(
  "{{PAYMENT_METHOD_DOMAIN_ID}}",
  {"enabled": False},
)
```

```php
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$paymentMethodDomain = $stripe->paymentMethodDomains->update(
  '{{PAYMENT_METHOD_DOMAIN_ID}}',
  ['enabled' => false]
);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

PaymentMethodDomainUpdateParams params =
  PaymentMethodDomainUpdateParams.builder().setEnabled(false).build();

// For SDK versions 29.4.0 or lower, remove '.v1()' from the following line.
PaymentMethodDomain paymentMethodDomain =
  client.v1().paymentMethodDomains().update("{{PAYMENT_METHOD_DOMAIN_ID}}", params);
```

```node
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const paymentMethodDomain = await stripe.paymentMethodDomains.update(
  '{{PAYMENT_METHOD_DOMAIN_ID}}',
  {
    enabled: false,
  }
);
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.PaymentMethodDomainUpdateParams{Enabled: stripe.Bool(false)}
result, err := sc.V1PaymentMethodDomains.Update(
  context.TODO(), "{{PAYMENT_METHOD_DOMAIN_ID}}", params)
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
var options = new PaymentMethodDomainUpdateOptions { Enabled = false };
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.PaymentMethodDomains;
PaymentMethodDomain paymentMethodDomain = service.Update(
    "{{PAYMENT_METHOD_DOMAIN_ID}}",
    options);
```


## Register your domain while using Connect

Connect platforms must register all domains where Elements or Checkout’s embeddable payment form displays the payment methods listed above. The domain where the charge is being run needs to be registered for the user running the charge.

If the platform creates [direct charges](https://docs.stripe.com/connect/direct-charges.md), use your platform’s secret key to authenticate the request and set the Stripe-Account header to your connected account’s Stripe ID.

If the platform creates [destination charges](https://docs.stripe.com/connect/destination-charges.md) or [separate charges and transfers](https://docs.stripe.com/connect/separate-charges-and-transfers.md), use your platform’s secret key to authenticate the request and omit the Stripe-Account header.

Learn more about [Making API calls for connected accounts](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"
```

```cli
stripe payment_method_domains create  \
  --stripe-account {{CONNECTEDACCOUNT_ID}} \
  --domain-name="example.com"
```

```ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = Stripe::StripeClient.new("<<YOUR_SECRET_KEY>>")

payment_method_domain = client.v1.payment_method_domains.create(
  {domain_name: 'example.com'},
  {stripe_account: '{{CONNECTEDACCOUNT_ID}}'},
)
```

```python
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
client = StripeClient("<<YOUR_SECRET_KEY>>")

# For SDK versions 12.4.0 or lower, remove '.v1' from the following line.
payment_method_domain = client.v1.payment_method_domains.create(
  {"domain_name": "example.com"},
  {"stripe_account": "{{CONNECTEDACCOUNT_ID}}"},
)
```

```php
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('<<YOUR_SECRET_KEY>>');

$paymentMethodDomain = $stripe->paymentMethodDomains->create(
  ['domain_name' => 'example.com'],
  ['stripe_account' => '{{CONNECTEDACCOUNT_ID}}']
);
```

```java
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
StripeClient client = new StripeClient("<<YOUR_SECRET_KEY>>");

PaymentMethodDomainCreateParams params =
  PaymentMethodDomainCreateParams.builder().setDomainName("example.com").build();

RequestOptions requestOptions =
  RequestOptions.builder().setStripeAccount("{{CONNECTEDACCOUNT_ID}}").build();
// For SDK versions 29.4.0 or lower, remove '.v1()' from the following line.

PaymentMethodDomain paymentMethodDomain =
  client.v1().paymentMethodDomains().create(params, requestOptions);
```

```node
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('<<YOUR_SECRET_KEY>>');

const paymentMethodDomain = await stripe.paymentMethodDomains.create(
  {
    domain_name: 'example.com',
  },
  {
    stripeAccount: '{{CONNECTEDACCOUNT_ID}}',
  }
);
```

```go
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
sc := stripe.NewClient("<<YOUR_SECRET_KEY>>")
params := &stripe.PaymentMethodDomainCreateParams{
  DomainName: stripe.String("example.com"),
}
params.SetStripeAccount("{{CONNECTEDACCOUNT_ID}}")
result, err := sc.V1PaymentMethodDomains.Create(context.TODO(), params)
```

```dotnet
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
var options = new PaymentMethodDomainCreateOptions { DomainName = "example.com" };
var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTEDACCOUNT_ID}}",
};
var client = new StripeClient("<<YOUR_SECRET_KEY>>");
var service = client.V1.PaymentMethodDomains;
PaymentMethodDomain paymentMethodDomain = service.Create(options, requestOptions);
```