WordPress 串接綠界：WooCommerce 金流設定與 callback 排錯完整教學

對台灣商家來說，WooCommerce 能不能真正開始賣，通常不是卡在網站外觀，而是卡在金流。

而在台灣的 WordPress 生態裡，綠界 ECPay 幾乎就是最常見的主金流入口。信用卡、ATM、超商代碼、超商條碼，很多商店一開始都會先從綠界起步。

如果你還沒把整個 WooCommerce 商店路線看完，先讀支柱文：WooCommerce 完整教學（Pillar）。

若你正在整理台灣支付組合，也建議一起搭配這三篇：

為什麼 WooCommerce 商店通常先接綠界？

原因很務實：

支付方式夠完整，能先滿足多數台灣消費者
WooCommerce 生態裡已有官方模組可直接串接
後續如果你還要補物流或電子發票，也比較容易延伸

如果你的網站主要客群在台灣，綠界通常不是唯一金流，但很常是第一個主金流。

比較常見的配置會是：

綠界當主金流，負責信用卡、ATM、超商付款
LINE Pay 當行動支付補充，降低手機結帳摩擦
PayPal 留給跨境或特定客群

綠界申請前要先準備什麼？

根據綠界官方賣家手冊，新戶申請特約賣家前，至少要先準備好以下幾類資料：

帳號資料與商店名稱
網站網址
商品類別與交付天期
身分與公司資料
聯絡人資料
物流資料與寄退貨聯絡資訊
銀行資料與存摺照片

綠界官方流程是先填帳號資料，再填基本資料、銀行資料、最後同意費用與條款送出。若無需補件，官方寫的是大約 3~5 個工作日 完成開通。

如果你是第一次申請，建議直接從綠界賣家手冊開始看，不要一邊進件一邊補資料，這樣最容易拖慢時程。

官方參考：

綠界特約賣家申請手冊：https://support.ecpay.com.tw/4738/
綠界 WooCommerce 官方模組：https://github.com/ECPay/Woocommerce_ECPAY
綠界待付款 FAQ：https://support.ecpay.com.tw/4634/

WooCommerce 串接綠界有哪兩條路？

方式一：用綠界官方 WooCommerce 模組

這是最直覺的做法。綠界官方 GitHub 有維護 WooCommerce 模組，README 也列出目前支援的 WordPress、WooCommerce 與 PHP 版本。

這條路適合：

標準 WooCommerce 商店
不想自己處理簽章與 API 細節
想先把付款流程跑通再優化

方式二：用整合型台灣金流外掛

如果你同時要處理綠界、藍新、物流、超商取貨等台灣在地需求，也有人會選整合型外掛，把多種金物流設定收在同一套後台。

這條路的好處是集中管理，但前提是你要接受更多外掛層的設定邏輯。

如果你現在的目標只是「先讓 WooCommerce 能收款」，我會建議先用官方模組或最穩定的一條路，不要一開始就把金流架構複雜化。

用綠界官方模組串接 WooCommerce 的設定步驟

下面這套做法，適合已經裝好 WordPress 和 WooCommerce 的站點。

第一步：下載並安裝綠界 WooCommerce 模組

到綠界官方 GitHub 下載 WooCommerce 模組，解壓後用其中提供的 WooCommerce 外掛壓縮檔上傳到 WordPress。

安裝路徑是：

WordPress 後台 > 外掛 > 安裝外掛 > 上傳外掛

上傳完成後啟用外掛。

第二步：到 WooCommerce 設定頁填入綠界參數

綠界官方 README 提到，設定路徑在：

WooCommerce > 設定

啟用模組後，你會看到綠界相關分頁。金流設定的核心欄位通常是：

Merchant ID
Hash Key
Hash IV
是否啟用測試模式
訂單編號前綴

這幾組資料都要從綠界後台取得，再回填到 WooCommerce。

第三步：先用測試模式跑一筆訂單

不要拿正式環境直接試。先開 Sandbox 或測試模式，至少完成這一輪：

建立測試商品
加入購物車
進入結帳頁
導到綠界付款頁
完成付款
回到網站後確認訂單狀態

你要確認的不只是「能跳去付款頁」，而是 付款完成後訂單是否有真的被更新。

第四步：如果要做超商取貨付款，還要補貨到付款設定

綠界官方 README 也特別提醒，如果你要做超商取貨付款，還需要到 WooCommerce 的付款設定中啟用對應運送方式，不是只裝外掛就會自動出現。

這也是很多新手第一次串接時，明明裝好模組卻發現結帳頁沒有正確付款方式的原因。

綠界設定時最容易漏掉的 4 個地方

1. 正式環境和測試環境的參數混用

最常見的錯誤之一，是測試 Merchant ID、Hash Key、Hash IV 跟正式環境參數混在一起。結果通常是：

