Use Apple Pay with Braintree

Apple Pay in Maxio Advanced Billing allows Customers to complete Transactions securely using Apple Wallet across Public Signup Pages (PSP), Self-Service Pages (SSP), online Invoice payments, and Maxio.js (formerly Chargify.js) implementations. This article explains supported scenarios, configuration requirements, domain setup in the Braintree Control Panel, testing steps, and troubleshooting guidance.

Apple Pay is supported only on Apple devices. For device requirements and browser compatibility, see the Braintree documentation.

Apple Pay is supported in the following 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.

  

• Using Maxio.js, see the Developer documentation for implementation details.

Configuration

To configure Apple Pay in Advanced Billing:

1. Enable Apple Pay in your Braintree Control Panel.
2. Register your domains in the Braintree Control Panel.
3. Add the following domains:
   • chargifypay.com, used for paying Invoices online

   • Your Maxio site subdomain. Each site requires a unique subdomain.

     Example: If your subdomain is test, add test.chargifypay.com to your Braintree Control Panel.

4. If you use Maxio.js to host a checkout page on your own website, add your custom domain to the Braintree Control Panel.

5. If required by Braintree (see the Braintree setup instruction), host the domain association file at:

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

   This step is not required for chargifypay.com domains. Maxio hosts the required file automatically.

Testing

To test Apple Pay in your test environment:

1. Contact Maxio Support to enable Apple Pay and the Multi-Gateway feature for your site.
2. Enable Apple Pay in your Braintree Control Panel.
3. Set up an Apple Developer Account for Apple Pay.
4. Add the required domains in your Braintree Control Panel. See the Configuration section above.
5. Configure a compatible Apple device using your Apple Developer Account. See the list of supported devices.
6. Add Apple Pay test cards to your Apple Wallet using the cards listed in Apple’s sandbox testing documentation.
7. Complete a test Transaction using Apple Pay.

Troubleshoot Apple Pay Issues

Unsupported Device or Browser Error

If you receive the error message:

Your browser or device does not support Apple Pay on the web. Open this page in Safari on a compatible device.

On a supported Apple device, verify the following:

• All required domains are registered in your Braintree Control Panel.
• You are using Safari on a compatible Apple device.
• A valid credit card is configured in the Apple Wallet on the device.

Errors After Configuration

If you completed all configuration steps and Apple Pay still does not appear or fails during checkout:

• Confirm Apple Pay is enabled in your Braintree Control Panel.
• Confirm the Multi-Gateway feature is enabled for your site.
• Verify your domain association file is properly hosted if using a custom checkout domain.
• Test again using a supported device and browser combination.