Apple Pay Settings
To access the Apple Pay Settings page, navigate to WooCommerce > Settings > Payments > Apple Pay (Stripe) by Payment Plugins in your WordPress admin dashboard, or visit:
https://your-site.com/wp-admin/admin.php?page=wc-settings&tab=checkout§ion=stripe_applepay
The Apple Pay Settings page is where you configure Apple Pay payments for your WooCommerce store through Stripe. Apple Pay provides customers with a fast, secure way to complete purchases using Touch ID, Face ID, or their device passcode, eliminating the need to manually enter payment and shipping information.
Here you'll set up Apple Pay's appearance across different sections of your store, customize button styles to match your brand, and configure how Apple Pay processes payments. The plugin provides a convenient "Register Domain" button that automates the domain registration process with Apple, making setup simple and straightforward.
Domain Registration
Before Apple Pay can be used on your store, your domain must be registered with Apple through Stripe. The plugin provides a convenient "Register Domain" button that handles this process automatically by adding the required domain association file to your server and completing the registration with Apple's systems.
If automatic registration fails due to file permissions, you'll need to manually download the apple-developer-merchantid-domain-association file from Stripe and place it in your site's .well-known directory, then register your domain in the Stripe Dashboard.
Important: Apple Pay will only display when testing with an actual iOS device that has payment methods saved in Apple Wallet. It will not appear in desktop browsers or simulators.
Enabled
Controls whether Apple Pay is available as a payment option on your store. When enabled, customers using compatible Apple devices will see Apple Pay buttons on the sections you've configured (product pages, cart, checkout, etc.). When disabled, Apple Pay will not appear anywhere on your store regardless of other settings.
Default: Disabled
General Settings
Title
The name that customers see for the Apple Pay payment method. This appears as the payment option label during checkout and helps customers understand they can pay using their Apple device's secure authentication. You can customize this to match your store's language or branding preferences.
Default: Apple Pay
The title of "Apple Pay" is displayed
Description
Additional text that appears below the Apple Pay payment method to provide customers with more information. This can include details about the security benefits of Apple Pay or instructions for first-time users. Leave this blank if you prefer a cleaner checkout experience without additional explanatory text.
Default: Empty (no description shown)
Show Payment Notice
When enabled, displays additional payment instructions in the payment method section of the checkout page. This notice helps educate customers about using Apple Pay and can improve conversion rates by addressing common questions or concerns about the payment method.
Default: Enabled
When enabled, the payment notice provided additional directions for the customer
Credit Card Display
Controls how Apple Pay transactions appear to customers on order confirmations, account pages, and subscription management. Since Apple Pay uses tokenized payments, this setting determines the format used to identify the underlying payment method for record-keeping and future reference.
Default: Type ending in (displays as "Visa ending in 1234")
Charge Type
Determines when customer funds are collected from their Apple Pay transaction. "Capture" immediately charges the customer when the order is placed, while "Authorize" only reserves the funds and requires manual capture later. Authorization is useful for custom products or when you need to verify inventory before charging customers.
Default: Capture
Payment Sections
Selects where Apple Pay buttons appear throughout your store. You can enable Apple Pay on product pages for quick single-item purchases, cart pages for express cart checkout, mini cart widgets for immediate purchase from any page, and express checkout banners for prominent placement on the checkout page. Multiple sections can be selected to maximize customer convenience.
Default: Product Page, Cart Page
If using the checkout block, make sure you enabled "Express Checkout" so that Apple Pay is available
Order Status
Sets the WooCommerce order status after successful Apple Pay payment processing. "Default" allows WooCommerce to automatically determine the appropriate status based on the products purchased (virtual/downloadable products become "Completed" while physical products become "Processing"). Custom statuses override this automatic behavior for specific business workflows.
Default: Default
Button Settings
Button Style
Controls the visual appearance of all Apple Pay buttons throughout your store. Black buttons work well on light backgrounds and provide high contrast, white buttons with black borders offer versatility across different background colors, and plain white buttons blend seamlessly with light-colored designs. Choose the style that best complements your site's overall design.
Default: Black Button
Default button style
White with black outline style
Button Design
Selects the corner styling for Apple Pay buttons. Standard buttons feature Apple's default corner radius for a classic appearance, while rounded buttons have more pronounced curved corners for a modern, softer look. This affects all Apple Pay buttons across your entire store.
Default: Standard
Rounded button example
Checkout Button Type
Determines the text and icon displayed on Apple Pay buttons specifically on the checkout page. "Standard Button" shows just the Apple Pay logo, "Buy with Apple Pay" includes purchase-focused text, and "Checkout with Apple Pay" emphasizes the checkout process. Choose the option that best matches your checkout page's flow and terminology.
Default: Standard Button
Buy with Apple Pay
Checkout with Apple Pay
Cart Button Type
Controls the text and icon displayed on Apple Pay buttons on cart pages and mini cart widgets. "Standard Button" shows just the Apple Pay logo, "Buy with Apple Pay" includes purchase-focused text, and "Checkout with Apple Pay" emphasizes moving to checkout. Consider your customers' expectations when they're viewing their cart contents.
Default: Standard Button
Product Button Type
Determines the text and icon displayed on Apple Pay buttons on individual product pages. "Standard Button" shows just the Apple Pay logo, "Buy with Apple Pay" encourages immediate purchase, and "Checkout with Apple Pay" suggests proceeding to checkout. Product pages typically benefit from more direct purchase language.
Default: Buy with Apple Pay
Troubleshooting
If Apple Pay is not appearing on your store, here are the most common issues and solutions:
Use an iOS Device with Safari Browser
Apple Pay will only display when viewed on an actual iOS device (iPhone or iPad) using the Safari browser. It will not appear on desktop computers, Android devices, or when using other browsers on iOS devices.
Valid Payment Method in Apple Wallet
Ensure the iOS device you're testing with has at least one valid payment method saved in Apple Wallet. This could be a credit card, debit card, or bank account that has been properly verified and added to the Wallet app.
Domain Registration Status
Verify that your domain registration with Apple was successful. You can check this by clicking the "Register Domain" button in the Apple Pay settings - if registration was successful, you should see a confirmation message.
Verify Domain Association File
For advanced troubleshooting, you can manually check that the Apple domain association file is properly accessible. Navigate to https://your-site.com/.well-known/apple-developer-merchantid-domain-association in your browser. The file should load and display text content similar to the following:
If the file doesn't load or shows an error, the most common cause is that your web server (like Nginx) isn't configured to serve the file as plain text. You may need to add configuration to your web server to properly serve files in the .well-known directory. For Nginx, you can add:
location /.well-known {
allow all;
default_type text/plain;
}
For more detailed information about domain registration issues, see these WordPress support threads: