~/blog/woocommerce-taiwan-payment-logistics-integration-guide.md
電商與 WooCommerce ·

WooCommerce 台灣金流物流串接完整指南

Eric — 浪花科技創辦人 / AI 架構師
Eric
浪花科技創辦人 · AI 架構師
WooCommerce 台灣金流物流串接完整指南
目錄 table-of-contents.md

結帳頁面跳出那張綠色的「訂單完成」畫面,客人截圖傳到 LINE 說錢已經扣了,語氣有點急。你打開 WooCommerce 後台的訂單列表,從頭滑到尾,連一筆待處理的訂單都沒有。信用卡明明過卡成功,超商代碼也真的產生了,訂單就是憑空消失。這種場景在台灣的 WooCommerce 站台上每天都在上演,而且往往在檔期流量最高、最不能出錯的那幾天集中爆發。

會發生這件事,九成不是因為你選錯了金流商,而是因為金流回傳的那通通知(NotifyURL 回調)沒有被你的站台正確接住,訂單於是卡在半路。台灣金物流串接的難處不在「接得起來」,而在「接得穩、接得久、換季不會壞」。這篇指南我們用顧問實戰的視角,把綠界、藍新、TapPay、LINE Pay 的費率與外掛現況、黑貓與超商取貨的 API 邏輯、掉單的根因,以及 HPOS 這個近兩年最大的地雷,一次講清楚,讓你在簽約前就知道每個方案的坑在哪裡。

為什麼台灣金流物流串接特別麻煩?

國外教學影片裡串 Stripe 三分鐘搞定,換到台灣就處處卡關,這不是錯覺。台灣的電商基礎設施有幾個結構性問題,會讓串接難度整整高一個檔次。

官方外掛的相容標示嚴重落後。綠界官方目前主推的是合併版 ECPay Ecommerce for WooCommerce,版本 1.1.2603230,但它在 WordPress.org 上標的「Tested up to」只到 WP 6.5.8,而現在 WordPress 核心已經推進到 7.0。舊的三支分拆外掛(信用卡、ATM、超商各一支)則已經全數下架。一個新手若照著兩三年前的教學文章去找那三支外掛,會直接撲空。藍新官方外掛版本是 1.0.12(2026 年 2 月 24 日更新),連 HPOS 相容都沒有明確宣告。這代表你不能只看「有沒有官方外掛」,還得看它到底跟不跟得上核心。

NotifyURL 回調容易被 WAF 或防火牆擋掉。台灣金流的付款結果不是靠客人瀏覽器帶回來的,而是金流伺服器主動打一個 POST 請求到你指定的網址(也就是 NotifyURL 或 ReturnURL)。問題是,這個請求來自綠界或藍新的機房 IP,沒有帶你網站的登入 Cookie,很多資安外掛、Cloudflare 規則或主機商的 WAF 會把它當成可疑流量直接擋下。客人端看到成功頁(那是另一條 ClientBackURL),但你後台收不到通知,訂單就永遠停在待付款。這是台灣掉單問題的頭號元兇,我們在 Webhook 掉單五大原因 那篇有更技術面的拆解。

HPOS 的全站連坐機制。WooCommerce 從 8.2 版起,新安裝預設啟用 HPOS(高效能訂單儲存),訂單不再存進 WordPress 的 posts 表,而是搬到獨立的自訂資料表。好處是快,代價是所有經手訂單的外掛都必須主動宣告自己相容 HPOS,只要其中一支沒宣告,整個站台的 HPOS 就會被鎖住無法啟用。你的金流外掛、物流外掛、發票外掛,任何一支落後,就會拖累全部。

超商規格會隨季調整。超商取貨的尺寸上限、C2C 費率、月優惠方案,幾乎每一到兩季就微調一次。7-11 交貨便 C2C 目前原價 60 元、限三邊合計 105 公分以內,但常態性會有月優惠。這種浮動意味著你不能把費率寫死在程式碼裡,選型時也要把「規格會變」這件事算進維護成本。

30 秒總覽:四大金流定位對照表

在往下鑽細節之前,先用一張表把四家金流的定位、主力費率與適合誰講清楚。這樣後面看各家深入拆解時,你心裡已經有個座標。以下費率均為新台幣未稅、查證於 2026 年 7 月 2 日。

