In order to start using Apple Pay on the Web each merchant domain and associated sub domains where the Apple Pay on the Web will be used need to be registered and validated with Apple.
The steps do to this are as follows:
- Download the domain association file for the environment you are setting up the domain for from the list below:
- Place the domain association file on your web server so that it is accessible in the following path:
For example, if your domain is
www.example.com you should be able to access the file at the following URL: https://www.example.com/.well-known/apple-developer-merchantid-domain-association
- Test the URL to ensure the association file is returned properly:
- Make an API request to the Gateway API to register this new domain:
This will trigger verification of your domain with Apple, and could take up to 45 seconds (in most cases this is completed very quickly).
More then one domain?
If you have more then one domain you can register them with multiple requests.
- Once this step is completed you can start accepting Apple Pay on the Web for the domains registered. You can now follow the Apple Pay on the Web documentation to implement the button on your website.
Security Configuration Requirements
Note: if you do not use HTTPS, your HTTPS configuration is not secure, or the domain association file cannot be accessed on your domains via HTTPS this step will fail and the status of the registration will be Error