Stripe now requires a registered domain in order to use wallet payment methods on Stripe Elements or Checkout's embeddable payment form. This requirement enhances security and is in line with industry best practices.

You only need to register your domain once—we’ll automatically apply this domain to any wallet payment methods that you’re currently using as well as any that you might add in the future.

If you currently use Apple Pay, you likely have a registered domain that will be applied to your other wallet payment methods. However, if you wish to confirm this or add sub-domains, please follow the instructions below.

How to register your domain

You can register your domain now on the payment method domains page of your Stripe Dashboard, or using the API.

We encourage Platform users to review our docs and register domains for the platform or connected accounts via API. When a user runs a charge on a domain, the domain must be registered for that user-- whether that user is your platform or the Connected Account.

FAQ

Can I register more than one domain?

Yes, you need to register each domain and subdomain that you use via the Stripe Dashboard or via our API. For example if you have a domain such as yourdomain.com and subdomains such as shop.yourdomain.com and www.yourdomain.com, which all show Elements or Checkout's embeddable payment form, then all must be registered.

What domain do I need to register if I render Elements in 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 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.

How long does it take to register my domains?

This will depend on your integration. For most, registering your merchant or platform domain in the dashboard should take minutes. However, if you have Connected Accounts that need to be registered via API, the scope of the change may be larger and take a longer time.

Can I still use the Apple Pay API to register domains?

Yes, you will be able to continue to use the Apple Pay API to register domains, but deleting will no longer turn wallets off on that domain. To unregister a domain, you should disable the domain in the new Payment Method Domain API.