Checkout domains are the domains that you've submitted for approval to serve Paddle Checkout for your account. Paddle reviews each domain before it can be used to load a checkout, so customers can only purchase from sites you control.
Checkout domain entities hold information like:
- The fully qualified domain name (FQDN), such as
example.com. - Whether a domain is approved, in review, or rejected.
- The Apple Pay verification status for the domain, returned under
payment_method_verification.apple_pay.
When you add a domain for live accounts, it's created as pending_review. Paddle reviews the domain and moves it to approved or rejected. Only approved domains can serve checkouts.
When you add a domain for sandbox accounts, it's created as approved. Domains in sandbox are automatically approved, and don't go through verification.
For checkouts that offer Apple Pay, the domain can also be verified with Apple. Before verifying, host the Apple Pay domain association file at /.well-known/apple-developer-merchantid-domain-association on your domain. Once a domain is approved, we attempt to automatically verify for Apple Pay.
You can't add a checkout domain using the API. To submit a new domain for approval, go to Paddle > Checkout > Website approval > Domain approval in your dashboard.