服務商定位信用卡費率超商代碼適合誰
綠界 ECPay全通路老牌,金物流一站式2.75%(每筆低消 5 元)+處理費 1 元/筆31 元/筆要超商取貨與代收貨款的多數店家
藍新 NewebPay費率可議、無年費2.8%(可議至約 2.4%)28 元/筆量體中大、想壓費率又不想付年費
TapPay純刷卡閘道,體驗流暢國內 2.75% / 國外 3.5%無(定位 Gateway)只收信用卡、重視結帳體驗的品牌
LINE Pay錢包支付,導流社群一律 3%客群集中在 LINE 生態、想加收一種付款

抓住一個原則:如果你要賣實體商品、需要超商取貨與貨到付款,綠界的一站式整合幾乎是預設起點;如果你只賣數位商品或高單價服務、只收信用卡,那 TapPay 或藍新的體驗會更俐落。金流很少是二選一,多數成熟的站台會同時掛兩到三種。

金流怎麼選?四大服務商深入拆解

綠界 ECPay:實體電商的預設答案

綠界是台灣中小電商滲透率最高的金流,主因是它把金流跟物流綁在同一個帳戶體系裡,超商取貨、代收貨款、電子發票都能一站搞定。一般賣家的公開費率是信用卡 2.75%(每筆低消 5 元),另加訂單處理費 1 元/筆;超商代碼 31 元/筆、超商條碼 16 元、ATM 轉帳 1%(低消 15 元)。若你的月營業額夠大,可以談特約,費率能壓到 1.85% 到 2.75% 的區間,但要付設定費 5000 元加年費 13000 元起,這筆固定成本要用交易量攤提才划算。

外掛現況是綠界最需要留意的一環。官方合併版 ECPay Ecommerce for WooCommerce(v1.1.2603230)雖然功能完整,但 Tested up to 只標到 WP 6.5.8,跟核心的 7.0 有明顯落差。實務上它多半還能運作,但你必須自己在測試站驗過再上正式站,不能盲信「官方就沒問題」。串接的技術細節可以參考我們的 ECPay 金流 API 串接實戰,裡面對 CheckMacValue 的雜湊驗證與 NotifyURL 設定有逐步說明。

藍新 NewebPay:想壓費率又不想被年費綁住

藍新的賣點是彈性。信用卡標準費率 2.8%,但有議價空間,量體夠大時可談到約 2.4%;ATM 1%、超商代碼 28 元/筆,而且沒有年費,只在提領時收 10 元/筆(每月前五次免費)。對於還在成長期、不確定量體能不能撐起綠界特約年費的店家,藍新是相對沒有固定成本壓力的選擇。

要提醒的是,藍新官方費率頁對爬蟲有阻擋,我們這裡的數字是交叉兩個第三方來源後整理的,簽約前務必再打開官方頁或直接問業務核對一次。外掛方面,官方版本 1.0.12(2026 年 2 月 24 日)尚未明確宣告 HPOS 相容,這點在你規劃站台架構時要先納入評估。

TapPay:把刷卡體驗做到最順的閘道

TapPay 的定位跟前兩家不太一樣,它是純粹的信用卡收單閘道(Gateway),沒有超商代碼這類非卡片付款方式。費用結構是開辦費 5000 元加年費 11000 元,國內卡 2.75%、國外卡 3.5%,若走閘道模式再收 0.3%/筆。它的優勢在結帳體驗:卡號直接在你的頁面上輸入、不跳轉、支援 Apple Pay 與 Google Pay,對重視品牌一致性與轉換率的站台很有吸引力。若你正在打磨結帳流程,可以搭配 自訂結帳流程指南 一起看,把付款欄位與運送方式的動線設計好。

沒有官方免費外掛是 TapPay 的門檻,市面上要靠第三方付費外掛(例如 OctopusWP,月費約 NT$299)才能接進 WooCommerce。這筆訂閱費要算進總持有成本,尤其對只有一個站台的小店來說,長期下來未必比綠界的一次性設定費便宜。

LINE Pay:導流社群、補齊付款選項

LINE Pay 幾乎不會是主力金流,但很適合當作「多一種選擇」來提升轉換。費率一律 3% 未稅,約兩個工作天撥款,而且只支援 LINE 錢包餘額與綁定卡片支付。它真正的價值在客群:如果你的顧客本來就活在 LINE 上,結帳時看到熟悉的 LINE Pay 按鈕,臨門一腳的猶豫會少很多。

