WordPress 綠界金流串接教學：WooCommerce ECPay 設定完整步驟

你的 WooCommerce 電商網站架好了，商品也上了，但結帳頁面只能選「貨到付款」或「銀行轉帳」？那消費者一定跑掉一大半。串接綠界金流，讓你的客人能用信用卡、超商代碼、ATM 付款——這是台灣電商的標配。根據金管會統計，2025 年底台灣電子支付使用人數達 3,765 萬（經濟日報, 2025）。根據 ke2b 2025 年報告，綠界信用卡含稅費率約 2.8875%，是台灣中小型電商及品牌電商的首選金流平台（ke2b, 2025）。

我們串過至少 20 個 WordPress 網站的綠界金流。坦白說，第一次做會有點緊張，但跟著步驟走其實不會太難。最容易卡住的是 API 金鑰填入和測試環境切換這兩個地方，這篇會特別講清楚。

---

重點摘要： WordPress 綠界金流串接五步驟：安裝外掛 → 填入 API 金鑰 → 啟用付款方式 → 測試環境驗證 → 切換正式上線。整個過程約 1-2 小時可完成。綠界是台灣市佔率最高的第三方支付，信用卡手續費 2.75%，撥款約 7 天。

---

💡 金流物流搞不定？加 LINE 讓我幫你，從申請到串接上線全包。
👉 加 LINE 免費諮詢

---

串接前準備

在開始串接之前，你需要先搞定三件事。少了任何一個，後面都做不下去。

第一，申請綠界帳號。 到綠界官網（ecpay.com.tw）註冊會員，填寫基本資料和營業資訊。個人賣家也可以申請，但功能會比較受限。審核大約 3-5 個工作天。

你要準備的文件：

• 身分證正反面
• 銀行帳戶資訊（收款用）
• 網站網址（需有基本商品頁面）
• 營業登記證（公司行號需要）

第二，確認 WooCommerce 已安裝。 你的 WordPress 網站要先裝好 WooCommerce 外掛並完成基本設定（幣別設為 TWD、地區設為台灣）。

第三，SSL 憑證。 你的網站必須是 HTTPS。金流 API 通訊需要加密連線，沒有 SSL 的話金流平台會拒絕連接。如果你的主機還沒裝 SSL，先處理這個。

第一步：安裝綠界 WooCommerce 金流外掛

綠界的 WordPress 外掛有好幾個版本。根據 W3Techs 數據，WordPress 驅動全球約 42.5% 的網站（W3Techs, 2026），WooCommerce 佔全球電商約 33.4% 市佔率（Red Stag Fulfillment, 2025），所以金流外掛的生態非常成熟。我推薦用 RY WooCommerce Tools 這個整合型外掛，因為它一個外掛就能搞定金流、物流和電子發票，不用裝三個外掛。根據 tenten 報告，台灣行動購物佔電商交易量已達 60%（tenten, 2025），確保行動端的金流體驗順暢至關重要。

安裝步驟：

1. 登入 WordPress 後台
2. 前往「外掛 → 安裝外掛」
3. 搜尋 “RY WooCommerce Tools”
4. 點擊「立即安裝」，然後「啟用」

安裝完成後，到「WooCommerce → 設定 → 付款」頁面，你會看到多出好幾個綠界的付款方式選項。先別急著開，我們要先填 API 金鑰。

其實還有其他外掛也能用，但這個的更新頻率最高、社群討論最多，有問題比較找得到解法。 外掛選擇上，我們試過至少四五個綠界相關外掛，最後還是覺得 RY WooCommerce Tools 最穩定。它的優勢不只是功能齊全，而是遇到問題時社群資源多、更新頻率高，有人幫你踩過坑。

第二步：填入 API 金鑰與商店代號

這一步是最關鍵的。填錯任何一個欄位，金流就不會動。

到綠界後台取得 API 資訊：

1. 登入綠界會員中心
2. 前往「系統開發管理 → 系統介接設定」
3. 記下以下三個資訊：
   • 商店代號（Merchant ID）
   • Hash Key
   • Hash IV

然後回到 WordPress 後台：

1. 前往「WooCommerce → 設定 → 付款」
2. 點擊任一個綠界付款方式的「管理」
3. 找到 API 設定區塊
4. 填入商店代號、Hash Key、Hash IV

⚠️ 複製金鑰的時候千萬注意前後不要多空格。 這是我們遇過最多的錯誤原因。肉眼根本看不出來多了一個空格，但 API 驗證就是會失敗。建議複製後先貼到純文字編輯器檢查一下。

第三步：啟用付款方式

API 設定完成後，你可以選擇要開啟哪些付款方式。

信用卡付款設定

信用卡是大部分消費者的首選。啟用步驟：

1. 前往「WooCommerce → 設定 → 付款」
2. 找到「綠界信用卡」，點擊「啟用」
3. 設定信用卡相關選項（如是否支援分期，需先在綠界後台開通）

超商代碼繳費設定

超商代碼適合沒有信用卡的消費者。消費者下單後會拿到一組代碼，到超商就能繳費。

啟用方式一樣，在付款列表找到「綠界超商代碼」並啟用。要注意的是，超商代碼有繳費期限（通常 3-7 天），過期訂單會自動取消。

