Apple Pay

Apple Pay appears as a one-tap button in checkout. That button renders on your store's own domain, so Apple requires your domain to serve a small verification file. Once the file is reachable, you verify your domain from your dashboard and Apple Pay switches on. This applies to every platform and every integration type, and each domain is verified on its own.

1. Get the verification file

In your dashboard, open your Integration settings and download the Apple Pay domain-association file. It is a single file named:

apple-developer-merchantid-domain-association

2. Serve the file on your domain

The file has to be publicly reachable over HTTPS at exactly this path on your store domain:

https://yourstore.com/.well-known/apple-developer-merchantid-domain-association

The path, filename, and casing must match exactly. There must be no login in front of it and no redirect that changes or drops the path. How you place the file there depends on your platform.

Shopify

Shopify does not let you serve files under /.well-known/, so you return the file another way on your own domain. Any method that serves the exact file at the exact path is fine, the only thing that matters is that the file is reachable.

For example, if your domain runs through Cloudflare, a small Cloudflare Worker can return the file. Set APPLE_FILE to the contents of the file you downloaded in step 1:

const APPLE_FILE = `paste the contents of the file you downloaded in step 1`;

export default {
  async fetch(request) {
    const url = new URL(request.url);
    if (
      url.pathname === "/.well-known/apple-developer-merchantid-domain-association"
    ) {
      return new Response(APPLE_FILE, {
        headers: { "content-type": "text/plain" },
      });
    }
    return fetch(request);
  },
};

Then add a Worker route so that path is handled by the Worker:

yourstore.com/.well-known/* -> the Worker above

This is just one option. Serving the file any other way that returns it at the exact path works too.

WooCommerce

WordPress does not create or serve a .well-known folder for you, and the admin has no way to add one, so you place the file yourself:

1. Using a file manager (for example, the WP File Manager plugin) or SFTP, create a folder named .well-known in your site root.
2. Upload the file into that folder, so it loads at the path above.

Some hosts and server configurations block folders that start with a dot. If the file still will not load after you upload it, ask your host to allow requests to /.well-known/, or use a WordPress plugin made to serve the Apple Pay domain-association file.

Custom store

Serve the file from a .well-known directory at your site root, so it loads at the path above over HTTPS.

3. Verify and enable

Back in your Integration settings, enter your store domain and choose Verify & enable. We fetch the file at the well-known path, confirm it is live, register your domain, and turn Apple Pay on, all on the same screen.

If verification fails

If it reports that the file could not be reached, open the URL in a browser and confirm it is:

• publicly accessible over HTTPS,
• served with no redirect that changes or drops the /.well-known/... path,
• not behind any login or password,
• an exact match on filename and casing.

Once the file loads cleanly, run Verify & enable again.