技術上,LINE Pay 走的是 Online API v3,採 HMAC-SHA256 簽章、提供 sandbox 環境測試。外掛方面反而是第三方做得比較好,WPBrewer 的 v1.3.3 明確支援 HPOS 與 Checkout Blocks,這在四家裡算是相容性宣告最完整的,若你已經全面轉向區塊結帳,它是相對安心的選擇。

物流怎麼串?黑貓與超商取貨的實務

金流串好只是收到錢,貨要能順利出得去、客人能順利取得到,訂單才算真正完成。台灣物流的世界分成兩塊:宅配到府與超商取貨,兩者的串接邏輯完全不同。

黑貓宅配走契約制。黑貓(統一速達)不對散客開放 API,你必須先成為契約客戶,費率是議價的、不公開,牌價常溫本島大約落在 130 到 250 元之間,實際依重量材積與量體而定。成為契客後,才能在契客專區取得列印託運單所需的 API 授權碼,把出貨列印自動化。宅配通、超商 API 這類的完整程式化串接方法,我們站上流量最高的那篇 黑貓宅配通與超商取貨 API 整合指南 講得最完整,要做自動出貨的話那篇是必讀。

超商取貨分 C2C 與 B2C。7-11 交貨便 C2C(賣家寄件、買家超商取貨)原價 60 元,常態有月優惠方案,但有尺寸限制,包裹三邊合計不能超過 105 公分。若你要走 B2C(大宗寄倉、從物流中心配送到門市),就得跟統一簽約或透過整合商,散戶無法自己接。全家的「好賣+」則是免抽成,但它沒有公開的 API,想程式化串接一樣得走整合商,這點要先講清楚,別被「免費」兩個字誤導成「好串」。

綠界物流整合 API 是最省事的一站式解法。如果你不想跟每一家超商分別簽約、分別串接,綠界的物流整合 API 把 7-11、全家、萊爾富、OK 都收在同一支 API 底下。費率上,7-11 的 B2C 是 55 元/筆、C2C 是 65 元/筆(未稅),取貨付款的代收服務費是 0.75%。它還內建電子地圖選店、批次列印託運單、貨態回傳,等於把物流的維運雜事一次外包。下面這張表把主要選項的關鍵條件並排,方便你快速比對。

物流方案串接方式費率(未稅)API / 尺寸限制
黑貓宅配需成為契約客戶議價,牌價本島約 130 到 250 元契客專區取授權碼、有取單 API
7-11 交貨便 C2C自行申請或走整合商原價 60 元,常有月優惠三邊合計 ≤ 105 公分
全家好賣+免抽成,但無公開 API免抽成程式化串接須走整合商
綠界物流整合 API單一 API 接多家超商7-11 B2C 55 元、C2C 65 元;代收 0.75%含電子地圖、批次印單、貨態回傳

要把出貨這件事做到不用人工介入、量大也不崩,靠的是一套可擴展的自動化流程,這部分可以延伸看 可擴展出貨引擎 的設計思路。

費率與外掛相容性總表

把金流的費率與外掛狀態放在同一張表裡,你會更清楚「相容性落後」這件事有多普遍。這是選型時最該盯著看的一張表,尤其是最右邊那欄。

金流信用卡費率(未稅)年費官方外掛版本HPOS 相容宣告
綠界 ECPay2.75%+處理費 1 元特約 13000 起,一般無合併版 1.1.2603230Tested up to 僅 WP 6.5.8,需自驗
藍新 NewebPay2.8%(可議至約 2.4%)官方 1.0.12(2026-02)未明確宣告
TapPay國內 2.75% / 國外 3.5%11000無官方免費外掛依第三方外掛而定
LINE Pay一律 3%依方案WPBrewer 1.3.3(第三方)支援 HPOS+Checkout Blocks

看出來了嗎?宣告相容度最完整的,反而是 LINE Pay 的第三方外掛,官方主推的綠界與藍新在 HPOS 這一格都留了問號。這正是台灣官方外掛「功能可用、相容標示落後」的縮影,也是為什麼我們一直強調上正式站前一定要在測試環境跑過完整訂單流程。

掉單到底發生了什麼事?

回到開頭那個「客人付了款、後台卻沒訂單」的場景。掉單不是單一原因,而是一組症狀,我們依 WooCommerce 官方的訂單疑難排解文件,把它拆成四種典型狀況。

