WooCommerce 綠界金流串接教學：5 步驟 + Callback 收不到怎麼修（2026）

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

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

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

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

• 先看台灣金流物流設定（How）
• 再看 LINE Pay 行動支付補強
• 如果還在平台選型，先看比較文

為什麼 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 圈最常被用的是 RY WooCommerce Tools（免費），它把綠界的金流與物流設定收在同一個地方，超商取貨的電子地圖與託運單也一起處理掉。我們自己接案時，客戶站在 WordPress 上、又要金物流一起做，多半直接走這條。

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

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

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

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

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

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

安裝路徑是：

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

上傳完成後啟用外掛。

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

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

WooCommerce > 設定

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

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

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

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

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

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

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

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

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

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

這裡有一個沒人會提醒你的坑：物流有自己的一組參數

綠界的物流有獨立的 MerchantID、HashKey、HashIV，跟你前面填的金流那組不是同一組，要另外開通。

我們接案時把它列成 onboarding 清單上獨立的一條，因為向客戶說「給我綠界的 key」，收到的一定只有金流那組。

麻煩的是填錯時不會跳出「key 錯誤」。症狀會長成這樣：

• 結帳時電子地圖（讓客人選超商門市那個彈窗）打不開
• 建立物流單失敗
• 測試環境看起來都正常，正式環境才炸

如果你卡在上面任何一項，先回頭確認物流那組參數是不是拿金流的貼上去的。

錢什麼時候進來？綠界的撥款、提領與對帳

多數串接教學到「測試模式跑通」就結束了，但你第一次真的收到錢的那幾天，會問的是另一組問題：客人昨天付了，錢在哪？

撥款分兩段，第一段不是進你的銀行

這是最多人卡住的地方：款項先進「綠界帳戶」，不會自動入你的銀行帳戶。

所以「一般賣家、週三收到的一筆訂單」，實際到銀行的時間是：下週二撥進綠界帳戶 → 你按提領 → 再等 2–3 個工作日。不是付款當下就入帳。

如果不想每次手動按，後台可以設自動提領排程（每日／每週指定日／每月指定日，於指定日晚上 10 點執行），也可以設「保留帳戶金額」，超過的部分自動提領。

提領手續費

跨行提領每次收 15 元轉帳手續費。若把永豐銀行帳戶設為提領帳戶，享不限次數提領手續費 0 元。

金額不大但會累積——每天提一次跟每週提一次，一年差幾百塊；這也是為什麼上面的自動提領建議用「保留帳戶金額」而不是「每日固定提領」。

金流跟物流是兩份帳，不是一份

這是承接前面「物流有自己一組參數」的那件事：兩條線的對帳位置也是分開的。

超商取貨付款（COD）的錢走的是物流代收那條線，不是信用卡那條。它的撥款節奏跟金流分開計算，手續費也是每筆固定金額而不是百分比。

所以月底對帳的時候，你要開的是兩份報表。第一次做的人常常只對了金流那份，然後帳兌不起來。

以上撥款規則與費用查自綠界官方說明，2026-08-15 核對。金流服務費率與提領規則會調整，簽約前請以綠界後台與最新公告為準。

綠界設定時最容易漏掉的 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 教學。

上線前檢查清單（可直接複製去用）

這是我們自己接案時的 onboarding 清單。每一條都是踩過才加上去的——尤其第 2 條，只說「給我綠界的 key」，收到的一定只有金流那組。

□ 1. 綠界商家帳號（確認是一般賣家還是特約賣家 —— 撥款週期不同）
□ 2. 金流參數：MerchantID / HashKey / HashIV
□ 3. 物流參數：MerchantID / HashKey / HashIV  ← 跟第 2 項不是同一組，要另外開通
□ 4. 要啟用哪幾種付款：信用卡 / 網路 ATM / ATM 虛擬帳號 / 超商代碼 / 超商條碼
□ 5. 要啟用哪幾種物流：超商取貨 / 超商取貨付款 / 宅配 / 郵局
□ 6. 綠界後台已開啟「電子地圖」功能（沒開的話客人選不了門市）
□ 7. 出貨人姓名 / 電話 / 地址（列印託運單用）
□ 8. 提領銀行帳戶（跨行每次 15 元；永豐帳戶免手續費）
□ 9. callback URL 是 HTTPS，且已在 WAF 排除該路徑
□ 10. 測試模式跑過一筆完整訂單，且訂單狀態有真的更新
□ 11. 訂單到出貨的分工講清楚：誰列印託運單、誰送超商
□ 12. 上線後第一週排一次對帳：金流一份、物流一份

第 12 條特別容易被跳過。第一次對帳如果只開了金流那份報表，帳一定兌不起來，因為超商取貨付款的錢在另一份。

常見問題

綠界申請要多久？

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

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

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

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

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

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

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

結論

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

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

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

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

• WooCommerce 金流物流設定
• WordPress 串接 LINE Pay
• WooCommerce 建置顧問服務

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

WooCommerce 系列

• 先搞懂它是什麼：WooCommerce 適合我嗎？四個判斷條件
• 想自己開起來：WooCommerce 教學：從安裝、金流到上架的完整開店指南
• 不想自己架：微電商方案 — 月繳 NT$ 1,500，付款當天開站

🔗 金流之外的三段：超商取貨怎麼設（物流要另外申請）、電子發票怎麼串、運費規則怎麼設。