Braintree Apple Pay


In order to use Apple Pay the Multi-Gateway feature needs to be enabled for your site. Contact support to enable Multi-Gateway Feature.


Apple Pay is supported only on Apple devices. For more information about device requirements go to Braintree documentation.

Apple Pay is supported in these scenarios:

  • Creating a new subscription through Public Signup Pages Modern (v2) layout (PSP)
  • Updating a payment profile through Self Service Pages (SSP)
  • Paying an invoice online
  • Chargify.js, see Developer documentation for additional details on setup
We don't currently support Apple Pay on Sites that do not use Relationship Invoicing.



It is recommended that you first try Apple Pay in test environment. To setup your test environment, see the steps in the Testing Section.


In order to use Apple Pay as a payment method in Advanced Billing, you first have to enable Apple Pay support in your Braintree Panel.

The next step is to register your domains in Braintree Panel.

The first domain that you need to add is which is used for paying invoices online.

Next you have to add your site’s subdomain, because each time you create a site in Advanced Billing you must choose a unique subdomain for it.

For example, if you have chosen “test” as your subdomain, you would add “” to your Braintree Panel.

As per the step 9. in Braintree setup instruction, the file will already be available for you at the given path.

The above steps are necessary for Apple Pay to work correctly on PSP and SSP.


If you receive an error message like “Your browser or device does not support Apple Pay on the web. Open this page in Safari on a compatible device.” and you used an Apple Pay compatible device then you should check if you added the proper domains in the Braintree Panel.

If you added the proper domains and still receive this error message, check if you have credit cards configured in your Apple Wallet.

Before giving the option to pay with Apple Pay to your customers, it is recommended that you test a couple of transactions in your live environment. If you followed the above steps and still get errors, Braintree recommends contacting their support.



In order to test Apple Pay on your test site, you need to follow these steps:

  1. Contact support to enable both the Apple Pay and Multi-Gateway Feature on your site.

  2. Enable Apple Pay support in your Braintree Panel.

  3. Setup an Apple Pay Developer Account.

  4. Add domains to Braintree Panel - see Configuration step.

  5. Setup a device that supports Apple Pay payments with your Apple Pay Developer Account - see list of devices.

  6. Add the test cards to your Apple Pay Wallet - use one of the cards listed here.

  7. You can now test paying with Apple Pay.

Was this article helpful?
0 out of 0 found this helpful