WooPayments 无法连接？最全错误代码与快速修复指南！

很多卖家在初次配置 WooPayments 时都会遇到连接失败、账户验证错误或 API 授权异常等问题。本文将会详细介绍 WooPayments 无法连接的常见原因、对应错误代码的含义，以及最有效的解决方法，帮助你快速恢复支付功能。

一、为什么 WooPayments 会无法连接？

WooPayments 是 WooCommerce 官方推出的一体化支付解决方案，基于 Stripe 技术构建，支持全球多种货币与支付方式。但由于它涉及银行账户、API 授权和身份验证等环节，连接过程中容易出现以下几类问题：

账户信息不匹配：店铺信息与 WooPayments 注册资料不一致。
地区或货币限制：WooPayments 尚未支持你的注册国家或结算币种。
API 授权异常：WooCommerce 与 WooPayments 的连接令牌失效或未正确生成。
服务器 SSL 或防火墙问题：网站未使用 HTTPS，或防火墙阻止外部通信。
插件冲突：部分安全插件或缓存插件会干扰 WooPayments 的 API 调用。

了解问题类型之后，我们可以根据具体错误代码对症下药。

二、常见错误代码与含义

以下是 WooPayments 中最常见的几类错误提示及解释：

1. Error: Could not connect to WooPayments

含义： WooPayments 无法验证网站身份或建立安全连接。
原因： 网站 SSL 证书无效、主机禁用外部请求、或服务器防火墙阻断 WooPayments API。

解决方案：

确认你的网站已启用 HTTPS 并安装有效的 SSL 证书。
在主机控制面板中开启外部 HTTP 请求权限。
临时关闭安全插件（如 Wordfence、Sucuri）测试是否为防火墙限制。

2. Error: Your account is not eligible for WooPayments

含义： WooPayments 暂不支持你所在国家或使用的结算币种。
解决方案：

若你的国家尚未开放，可以临时选择 Stripe 或 PayPal 替代方案。
使用 VPN 或代理并不能解决此问题，WooPayments 依然会根据身份证明验证所在地。

3. Error: Verification failed – Identity document rejected

含义： 身份验证未通过，上传的身份证件或营业执照不符合要求。

解决方案：

上传高清、无遮挡的证件扫描件。
确保姓名、地址、公司信息与 WooCommerce 店铺设置一致。
若资料真实但仍被拒，可通过 Woo 支持中心提交人工审核。

4. Error: API keys invalid or expired

含义： WooPayments 与 WooCommerce 之间的 API 授权令牌失效。
原因： 网站迁移、缓存清理或插件重装后未重新授权。
解决方案：

前往 WooCommerce → 设置 → 付款 → WooPayments，点击“重新连接账户”。

若仍失败，登录 WooCommerce.com 账户，在“我的账户 → 连接服务”中手动解除并重新授权。

5. Error: Pending verification

含义： WooPayments 账户正在审核中，暂未完成身份验证。

解决方案：

登录 WooPayments 仪表板查看“需要操作”的项目。
上传缺失的文件后通常会在 24-48 小时内审核完成。
审核期间网站仍可运行，但交易会被暂时冻结。

6. Error: Something went wrong during onboarding

含义： WooPayments 注册流程中发生未知错误，通常与浏览器或插件冲突有关。
解决方案：

尝试在隐身模式下重新登录并连接。
清除浏览器缓存或更换浏览器（建议使用 Chrome 或 Firefox 最新版本）。
禁用所有非必要插件后重试。

三、网站配置问题导致的连接失败

除了系统错误外，许多 WooPayments 无法连接的问题来自网站环境配置。以下几点常被忽略：

1. 确认 PHP 与 WordPress 版本

WooPayments 要求 WordPress 版本不低于 6.0，PHP 版本不低于 7.4。如果使用较旧版本，API 可能无法正常工作。

2. 检查网站时区与店铺货币设置

WooPayments 会验证商家国家、货币和时区是否匹配。例如，你的网站货币是 USD，但注册国家设置为日本，系统会自动拒绝连接。

3. 服务器 IP 被临时封锁

某些主机商（尤其是共享主机）可能会被 WooPayments 系统识别为异常来源。此时可联系主机客服要求“解封外部 API 通信端口”，或更换独立 IP。

四、预防 WooPayments 连接错误的最佳做法

保持 WordPress、WooCommerce 与 WooPayments 插件始终为最新版。
定期备份网站，避免因迁移或恢复备份导致 API 授权失效。
确保网站使用稳定的 HTTPS 连接和可信主机。
尽量减少使用过多安全插件或缓存插件，以免阻断通信。
在修改店铺信息（如国家、币种、地址）后，记得重新验证 WooPayments 账户。

五、结语

WooPayments 是 WooCommerce 官方推荐的支付方案，能为商家提供更安全、统一的收款体验。但由于它涉及多方系统对接，在连接时出现问题是常见现象。只要根据错误代码对症排查，逐步确认 SSL、API、账户和地区设置，大多数问题都能快速解决。
保持插件更新、信息一致、连接稳定，你的 WooPayments 就能顺利运行，让店铺的每一笔交易都更高效、更安全！！！

光子波动网，你可靠的wordpress网站问题解决之家。

联系我们
教程看不懂？联系我们为您免费解答！免费助力个人，小企站点！	客服微信
① 电话：020-2206-9892
② QQ咨询：1025174874
③ 邮件：[email protected]
④ 工作时间：周一至周五，9:30-18:30，节假日休息