WooPayments provides your store with Apple Pay, which makes it easier for customers to checkout using Touch ID or Face ID on Apple devices. This document describes how to set up, test, and troubleshoot the Apple Pay feature in WooPayments.
Apple Pay is only available for eligible devices with an active Apple Wallet.
To enable Apple Pay:
- Go to Payments > Settings.
- In the Express Checkouts section, check the box for Apple Pay / Google Pay.
- At the bottom of the page, click Save Changes.
NOTE: There is no way to enable only Apple Pay without Google Pay. The two must be enabled together.
When Apple Pay is enabled, the Apple Pay button can appear in three places:
- On the Checkout page
- On the Cart page
- On individual product pages
You can customize which of these locations show the Apple Pay button by going to Payments > Settings and then clicking the Customize link for Apple Pay / Google Pay in the Express Checkouts section.
Once there, you can change where the Apple Pay button shows up, the text of the Apple Pay button itself, as well as the size and color scheme of the button.
By checking out with Apple Pay, customers don’t need to go through the regular checkout process and spend time filling in all of their information. Everything is handled using the Apple Pay interface, where customers can select their billing and shipping details, as well as which Apple Wallet card to use.
Once the transaction is authorized via Touch ID or Face ID, WooPayments then processes the transaction and redirects the customer to the “Order Received” / “Thank you” page.
The express checkouts integration in WooPayments is compatible with all of these product types:
- Simple products
- Variable products
- Subscription products
- Variable subscriptions
- Bookable products1
- Pre-order products
1 For bookable products, the Apple Pay button cannot be shown on the product page itself.
You can Apple Pay by making purchases in test mode using a real Apple ID with a real Apple Wallet card.
First, enable Test Mode by following the guide linked above. As long as you have Test Mode enabled under Payments > Settings, you can complete test transactions with a real card in your Apple Pay wallet without incurring any actual charges.
To set up Apple Pay on your device, you will need a supported card from a participating card issuer. See the full list of requirements for Apple Pay users for more information.
No, there is no way to completely disable card payments during checkout while still using WooPayments for accepting Apple Pay.
Yes. If you have checked the “Issue an authorization on checkout, and capture later” option in Payments > Settings, you can manually capture authorized charges done with Apple Pay, just like other credit card transactions.
Yes. WooPayments allows you to issue refunds for Apple Pay transactions just like normal transactions. This section of our Startup Guide shows how to refund a payment.
Yes. As long as you allow customers to create an account at checkout, and enable automatic generation of a username and password under WooCommerce > Settings > Accounts & Privacy, the Apple Pay button will be visible on the product page for subscription and pre-order products.
Apple Pay is available for all countries supported by WooPayments.
Before troubleshooting Apple Pay, ensure you have Log Error Messages enabled under Payments > Settings > Advanced settings. This lets you see any error messages from WooPayments under WooCommerce > Status > Logs, which could potentially be useful if you need to contact our support staff.
To ensure there isn’t a problem with your browser and device combination, try using the Apple Pay button on another website. You can try this demo, for example.
If Apple Pay does not appear there either, there is likely not an issue with WooPayments itself, bur rather something about your device or browser is not configured correctly.
If Apple Pay does appear on that demo, but not on your WooPayments store, this can happen for several reasons. To try to remedy the issue, please make sure:
- The Apple Pay / Google Pay setting is enabled under Payments > Settings.
- Your site is not in Dev Mode.
- Your site is served over HTTPS.
- You’re testing with an eligible device and that Apple Pay is enabled.
- “Allow customers to place orders without an account” is enabled under WooCommerce > Settings > Accounts & Privacy, OR “Allow customers to create an account during checkout” and “When creating an account, send the new user a link to set their password” are enabled.
NOTE: There’s also an ongoing bug where Apple Pay may not appear in the Safari browser unless you uncheck the “Allow websites to check for Apple Pay and Apple Card” setting under the Privacy tab of the Safari settings.
If you’ve ruled out all of those potential issues, that may mean that WooPayments was unable to verify your domain with Apple. See the section below for some background and potential fixes.
In order for your store to accept Apple Pay transactions, WooPayments automatically registers your domain as a verified Apple Pay merchant. Our plugin hosts the
apple-developer-merchantid-domain-association file under your domain root, for example:
Please check if this file is available from your own domain. If it’s not available, make sure you have your permalinks (under Settings > Permalinks) set to anything other than Plain. After you do that, trigger domain registration again per the steps below and test if the button appears afterward.
To trigger domain registration manually:
- Go to Payments > Settings.
- Uncheck the Apple Pay / Google Pay box in the Express Checkouts section.
- Scroll to the bottom and click Save Changes.
- Check the Apple Pay / Google Pay box in the Express Checkouts section.
- Scroll to the bottom and click Save Changes again.
If the button still does not show up, check the error logs under WooCommerce > Status > Logs and see if there are domain registration related errors. If you see an error, it may be that the
apple-developer-merchantid-domain-association file is not publicly available from your domain root.
In some cases this can be caused by security plugins,
.htaccess rules, or web application firewalls that are in place at the server level. You can speak with your host to check on these and be sure they’re not preventing the file from being publicly available.
If WooPayments cannot automatically write the file to your server, you can add it manually. First, download the here, then use FTP or SSH to upload it to the
.well-known directory on your server. The final location should be:
(You may need to create a
.well-known directory in the root directory of your site if none exists.)
Once uploaded, follow the above steps to trigger domain registration again and see if the button appears afterward.
If you don’t see any errors in the logs, but are still unable to see the Apple Pay button, try temporarily switching your theme to our free Storefront theme, and then opening a simple product page.
Contact support if you are stuck and cannot get Apple Pay to show with the above steps.
If the Apple Pay button is missing from only some locations, but not others (say, it appears on the Checkout page but not on the product page), this can happen for a number of different reasons:
- The product may not be compatible with express checkouts.
- Your theme may not support the necessary WooCommerce hooks, which are needed for Apple Pay to show up.
If you experience any other issues with Apple Pay, please take the following steps:
- Please enable logging under Payments > Settings > Advanced settings.
- Attempt an Apple Pay transaction and review the logs under WooCommerce > Status > Logs.
- If you see any errors, please get in touch with support and provide the logs for review.