ATM/WebATM 設定

ATM 轉帳適合大額訂單。消費者會拿到一組虛擬帳號，轉帳後系統自動確認。

超商條碼繳費設定

超商條碼跟代碼類似，但消費者到超商出示條碼掃描就能繳。這是綠界獨有的功能，藍新沒有。

我的建議？剛開始把信用卡和超商代碼開起來就好。ATM 和超商條碼可以等有需求再開。付款方式太多反而讓消費者選擇困難。

---

學完覺得太複雜？沒關係，加 LINE 讓我們幫你搞定

金流串接最花時間的不是步驟本身，是遇到問題時的除錯。如果你不想自己折騰，我們可以幫你一次搞定。

👉 加 LINE 免費諮詢

---

第四步：測試環境驗證

拜託不要跳過這步。我知道你很想趕快上線開賣，但不先測試就直接用正式環境，出事了很麻煩。

綠界提供完整的測試環境，你可以用模擬的金鑰跑假訂單，不會真的扣款。

測試流程：

1. 在外掛設定中切換到「測試模式」
2. 填入綠界提供的測試用商店代號和金鑰
3. 到你的網站前台下一張測試訂單
4. 選擇信用卡付款，用綠界提供的測試信用卡號完成付款
5. 回到 WooCommerce 後台，確認訂單狀態有正確更新為「處理中」

常見的測試問題：

• 付款頁面跳不出來：確認你的網站有 SSL（HTTPS），並且沒有被安全外掛擋住
• 付款成功但訂單狀態沒更新：檢查回傳網址（Notify URL）是否正確
• 出現 Hash 驗證失敗：金鑰複製有誤，重新複製貼上一次

每種付款方式（信用卡、超商代碼、ATM）都要跑一次測試。不要只測信用卡就覺得沒問題。

第五步：切換正式環境上線

測試全部通過之後，就可以切換到正式環境了。

1. 把外掛中的測試用金鑰換成正式的商店代號、Hash Key、Hash IV
2. 關閉測試模式
3. 自己下一張正式訂單測試（用自己的信用卡付個 NT$10 的商品）
4. 確認金流正常運作、訂單狀態正確更新 我們的標準流程是正式上線後的第一天會密切監控所有訂單。如果有客人回報付款問題，通常前 30 分鐘就能判斷是金流設定的問題還是消費者端的問題。

綠界金流常見問題排解

即使照著教學一步步做，還是可能遇到問題。以下是我們最常處理的幾個。

付款後訂單狀態沒更新

這是最常見的問題。原因通常是：

1. 回傳網址（Notify URL）不正確 — 金流付款成功後，綠界會發一個通知到你的網站。如果這個網址錯了，通知就收不到。
2. 安全外掛擋住了回傳請求 — Wordfence、iThemes Security 這些外掛可能會把綠界的請求當成攻擊。需要把綠界的 IP 加到白名單。
3. 主機的防火牆設定 — 有些主機商會擋掉外部的 POST 請求。

API 回傳錯誤代碼對照

退款與取消交易操作

綠界的退款分兩種：

• 信用卡退款：在綠界後台操作，款項約 7-14 天退回消費者卡上
• 超商/ATM 退款：系統無法自動退，需要手動匯款給消費者

退款操作記得同步更新 WooCommerce 訂單狀態為「已退款」。

常見問題 FAQ

Q: 綠界外掛是免費的嗎？

A: RY WooCommerce Tools 這個外掛本身是免費的，WordPress 外掛庫就能下載。綠界也不收外掛使用費，只收每筆交易的手續費。所以串接本身不用額外花錢。

Q: 綠界串接需要多久？

A: 帳號審核 3-5 天，串接設定 1-2 小時，加上測試時間，整體大約一週可以完成。如果帳號已經審核通過，當天就能串接完上線。

Q: 串接綠界一定要有公司登記嗎？

A: 不一定。個人賣家也可以申請綠界帳號，但信用卡交易額度會有限制。如果你計畫認真經營電商，建議還是辦營業登記，功能比較完整。

延伸閱讀

• 回到金流串接完整攻略
• 也看看藍新串接教學
• 金流搞定了？物流也一起設定
• 金流串好了？別忘了電子發票
• LINE Pay 串接教學

---

加 LINE 免費諮詢，幫你串好綠界金流馬上開始收款

從申請帳號到串接上線，我們全程幫你處理。你只要提供帳號資訊，其他交給 GOT YOU DESIGN 搞定。

👉 加 LINE 免費諮詢

---

---

常見問題

綠界外掛是免費的嗎？

RY WooCommerce Tools 這個外掛本身是免費的，WordPress 外掛庫就能下載。綠界也不收外掛使用費，只收每筆交易的手續費。所以串接本身不用額外花錢。

綠界串接需要多久？

帳號審核 3-5 天，串接設定 1-2 小時，加上測試時間，整體大約一週可以完成。如果帳號已經審核通過，當天就能串接完上線。

串接綠界一定要有公司登記嗎？

不一定。個人賣家也可以申請綠界帳號，但信用卡交易額度會有限制。如果你計畫認真經營電商，建議還是辦營業登記，功能比較完整。