Woocommerce集成Square后Apple Pay无法使用的排查求助

1. 确认Square账户端的域名验证状态 #

• 让客户登录Square后台，进入支付设置 > Apple Pay页面，核对当前商店的完整域名（包括www和非www版本，比如yourstore.com和www.yourstore.com）是否显示「已验证」状态。
• 提醒客户手动重新添加一次商店域名——有时候自动验证流程没触发，手动操作会弹出验证文件下载或DNS配置提示，这可能是客户之前没注意到的环节。
• 确认Square账户所在地区支持Apple Pay，部分地区暂未开放该功能。

2. 检查站点HTTPS与SSL证书 #

• Apple Pay强制要求站点使用受信任的正规SSL证书，不能是自签证书，且证书需覆盖当前使用的所有域名变体（比如同时支持www和非www）。
• 用Safari访问站点，点击地址栏锁图标查看证书详情，确认无警告信息；同时检查控制台（开发者工具里的Console标签）是否有混合内容报错（HTTP资源混入HTTPS站点会导致Apple Pay失效）。
• 确保HTTP版本的站点会自动跳转到HTTPS，避免域名访问不一致的问题。

3. 排查Square插件与缓存问题 #

• 进入WordPress后台的WooCommerce > 设置 > 支付 > Square，确认「Apple Pay」选项已勾选启用，且支付区域设置与客户Square账户的地区匹配。
• 清空所有缓存：包括WordPress插件缓存、服务器缓存、CDN缓存——Apple Pay的状态经常会被缓存，导致按钮显示异常。
• 临时禁用其他可能冲突的插件：尤其是安全类、缓存类、其他支付类插件，这类插件可能拦截Square的验证请求或干扰Apple Pay的渲染逻辑。

4. 手动验证域名验证文件 #

• 检查站点根目录下的.well-known文件夹是否存在apple-developer-merchantid-domain-association文件，访问https://yourstore.com/.well-known/apple-developer-merchantid-domain-association确认文件可正常访问（内容是一串无格式字符串）。
• 如果文件不存在，让客户在Square后台重新触发域名验证流程，获取该文件后上传到.well-known目录（没有这个目录就手动创建，权限设为755）。

5. 检查测试设备与浏览器设置 #

• 确认测试用的Safari是最新版本，测试设备（Mac/iPhone）已登录绑定有效银行卡的Apple ID——Apple Pay需要设备先绑定银行卡才能触发按钮交互。
• 打开Safari开发者工具的Console标签，查看是否有ApplePaySession相关的报错信息，这类前端日志往往比插件后台日志更详细。
• 换一台Apple设备测试，比如用iPhone上的Safari访问站点，排除单设备的设置问题。

6. 联系官方支持 #

• 让客户直接联系Square官方技术支持，提供商店域名和Square账户信息，请求检查Apple Pay的域名验证状态——只有账户持有者才能发起这类查询。
• 将Square for WooCommerce插件更新到最新版本，旧版本可能存在日志不记录Apple Pay相关信息的bug。

内容的提问来源于stack exchange，提问作者CraigD