Apple Pay via Braintree
Introduction
Braintree can process Apple Pay transactions. You can start accepting payments from your customers via Apple Pay with your existing Braintree accounts by simply adding Apple Pay as a payment option on the checkout page.
Make sure you have Apple Pay integrated with your Braintree account. Learn more.
Read more about setting up Apple Pay.
Note
- You can check out with Apple Pay only using Safari on macOS and iOS devices. Here is the complete list.
- Merchants using Braintree can accept Apple Pay from customers in the countries mentioned here.
- Only Apple Pay on the web is available.
- iframe tags and Chargebee's Rhapsody theme are not supported.
Prerequisites
- Ensure that your domain is registered with Braintree for Apple Pay before integrating Apple Pay.
Via Chargebee API
Click here to learn more about processing payments using Apple Pay via Chargebee API.
Via hosted pages
Step 1: Enable Apple Pay in Chargebee
Contact Chargebee Support with your merchant account info to enable Apple Pay.
Step 2: Enable Apple Pay as a payment method during checkout
Once enabled, you will see the option to enable Apple Pay in Chargebee's hosted pages.
After enabling in Chargebee, Apple Pay will be auto-enabled in your Braintree account and the site/domain name will be registered.
Step 3: Customize options for checkout
You can customize the contents shown in the Apple Pay payment sheet, which is similar to an invoice with details about your card, billing, shipping information, discounts, and taxes.
Business name
Provide a business name. Your customers will see this in the payment sheet. Here is a sample payment sheet shown below.
You can choose to retrieve the customer's billing address, shipping address, email, and phone from their Apple wallet to autofill the details in the checkout pages.
Once chosen, these fields become mandatory. The payment gateway configuration is now complete.
Frequently asked questions (FAQ)
1. Why is Apple Pay not available as a payment option if I have integrated Chargebee Checkout using the Drop-in Script?
Apple Pay is not supported with the Chargebee Drop-in Script because it uses iframes. Instead, Apple Pay is available only when using Chargebee Checkout via Checkout URL or API-based integration, which opens the checkout page in a separate tab or browser window.
Additionally, Apple Pay works only on iOS devices or when using the Safari browser on macOS. Ensure you are using one of these options during checkout. Apple Pay will not be available if you use a non-iOS device or a different browser.
2. What will happen if I add a new currency to my gateway account?
Contact Chargebee Support to update the currency configuration. Refer to this doc for more details.
3. What happens if I choose the billing/shipping address to be retrieved from the Apple Wallet but details are not present in the Apple Wallet?
The customer will be prompted to enter it during checkout and proceed.
4. Will changing my site's domain have any impact on enabling Apple Pay in Braintree?
Yes, since your site's URL is registered in Braintree, a change in the domain will impact the setup. Contact Chargebee Support in such cases to get the new domain registered.
5. I'm setting up a custom domain for checkout pages after setting up Apple Pay, what should I do?
Contact Chargebee Support to update the domain name in Braintree.
6. Where can I find Apple Pay's sandbox testing requirements?
Follow the instructions given here to test Apple Pay on your sandbox site.
7. Does Chargebee support MPAN tokens for Apple Pay via Braintree?
Yes. Chargebee supports MPAN tokens by default for Apple Pay on hosted checkout pages. If you are using a custom checkout with Chargebee's Apple Pay handler or Payment Components, pass the recurringPaymentRequest parameter to create MPAN tokens.
8. If I pass a recurring payment request object in Apple Pay, will Apple Pay always create an MPAN?
No. Passing a recurring payment request object does not guarantee that Apple Pay will always create an MPAN (Merchant Primary Account Number). MPAN availability depends on factors such as card network support, issuer support, and Apple Pay eligibility requirements.
The recurring payment request object only indicates that the payment is intended for recurring or merchant-initiated transactions. If MPAN is not possible, Apple Pay returns a DPAN (Device Primary Account Number) instead.
Was this article helpful?