For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Apple Pay domain verification failed

The Apple Pay domain association file may be missing, incorrectly configured, or returning an error.

Example response
{
"error": {
"type": "request_error",
"code": "checkout_domain_apple_pay_domain_verification_failed",
"detail": "Domain verification failed. Make sure the Apple Pay domain association file is publicly accessible at the top-level of your domain, and returns at 200.",
"documentation_url": "https://developer.paddle.com/errors/checkout_domains/checkout_domain_apple_pay_domain_verification_failed"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
checkout_domain_apple_pay_domain_verification_failed
Error message
Domain verification failed. Make sure the Apple Pay domain association file is publicly accessible at the top-level of your domain, and returns at 200.

Common causes

  • The domain association file isn't hosted at the correct URL.
  • The file returns a non-200 status (e.g. 404, 500).
  • The request to the file is redirected to another URL.
  • The file isn't accessible to the Apple Pay servers.

Troubleshooting

  • Download the Apple Pay domain association file from the developer docs and upload it to your web server.
  • Check that your file is served at /.well-known/apple-developer-merchantid-domain-association. For example, if your website is example.com, make the file available at https://example.com/.well-known/apple-developer-merchantid-domain-association.
  • Make sure your domain isn't behind a proxy or redirect, and it's publicly available to the Apple Pay servers.

Was this page helpful?