Hi there,
Thanks for reaching out and for sharing the exact error message.
WooCommerce Square is looking for the Apple Pay domain verification file at:
/home/public/.well-known/apple-developer-merchantid-domain-association
If your host (NearlyFreeSpeech) is preventing WordPress/PHP from creating the .well-known directory automatically, you will likely need to create this directory and file manually in your site’s document root (the same place your main index.php and wp-config.php live), and ensure it is publicly accessible at:
https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
- Download the file from this link:
https://app.squareup.com/digital-wallets/apple-pay/apple-developer-merchantid-domain-association
- Upload the file to your site in the following location: /public_html/.well-known/apple-developer-merchantid-domain-association
- Make sure the folder
.well-known exists in your site’s root directory.
I hope this helps.
Thank you. I’ve done that and confirmed that the file is visible on the web. The error message went away for a few minutes, but then reappeared.
Hi @adamrice,
Thanks for confirming that and for testing it further, that detail about the message disappearing briefly is really helpful.
Since the file is correctly in place and accessible, but the error returned, this usually points to caching or an intermittent access issue rather than the setup itself. Could you please try the following:
• Clear any caching layers on your site, including plugin cache, server cache, or CDN if in use
• Open the verification file in an incognito window to confirm it loads consistently without redirects
• Double check that the .well-known directory and file have the correct permissions and remain publicly accessible
• Confirm with your host that there are no rules or restrictions affecting access to hidden directories like .well-known, as some hosts apply security policies to these paths
If the issue continues after these checks, it would be helpful to know if the file ever becomes temporarily inaccessible again, as that would point more strongly to a hosting level restriction.
You can also review the full setup guide here for reference:https://woocommerce.com/document/woocommerce-square/payment-settings/#setting-up-apple-pay.
Let us know how it goes, we’ll be here to help further.
Thanks. I’ve cleared the cache, and confirmed that the file is accessible in incognito mode (and in another browser). I’m not using a CDN. The error message is gone for now at least, and has stayed gone for a few minutes—I’ll keep an eye on it. I think it is too soon to say that this is resolved, but I hope it will be.
Hi @adamrice,
Thanks for the update and for taking the time to test this further, it is great to hear that the error message is no longer showing and that the verification file is accessible as expected.
Based on this, it does indicate that the setup is now working correctly and the issue has been resolved. Since the message briefly reappeared earlier, keeping an eye on it for a little while longer is a good call to ensure everything remains stable.
Feel free to monitor it over the next few hours, and if all looks good on your end, let us know and we can go ahead and mark the thread as resolved.
I’m happy we were able to work through that together — I know it took some patience on your end! If the solution is still holding up and you’d like to share your experience to help others in the community, you can leave a review here: https://ww.wp.xz.cn/plugins/woocommerce-square/#reviews
Feel free to open a new thread anytime if anything else comes up.
