Enabling Apple Pay on your Elements

To activate Apple Pay, you need a one-time configuration on your website. This allows Apple to verify that your domain is authorised to accept Apple Pay payments.

To do this, Apple requires a verification file to be accessible at a specific path on your domain. Rather than hosting the file yourself, you just need to set up a 301 redirect that points to our hosted verification file.

What needs to happen

Add a permanent redirect (HTTP 301) on your web server so that requests to:

/.well-known/apple-developer-merchantid-domain-association

are redirected to:

https://[subdomain].turneo.com/.well-known/apple-developer-merchantid-domain-association

Configuration examples

Pick the one that matches your setup:

Nginx

location = /.well-known/apple-developer-merchantid-domain-association {
    return 301 https://stripe.turneo.com/.well-known/apple-developer-merchantid-domain-association;
}

Next.js (next.config.js)

async redirects() {
  return [
    {
      source: '/.well-known/apple-developer-merchantid-domain-association',
      destination: 'https://stripe.turneo.com/.well-known/apple-developer-merchantid-domain-association',
      permanent: true,
    },
  ];
}

Apache (.htaccess)

Redirect 301 /.well-known/apple-developer-merchantid-domain-association https://stripe.turneo.com/.well-known/apple-developer-merchantid-domain-association

Cloudflare Pages (_redirects)

/.well-known/apple-developer-merchantid-domain-association https://stripe.turneo.com/.well-known/apple-developer-merchantid-domain-association 301

After adding the redirect

Verify the redirect works by visiting https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association in your browser — it should redirect to our verification file.

Once the domain is saved, Stripe will automatically verify it with Apple. No further action is needed.

This redirect is required by Apple for domain verification as part of the Apple Pay on the Web programme. The verification file is hosted and maintained by Turneo via Stripe — you don't need to create or update the file yourself. If you have any questions, reach out to our support team.