WooCommerce Payments 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 WooCommerce Payments.
Apple Pay is only available for eligible devices with an active Apple Wallet.
Setup↑ Back to top
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.
Customizing↑ Back to top
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.
Purchasing↑ Back to top
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, WooCommerce Payments then processes the transaction and redirects the customer to the “Order Received” / “Thank you” page.
Product compatibility↑ Back to top
The express checkouts integration in WooCommerce Payments 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.
Testing Apple Pay↑ Back to top
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.
FAQ↑ Back to top
Can I authorize charges with Apple Pay and capture them later?↑ Back to top
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.
Can I issue refunds with Apple Pay?↑ Back to top
Yes. WooCommerce Payments 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.
Can I use Apple Pay for subscription products and Pre-Orders?↑ Back to top
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.
Is Apple Pay available in my country?↑ Back to top
Apple Pay is available for all countries supported by WooCommerce Payments.
Troubleshooting↑ Back to top
Before troubleshooting Apple Pay, ensure you have Log Error Messages enabled under Payments > Settings > Advanced settings. This lets you see any error messages from WooCommerce Payments under WooCommerce > Status > Logs, which could potentially be useful if you need to contact our support staff.
Apple Pay button does not appear↑ Back to top
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 WooCommerce Payments 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 WooCommerce Payments 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.
If you’ve ruled out all of those potential issues, that may mean that WooCommerce Payments was unable to verify your domain with Apple. See the section below for some background and potential fixes.
Domain registration↑ Back to top
In order for your store to accept Apple Pay transactions, WooCommerce Payments 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.
If WooCommerce Payments 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.
Apple Pay button does not appear at a specific location↑ Back to top
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.
Other issues↑ Back to top
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.