Pending payment(待付款卡住)。訂單建立了、卻停在待付款,最常見的根因就是前面說的 NotifyURL 回調沒被接住。官方建議先檢查 webhook 設定與付款閘道的通知網址是否正確、是否被防火牆擋下。台灣的情境要特別檢查資安外掛與 Cloudflare 的規則,把金流機房的 IP 或回調路徑加進白名單。

Failed(訂單失敗)。官方歸納出五大成因:卡片被銀行拒絕、API 憑證過期、系統把重複交易誤判為詐欺、API key 設定錯誤、以及站台版本過舊。其中「API 憑證過期」在台灣特別容易被忽略,因為綠界、藍新的正式金鑰跟測試金鑰長得很像,一旦上線時忘記換成正式金鑰,就會整批失敗。

重複訂單。客人在付款頁多按了幾次、或回調與前端返回同時觸發,就可能產生兩筆訂單。穩健的做法是在回調處理裡做冪等性(idempotency)判斷,用金流的交易編號當唯一鍵,收到重複通知時只更新、不新增。

回調被擋(最核心的那一類)。前三種都跟這一種有交集。真正要根治掉單,得把回調的接收做得夠可靠:驗簽要正確、要能容忍金流的重送、失敗要有重試與記錄。這套可靠性設計我們在 Webhook 訂單自動化流程 有完整範例,把回調當成一條要監控的關鍵管線來對待,而不是接上就不管。訂單狀態一旦穩定,後面接發票、接出貨、接庫存才有意義。

HPOS 會不會讓你的外掛全部失效?

HPOS(High-Performance Order Storage,高效能訂單儲存)是 WooCommerce 這兩年最重要、也最容易踩雷的架構變更。它從 8.2 版起在新安裝上預設啟用,把訂單資料從 WordPress 的 posts 表搬到專屬資料表,讓大量訂單的查詢與寫入快上一截。

雷點在於它的連坐機制:每一支會讀寫訂單的外掛,都必須在程式碼裡主動宣告 declare_compatibility 支援 HPOS,只要有一支沒宣告,WooCommerce 就會判定風險太高,直接把整個站台的 HPOS 鎖住不讓你啟用。這代表你的金流外掛、物流外掛、發票外掛、會員外掛,任何一支落後,都會拖累全站的效能升級。

回到前面那張相容性總表,你就懂為什麼綠界與藍新官方外掛那兩格問號這麼要命。實務上的建議是:新站直接用支援 HPOS 的外掛組合起步;舊站要遷移前,先在測試站把每一支外掛的相容狀態盤點一遍,確認全數綠燈再切換。WooCommerce 目前最新是 10.9.1(2026 年 6 月 24 日),官方建議環境是 WordPress 6.9 以上、PHP 8.3 以上、MySQL 8.0 以上,升級 HPOS 前也一併把主機環境拉到這個基準線。想更全面理解 WordPress 站台的架構與維運,可以參考我們的 企業級 WordPress 開發指南

不同情境該怎麼選?

剛起步的個人賣家

資源有限、量體還小、主要賣實體商品,那就綠界一站式起步:一個帳戶同時搞定信用卡、超商代碼與超商取貨,沒有年費壓力,等量體上來再考慮談特約。外掛先用官方合併版,但務必在測試站驗過訂單流程與回調再上線。

中大型品牌電商

月營業額夠撐年費、對費率敏感、又重視結帳體驗,可以走「主力壓費率、輔助顧體驗」的組合:綠界特約或藍新談議價費率當主力收單,再掛 TapPay 把高單價信用卡訂單的結帳做順。站台架構上務必全面 HPOS 化,並把訂單、庫存、金流的責任拆開,這種規模的做法可以參考 結帳與庫存微服務架構

幫客戶接案的開發者

你交付的不只是「能收款」,而是「三年後換季也不會壞」。選型時把外掛相容性、HPOS 宣告、回調可靠性當成驗收標準,並用 商品 API 把可變商品與規格結構化,方便後續維護。交付前跑一輪完整的下單到出貨測試,把每個環節的失敗情境都演練過。

高流量促銷檔期

檔期的敵人是尖峰併發,掉單與重複訂單會在這時集中爆發。事前要做的是把回調管線壓力測過、確認冪等性有效、庫存不會超賣。庫存這一塊可以搭配 自動庫存比對 做即時同步,避免超賣後才手忙腳亂退款。