可以進入流程
但付款建立失敗
或付款後網站狀態不一致

建議你在文件或密碼管理工具裡，把測試和正式兩套參數分開存放。

2. callback 路徑被安全規則擋掉

這是 WooCommerce 接綠界最麻煩、也最容易被誤判成「外掛壞掉」的問題。

綠界付款後，不只是把使用者導回網站而已，還會有一段 server-to-server 的背景通知。這段通知若沒順利進站，WooCommerce 訂單就不會更新。

3. 沒有先測不同付款方式的回傳時間

綠界官方 FAQ 提醒，不同付款方式的付款結果回傳時間不同。官方對 ECShop 的說明是：

信用卡、網路 ATM：最晚約付款後 30 分鐘內更新
ATM 虛擬帳號：最晚約付款日後 1 天更新
超商條碼：最晚約付款日後 3 天更新
超商代碼：最晚約付款日後 1 天更新

這代表你不能用「信用卡即時成功」的期待去判斷所有付款方式。若是非即時付款，等待時間本來就會比較長。

4. 上線後才想到通知信和退款流程

收款只是第一步。真正營運時，還會遇到：

顧客付款成功但沒收到通知
後台查不到交易紀錄
退款流程不清楚

這些通常要跟 WordPress SMTP 設定一起處理，否則金流接好了，營運流程還是不完整。

付款成功但 WooCommerce 訂單還是待付款，先查什麼？

這是最值得單獨講的一段。

如果你遇到下面這種情況：

顧客說已付款
綠界後台也顯示付款成功
但 WooCommerce 訂單還停在待付款

先不要急著怪外掛。

第一個檢查點：回傳時間是否還在合理範圍

如果是 ATM、超商類型付款，本來就不是即時更新，先依付款方式對照合理等待時間。

第二個檢查點：WooCommerce 訂單備註有沒有收到回傳紀錄

如果訂單備註完全沒有綠界回傳資訊，通常表示 callback 沒有進到網站。

第三個檢查點：Cloudflare 或 WAF 有沒有擋掉 callback

這是很多站點真正的問題來源。

我之前已經把原理拆成一篇筆記：Cloudflare「遭受攻擊模式」與綠界 callback 排錯筆記。

簡單說，Cloudflare 的 Under Attack Mode、JS Challenge、Bot Fight 等規則，對真人瀏覽器問題不大，但對綠界這種 server-to-server 回傳就可能直接擋掉。

Cloudflare + 綠界 callback 要怎麼處理？

常見的 WooCommerce callback 路徑，通常會落在 wc-api 類型的 URL。

實務上可在 Cloudflare WAF Rules 針對金流 callback URL 設 Bypass，例如：

URI contains wc-api

處理方向不是整站關防護，而是只把金流 callback 這類合法機器流量排除出 challenge 規則。

你應該保留一般頁面的保護，但讓：

金流 callback
webhook
後台 API

這些機器對機器的合法請求能正常通過。

綠界和 LINE Pay 要一起開嗎？

很多台灣 WooCommerce 商店最後都會是「主金流 + 行動支付補強」的組合。

如果你的客群主要來自行動裝置，我會建議：

綠界當主金流，處理信用卡、ATM、超商付款
LINE Pay 作為加速器，降低手機結帳離開率

換句話說，綠界和 LINE Pay 多半不是互斥，而是互補。

完整做法可接著看：WordPress 串接 LINE Pay 教學。

常見問題

綠界申請要多久？

依綠界官方特約賣家申請手冊，若無需補件，大約 3~5 個工作日 可完成開通；若資料不齊或需補件，時間會再拉長。

WooCommerce 串綠界一定要自己寫 API 嗎？

不用。標準 WooCommerce 站點多半直接用外掛即可，只有在你是 Headless、自訂流程或特殊商業規則很多時，才需要自己處理 API。

綠界付款成功但網站沒更新，一定是外掛問題嗎？

不一定。很常見是 callback 被 Cloudflare、WAF 或其他安全規則擋掉，也可能是正式與測試參數混用。

綠界可以單獨取代 LINE Pay 嗎？

不完全一樣。綠界比較像完整主金流，LINE Pay 比較像高使用率的行動支付入口。很多商店最後會同時保留兩者。

結論

WooCommerce 串接綠界真正的重點，不只是把 Merchant ID、Hash Key、Hash IV 填進去而已。

真正決定你能不能穩定收款的，是整條交易鏈有沒有跑通：

綠界申請是否完成
外掛設定是否對到正確環境
callback 是否能順利進站
Cloudflare 與通知信是否一起處理好

如果你要先把台灣主金流打穩，綠界通常是最值得先處理的一篇。接下來你可以再補：

如果你希望我直接幫你把 WordPress / WooCommerce 的綠界、LINE Pay、物流與通知信一起整理成可上線流程，可預約：免費諮詢。