Apple Pay

Apple Pay is a digital payment system developed by Apple. It allows users to make payments using their iOS and Mac devices using the Safari browser. With Apple Pay, users can link their credit cards, debit cards, and bank accounts for seamless transactions.
Add Apple Pay, all major credit and debit cards, customizable features, and risk management tools for transparent, secure transactions at competitive rates. Making it easy for you to do business, even if customers don’t have PayPal.

Apple Pay eligibility and signup

↑ Back to top

Apple Pay via PayPal Payments is available for merchants operating from the regions listed in the PayPal documentation. PayPal business accounts operating in these countries can sign up for Apple Pay.

When signing up for Apple Pay after the PayPal account has been connected to PayPal Payments, you may need to click the Check available features button for Apple Pay to become available.

Important

Any (sub)domain names that will show an Apple Pay button need to be registered (Live Domain Registration/Sandbox Domain Registration) in your sandbox and production PayPal account. The Apple Pay payment method won’t work if the domain isn’t registered.

To enable the Apple Pay button on your site, check Enable Apple Pay button and save the settings with “Save changes”. The Apple Pay button will automatically appear in all enabled Smart Button Locations below the PayPal button. The Apple Pay button will only be visible in the shop on supported devices with the Safari browser.

Note

While PayPal Payments cannot automatically register the domain for you, it automatically presents your domain association file (https://example.com/.well-known/apple-developer-merchantid-domain-association) once the Apple Pay feature is enabled, so Apple can validate the manually registered domain once the Apple Pay button is clicked in the shop.

Setup instructions

↑ Back to top

Follow these steps to sign up for Apple Pay and enable it in the PayPal Payments extension:

  1. Sign up for Apple Pay
  2. Navigate to the Overview tab scroll to Apple Pay and clickDomain Registration 
  3. Register the shop domain on the PayPal website;
    • If your website is available at https://example.com/, then you would need to register example.com on the PayPal website
    • If your website includes e.g. a www. subdomain, it must be included in the registration, like www.example.com.
  4. The Apple Pay button should now be functional and appear wherever the PayPal smart buttons are enabled
  5. To update the validation status notice in the plugin, click the Apple Pay button in the shop from a supported device

More details about the setup

Your domain must be registered on the PayPal website by clicking the “Manage Domain Registration” button.
The PayPal website may instruct you to download the apple-developer-merchantid-domain-association file and place it in the .well-known folder on your web server. This step can be skipped as PayPal Payments automatically presents the file in the right location to simplify the setup for you.

Apple presents the Apple Pay button only on eligible devices.

Testing instructions for Apple Pay (PayPal Sandbox)

↑ Back to top

Prerequisites:

  • (Sandbox) PayPal business account enabled for Apple Pay
  • Apple developer account for PayPal Sandbox testing
  • (Sandbox) Apple ID with a configured payment method/details
  • registered domain
  • the correct domain association file is presented

Steps to test Apple Pay (Sandbox/Live):

  • Ensure your testing device is logged into the right Apple ID
  • On your website, navigate to any page with the Apple Pay button, e.g. the single product page
  • Click on the Apple Pay button
  • In the Apple Pay payment sheet, select your payment method and confirm the payment
  • The payment should complete and redirect you to the order-received page

Apple Pay FAQ

↑ Back to top
I cannot enable the Apple Pay Button setting

Please ensure your PayPal account was signed up for Apple Pay (sandbox or live registration). For the most reliable feature availability, you may need to click the Check available features button for Apple Pay to become available. Alternatively, consider disconnecting your PayPal account and reconnecting it with the onboarding wizard.

The Apple Pay payment sheet is automatically closing

Your domain may not be registered for Apple Pay. Please refer to the links above to register your domain.

Can the Apple Pay button be shown in a separate gateway on the Checkout page?

Not yet. For now, the Apple Pay button is only available below the PayPal buttons and within the PayPal gateway. The development team is working to make separating all payment buttons into their gateway possible.

Do I need to manually upload the domain verification file to my server?

No. PayPal Payments automatically ensures that Apple is presented with the domain verification file from https://example.com/.well-known/apple-developer-merchantid-domain-association Please ensure that there is no validation file present from a third-party Apple Pay integration as these could result in Apple Pay payments via PayPal failing.