想把出貨與客服全自動化

當訂單、金流、物流都串穩之後,下一步是把「訂單成立就自動開發票、自動排出貨、自動通知客人」這條龍接起來。這類跨系統的自動化,用 n8n 這類流程工具會比硬寫程式更好維護,我們在 n8n、Make、Zapier 自動化平台比較 有完整評比。整體站台的速度與轉換率也別忽略,付款頁多等一秒,流失就多一分,這部分見 效能與轉換率優化

資料來源與延伸連結

台灣網路零售的大盤仍在成長,據經濟部統計處資料,2025 年台灣零售業網路銷售額達 6,716 億元、年增 2.8%,網路滲透率 13.9% 為歷史次高。把金物流串穩,就是在這個持續放大的市場裡把每一筆流量都轉成真正入帳的訂單。

本文費率與版本資訊查證於 2026 年 7 月 2 日,費率與優惠常變動,簽約前請以官方頁面為準。

延伸閱讀

金物流串接看起來只是接幾支 API,真正難的是讓它在換季、在檔期尖峰、在核心升級後依然穩定入帳。如果你不想每次改版都提心吊膽,或正被掉單問題反覆困擾,浪花科技可以幫你把整套金流物流架構一次盤點到位。歡迎與我們的顧問團隊聊聊你的站台現況。

// FAQ

常見問題

Q1: 客人付款成功但 WooCommerce 後台沒有訂單,怎麼辦?
這幾乎都是金流的 NotifyURL 回調沒被站台接住。金流付款結果是由綠界或藍新的伺服器主動 POST 回你的站台,這個請求沒有帶登入 Cookie,很容易被資安外掛、Cloudflare 或主機 WAF 擋下。請先檢查付款閘道的通知網址設定是否正確,並把金流機房的回調路徑加進防火牆白名單,同時確認上線時已把測試金鑰換成正式金鑰。
Q2: 綠界、藍新、TapPay、LINE Pay 我該選哪一個?
看你賣什麼與量體。要賣實體商品、需要超商取貨與代收貨款,綠界一站式是預設起點;想壓費率又不想付年費,藍新可議價且無年費;只收信用卡、重視結帳體驗,TapPay 不跳轉的體驗最順;客群集中在 LINE 生態,加掛 LINE Pay 可提升轉換。多數成熟站台會同時掛兩到三種,而非二選一。
Q3: HPOS 是什麼,為什麼會讓外掛失效?
HPOS 是 WooCommerce 的高效能訂單儲存,從 8.2 版起新安裝預設啟用,把訂單搬到獨立資料表以加快查詢。它採連坐機制,每支經手訂單的外掛都必須主動宣告支援 HPOS,只要一支沒宣告,整站的 HPOS 就會被鎖住無法啟用。所以遷移前要在測試站盤點每支外掛的相容狀態,確認全數綠燈再切換。
Q4: 綠界官方外掛標示只支援到 WP 6.5.8,還能用嗎?
多半還能運作,但不能盲信。官方合併版 ECPay Ecommerce for WooCommerce 的 Tested up to 只標到 WP 6.5.8,而核心已到 7.0,這是台灣官方外掛相容標示落後的常態。正確做法是在測試站跑過完整的下單、付款、回調與退款流程,確認無誤後再上正式站,並定期回頭確認外掛有沒有更新。
Q5: 超商取貨要自己跟每一家超商簽約嗎?
不一定。7-11 交貨便 C2C 可自行申請,但有三邊合計 105 公分的尺寸限制;全家好賣+免抽成但沒有公開 API。如果不想分別簽約與串接,綠界物流整合 API 用單一介面就能接 7-11、全家等多家超商,還內建電子地圖選店、批次印單與貨態回傳,7-11 的 B2C 為 55 元、C2C 為 65 元未稅,是最省維運的一站式解法。
#WooCommerce #金流串接 #物流串接 #綠界 ECPay #台灣電商 #HPOS
~/roamer-tech/newsletter // FREE
// newsletter

訂閱免費電子報

把 AI 自動化、企業系統設計與 WordPress / Laravel 開發的真實案例和可直接照做的技巧,整理成電子報寄給你。只寄精選內容、不灌垃圾信,一鍵就能退訂。

$
// final.exec()

準備好讓你的網站開始為你工作了嗎?