To finish your configuration, you will only need to complete the iCloud account and domain registration steps below.

iCloud account setup

When testing, you will need to be logged into an iCloud account that corresponds to your environment. Testing in sandbox requires you to be logged into an iTunes Connect sandbox tester account, which you can create with an Apple Developer account. Similarly, you will need to be logged into a production iCloud account when testing in production.

Specify an icon

When using Apple Pay on the web, users will be presented with your site's apple-touch-icon, if present. It is recommended that you add an apple-touch-icon to your website if you do not already have one. Consult Apple's guidelines on configuring web applications for more information.

Domain registration

In order to test and accept Apple Pay on the web, you'll need to register any domains you plan to use with Apple. You can do this through the Braintree Control Panel using the instructions below, or via the API using Braintree::ApplePay.register_domain(). You should not register your domain through the Apple Developer Portal.

Sandbox environment

Register your sandbox domain name in the Braintree Control Panel:

  1. Log into your sandbox Control Panel
  2. Navigate to Settings > Processing > Apple Pay
  3. Click Options
  4. Under Web Domains, click Add a domain and enter your fully qualified sandbox domain name
    • If your domain begins with www., you may omit it (e.g. example.com will work with www.example.com and example.com)
  5. Click Agree & Add Domain

Production environment

Register your production domain name in the Braintree Control Panel:

  1. Log into your production Control Panel
  2. Navigate to Settings > Processing > Apple Pay
  3. Click Options
  4. Under Web Domains, click Add a domain and enter your fully qualified production domain name
    • If your domain begins with www., you may omit it (e.g. example.com will work with www.example.com and example.com)
  5. Download the domain association file and host it at /.well-known/apple-developer-merchantid-domain-association on your site
  6. Click Agree & Add Domain

Next: Client-side →

Still have questions?

If you can’t find an answer, contact our Support team.