很多賣家在初次配置 WooPayments 時都會遇到連接失敗、賬戶驗證錯誤或 API 授權異常等問題。本文將會詳細介紹 WooPayments 無法連接的常見原因、對應錯誤代碼的含義，以及最有效的解決方法，幫助你快速恢復支付功能。

一、為什么 WooPayments 會無法連接？

WooPayments 是 WooCommerce 官方推出的一體化支付解決方案，基于 Stripe 技術構建，支持全球多種貨幣與支付方式。但由于它涉及銀行賬戶、API 授權和身份驗證等環(huán)節(jié)，連接過程中容易出現以下幾類問題：

• 賬戶信息不匹配：店鋪信息與 WooPayments 注冊資料不一致。
• 地區(qū)或貨幣限制：WooPayments 尚未支持你的注冊國家或結算幣種。
• API 授權異常：WooCommerce 與 WooPayments 的連接令牌失效或未正確生成。
• 服務器 SSL 或防火墻問題：網站未使用 HTTPS，或防火墻阻止外部通信。
• 插件沖突：部分安全插件或緩存插件會干擾 WooPayments 的 API 調用。

了解問題類型之后，我們可以根據具體錯誤代碼對癥下藥。

二、常見錯誤代碼與含義

以下是 WooPayments 中最常見的幾類錯誤提示及解釋：

1. Error: Could not connect to WooPayments

含義： WooPayments 無法驗證網站身份或建立安全連接。
Raison : 網站 SSL 證書無效、主機禁用外部請求、或服務器防火墻阻斷 WooPayments API。

Solution :

• 確認你的網站已啟用 HTTPS 并安裝有效的 SSL 證書。
• 在主機控制面板中開啟外部 HTTP 請求權限。
• 臨時關閉安全插件（如 Wordfence、Sucuri）測試是否為防火墻限制。

2. Error: Your account is not eligible for WooPayments

含義： WooPayments 暫不支持你所在國家或使用的結算幣種。
Solution :

• 登錄 WooPayments 官方支持頁面查看最新支持地區(qū)列表。

• 若你的國家尚未開放，可以臨時選擇 Rayure peut-être PayPal 替代方案。
• 使用 VPN 或代理并不能解決此問題，WooPayments 依然會根據身份證明驗證所在地。

3. Error: Verification failed – Identity document rejected

含義： 身份驗證未通過，上傳的身份證件或營業(yè)執(zhí)照不符合要求。

Solution :

• 上傳高清、無遮擋的證件掃描件。
• 確保姓名、地址、公司信息與 WooCommerce 店鋪設置一致。
• 若資料真實但仍被拒，可通過 Woo 支持中心提交人工審核。

4. Error: API keys invalid or expired

含義： WooPayments 與 WooCommerce 之間的 API 授權令牌失效。
Raison : 網站遷移、緩存清理或插件重裝后未重新授權。
Solution :

• partir pour WooCommerce → 設置 → 付款 → WooPayments，點擊“重新連接賬戶”。

• 若仍失敗，登錄 WooCommerce.com 賬戶，在“我的賬戶 → 連接服務”中手動解除并重新授權。

5. Error: Pending verification

含義： WooPayments 賬戶正在審核中，暫未完成身份驗證。

Solution :

• 登錄 WooPayments 儀表板查看“需要操作”的項目。
• 上傳缺失的文件后通常會在 24-48 小時內審核完成。
• 審核期間網站仍可運行，但交易會被暫時凍結。

6. Error: Something went wrong during onboarding

含義： WooPayments 注冊流程中發(fā)生未知錯誤，通常與瀏覽器或插件沖突有關。
Solution :

• 嘗試在隱身模式下重新登錄并連接。
• 清除瀏覽器緩存或更換瀏覽器（建議使用 Chrome 或 Firefox 最新版本）。
• 禁用所有非必要插件后重試。

三、網站配置問題導致的連接失敗

除了系統錯誤外，許多 WooPayments 無法連接的問題來自網站環(huán)境配置。以下幾點常被忽略：

1. 確認 PHP 與 WordPress 版本

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

2. 檢查網站時區(qū)與店鋪貨幣設置

WooPayments 會驗證商家國家、貨幣和時區(qū)是否匹配。例如，你的網站貨幣是 USD，但注冊國家設置為日本，系統會自動拒絕連接。

3. 服務器 IP 被臨時封鎖

某些主機商（尤其是共享主機）可能會被 WooPayments 系統識別為異常來源。此時可聯系主機客服要求“解封外部 API 通信端口”，或更換獨立 IP。

四、預防 WooPayments 連接錯誤的最佳做法

• 保持 WordPress、WooCommerce 與 WooPayments 插件始終為最新版。
• 定期備份網站，避免因遷移或恢復備份導致 API 授權失效。
• 確保網站使用穩(wěn)定的 HTTPS 連接和可信主機。
• 盡量減少使用過多安全插件或緩存插件，以免阻斷通信。
• 在修改店鋪信息（如國家、幣種、地址）后，記得重新驗證 WooPayments 賬戶。

V. Conclusion

WooPayments 是 WooCommerce 官方推薦的支付方案，能為商家提供更安全、統一的收款體驗。但由于它涉及多方系統對接，在連接時出現問題是常見現象。只要根據錯誤代碼對癥排查，逐步確認 SSL、API、賬戶和地區(qū)設置，大多數問題都能快速解決。
保持插件更新、信息一致、連接穩(wěn)定，你的 WooPayments 就能順利運行，讓店鋪的每一筆交易都更高效、更安全?。?！

光子波動網，你可靠的wordpress網站問題解決之家。

Contactez nous
Vous n'arrivez pas à lire le tutoriel ? Contactez-nous pour une réponse gratuite ! Aide gratuite pour les sites personnels et les sites de petites entreprises !	Service clientèle WeChat
① Tel : 020-2206-9892
② QQ咨詢：1025174874
(iii) Courriel : info@361sale.com
④ Horaires de travail : du lundi au vendredi, de 9h30 à 18h30, jours fériés.