很多賣家在初次配置 WooPayments 時(shí)都會(huì)遇到連接失敗、賬戶驗(yàn)證錯(cuò)誤或 API 授權(quán)異常等問題。本文將會(huì)詳細(xì)介紹 WooPayments 無法連接的常見原因、對(duì)應(yīng)錯(cuò)誤代碼的含義，以及最有效的解決方法，幫助你快速恢復(fù)支付功能。

一、為什么 WooPayments 會(huì)無法連接？

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

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

了解問題類型之后，我們可以根據(jù)具體錯(cuò)誤代碼對(duì)癥下藥。

二、常見錯(cuò)誤代碼與含義

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

1. Error: Could not connect to WooPayments

含義： WooPayments 無法驗(yàn)證網(wǎng)站身份或建立安全連接。
Razón: 網(wǎng)站 SSL 證書無效、主機(jī)禁用外部請(qǐng)求、或服務(wù)器防火墻阻斷 WooPayments API。

Solución:

• 確認(rèn)你的網(wǎng)站已啟用 HTTPS 并安裝有效的 SSL 證書。
• 在主機(jī)控制面板中開啟外部 HTTP 請(qǐng)求權(quán)限。
• 臨時(shí)關(guān)閉安全插件（如 Wordfence、Sucuri）測試是否為防火墻限制。

2. Error: Your account is not eligible for WooPayments

含義： WooPayments 暫不支持你所在國家或使用的結(jié)算幣種。
Solución:

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

• 若你的國家尚未開放，可以臨時(shí)選擇 Raya tal vez PayPal 替代方案。
• 使用 VPN 或代理并不能解決此問題，WooPayments 依然會(huì)根據(jù)身份證明驗(yàn)證所在地。

3. Error: Verification failed – Identity document rejected

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

Solución:

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

4. Error: API keys invalid or expired

含義： WooPayments 與 WooCommerce 之間的 API 授權(quán)令牌失效。
Razón: 網(wǎng)站遷移、緩存清理或插件重裝后未重新授權(quán)。
Solución:

• salir para WooCommerce → 設(shè)置 → 付款 → WooPayments，點(diǎn)擊“重新連接賬戶”。

• 若仍失敗，登錄 WooCommerce.com 賬戶，在“我的賬戶 → 連接服務(wù)”中手動(dòng)解除并重新授權(quán)。

5. Error: Pending verification

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

Solución:

• 登錄 WooPayments 儀表板查看“需要操作”的項(xiàng)目。
• 上傳缺失的文件后通常會(huì)在 24-48 小時(shí)內(nèi)審核完成。
• 審核期間網(wǎng)站仍可運(yùn)行，但交易會(huì)被暫時(shí)凍結(jié)。

6. Error: Something went wrong during onboarding

含義： WooPayments 注冊(cè)流程中發(fā)生未知錯(cuò)誤，通常與瀏覽器或插件沖突有關(guān)。
Solución:

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

三、網(wǎng)站配置問題導(dǎo)致的連接失敗

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

1. 確認(rèn) PHP 與 WordPress 版本

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

2. 檢查網(wǎng)站時(shí)區(qū)與店鋪貨幣設(shè)置

WooPayments 會(huì)驗(yàn)證商家國家、貨幣和時(shí)區(qū)是否匹配。例如，你的網(wǎng)站貨幣是 USD，但注冊(cè)國家設(shè)置為日本，系統(tǒng)會(huì)自動(dòng)拒絕連接。

3. 服務(wù)器 IP 被臨時(shí)封鎖

某些主機(jī)商（尤其是共享主機(jī)）可能會(huì)被 WooPayments 系統(tǒng)識(shí)別為異常來源。此時(shí)可聯(lián)系主機(jī)客服要求“解封外部 API 通信端口”，或更換獨(dú)立 IP。

四、預(yù)防 WooPayments 連接錯(cuò)誤的最佳做法

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

V. Conclusión

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

光子波動(dòng)網(wǎng)，你可靠的wordpress網(wǎng)站問題解決之家。

Contacte con nosotros
?No puede leer el tutorial? Póngase en contacto con nosotros para obtener una respuesta gratuita. Ayuda gratuita para sitios personales y de peque?as empresas	Servicio de atención al cliente WeChat
① Tel: 020-2206-9892
② QQ咨詢：1025174874
(iii) Correo electrónico: info@361sale.com
④ Horario de trabajo: de lunes a viernes, de 9:30 a 18:30, días festivos libres