RY Tools for WooCommerce 綠界金物流串接：從測試模式到正式收單

WooCommerce 裝好了、商品上架了、結帳頁也長得像樣了，但顧客點下「付款」那一刻，網站卻缺少台灣常用的金流、超商物流與電子發票流程。這不是系統故障，而是 WooCommerce 核心不會自動提供每個地區的服務商串接。

台灣商店常需要信用卡、ATM 轉帳、超商代碼繳費、超商取貨付款，以及獨立規劃的電子發票流程。這個落差，正是 RY Tools for WooCommerce 這類在地化外掛存在的理由。設定流程涵蓋外掛安裝、綠界（ECPay）金流與超商物流串接，也會釐清電子發票必須使用另外的對應外掛，避免混淆不同產品的功能。

重點摘述：RY Tools for WooCommerce 是一套免費的 WordPress 外掛，可讓 WooCommerce 串接綠界、藍新與速買配的部分金流、物流服務。核心動作是取得服務商提供的特店資料與金鑰、填入外掛設定，再用測試環境跑完整流程。電子發票不在這套免費外掛內，需另行評估相應的發票外掛與授權。

為什麼 WooCommerce 在台灣需要一座「在地化橋樑」

WooCommerce 與 WordPress 都有成熟的外掛生態。閱讀 W3Techs 的 WooCommerce 統計與 WordPress 統計時，要區分電商技術、已辨識內容管理系統與所有網站的分母。普及程度有助尋找文件與維護資源，但不能代替你的結帳流程測試。

但全球常見的預設整合，不等於符合台灣商店需求。WooCommerce 可用的付款與物流方式會受地區、版本及已安裝擴充影響；台灣商店常另外評估國內信用卡收單、ATM、超商代碼與取貨。缺少顧客需要的方式可能增加結帳阻力，實際影響要看商品與客群。

這個落差要用在地化串接來補。RY Tools for WooCommerce 是其中一套免費、開源且仍有更新的外掛。它的角色不是取代 WooCommerce，而是把綠界（ECPay）、藍新（NewebPay）與速買配（SmilePay）的部分 API，對應成 WooCommerce 的付款與物流模組。如果你還沒決定要用哪一套系統架站，可以先看過我們的 WooCommerce 購物網站架設全攻略，把地基打好再回來這裡。

台灣市場有超商取貨付款、ATM 轉帳與超商代碼等常見選項，但各店實際該開哪些方式，應以商品類型、客群與後台成本判斷。RY Tools for WooCommerce 的價值，是把原本需要自行串接 API 的工作，轉成後台可管理的模組；它不會替你決定付款組合，也不保證開得越多轉換就越高。

RY Tools for WooCommerce 到底做了什麼：一張表看懂它的金物流版圖

很多人把這個外掛裝下去之後，看到一長串設定選項就慌了。其實你若先建立一個心智模型：RY WooCommerce Tools 做的事，就是把服務商的能力，對應成 WooCommerce 的模組。服務商給你信用卡刷卡功能，它就幫你長出一個「信用卡付款」的結帳選項；服務商給你超商取貨物流，它就幫你長出一條「7-11 取貨」的運送方式。

底下這張「能力對應」表，可以幫你在裝外掛之前先掌握全貌：

看懂這張表，你就會明白：RY Tools for WooCommerce 本身不是金流公司、物流公司或發票加值中心，它是一個轉接頭。實際可用的付款與配送方式，取決於服務商、商店合約、外掛版本與當前文件。電子發票則是另一套外掛與服務，不能從這張金物流表直接延伸。

這裡要先和另一篇文章做個分工。我們之前寫過一篇 WooCommerce 綠界金物流串接完整教學，那篇的重點放在「綠界這家服務商」的整體串接邏輯與後台申請流程；而這一篇聚焦在 RY WooCommerce Tools 這個「外掛」本身的設定介面、模組開關、與它的獨特行為。兩篇互補，不重疊。如果你僅想知道綠界怎麼申請，去那篇；如果你已經有綠界帳號、想知道 RY 外掛的欄位怎麼填，留在這裡。

免費外掛、付費外掛、自己刻：三條路怎麼選

台灣商店可以比較 RY 免費版與 Pro、服務商官方模組、其他第三方外掛，以及自行開發的 API 串接。官方模組也可能免費；應依功能、支援方式與維護責任選擇，而不是只看授權價格。

如果你是中小型台灣電商、賣的是實體商品，而且需要外掛目前支援的服務商，免費的 RY Tools for WooCommerce 值得列入測試名單。是否採用，仍要看服務商合約、所需付款物流、結帳區塊相容性與技術支援需求，不能僅用「免費」做決定。

如果你有自建分期邏輯、跨國多幣別、訂閱扣款、ERP 深度整合或特定發票需求，免費外掛的功能可能不夠，這時才比較付費擴充或客製串接。特別要注意：收款、物流與電子發票是三條不同的服務線，RY Tools for WooCommerce 能處理前兩者的部分串接，不代表已經解決發票。

還有一點容易被忽略：免費不代表沒價值。RY 外掛的價值來自作者持續投入的維護心力，以及一整個台灣 WooCommerce 社群共同累積的測試與回報。你能免費用它，是因為這個生態願意共享。理解這一點，你會更願意在遇到問題時回報 issue、回饋社群，而不是把外掛當成理所當然的免洗工具。

四樣東西缺一不可：安裝前的準備清單

安裝前先確認商店、服務商帳號與執行環境是否就緒。這能把帳號未開通、版本不符與外掛故障分開排查：

1. 一個能正常運作的 WooCommerce：商品能上架、結帳頁能開啟。如果連這步都沒完成，先回頭看 WooCommerce 購物網站架設全攻略，或從 WooCommerce 金流物流設定全攻略 確認你已經摸熟原生的付款與運送概念。
2. 一組綠界或藍新的特店帳號與金鑰：包含特店編號（MerchantID）、HashKey、HashIV。沒有這組，外掛裝了也僅是一個空殼。這組資料來自服務商後台，申請與審核流程不在這篇範圍。
3. 全站強制 HTTPS：結帳頁與金鑰傳輸都應使用安全連線，實際服務商要求以其最新技術文件為準。HTTPS 也是網站安全與使用者信任的基本條件。
4. 符合最低版本需求的環境：截至 2026 年 9 月 21 日，官方外掛庫頁面列出的最低需求為 PHP 8.2、WordPress 6.8、WooCommerce 9.0；安裝前仍要以外掛頁最新資訊為準。

四樣都齊了，再往下走。很多人省略準備清單直接裝外掛，然後在設定頁卡半天，其實卡的不是外掛，是某個前置條件漏了。

安裝與啟用：從 WordPress 外掛庫到你家後台

RY Tools for WooCommerce 是 WordPress 官方外掛庫裡的免費外掛，所以安裝方式跟一般外掛相同。如果你對安裝流程還不熟，可以對照 WordPress 外掛安裝教學。

路徑是：後台 → 外掛 → 安裝外掛 → 搜尋「RY Tools for WooCommerce」→ 立即安裝 → 啟用。啟用之後，再依目前版本的 RY Tools 設定頁開啟所需模組。

RY 作者另有 RY City Select for WooCommerce，可依地區資料把 city 欄位改為相依的下拉選單；台灣通常用來選鄉鎮市區。WooCommerce 核心已有台灣縣市資料，不應把兩者混為一談。地址欄位的設定與限制可看 WooCommerce 縣市下拉選單設定教學。

啟用完成後，建議立刻把 RY 外掛排進你網站的維護清單，搭配一套可靠的 WordPress 備份外掛 與 WordPress 資安防護 方案。金流外掛牽涉到交易資料，一旦被入侵或設定被覆寫，後果比一般內容站嚴重得多，備份與資安不是選配。

串接綠界金流：從特店編號到第一筆信用卡測試

這一節是整篇最容易讓人翻車的地方。我會把流程拆得很細，因為細節錯一個字，整條刷卡流程就斷掉。

第一步：找到特店編號與金鑰

登入綠界廠商後台，找到「系統開發管理」或「API 串接」相關頁面（實際路徑以綠界後台為準，版本會更新）。你要抄下三個值：

• 特店編號（MerchantID）：識別服務商帳號，並不是加密金鑰。
• HashKey與HashIV：依該服務的 API 規範用於檢核或加密；請成組使用正確環境與服務的值。

這三組資料務必複製貼上，不要手打。實務上常見的案例是手打少一個字、或前後多了空白，導致簽章驗證失敗，結帳頁跳出「檢查碼不正確」的錯誤訊息，排查半天找不到原因。換句話說，就是一個字元的問題。

第二步：決定你要用測試模式還是正式模式

串接服務商時，應先使用其測試環境（sandbox）與測試資料。測試環境不會真的扣款，適合先把結帳、付款回傳與訂單狀態走完；測試資料與操作方式以綠界當期文件為準，不要把網路文章裡的舊金鑰直接帶到正式站。

把測試模式打開、填入測試資料並儲存，再依綠界文件提供的測試卡號跑一筆訂單。確認付款頁能開啟、服務商回傳成功，且 WooCommerce 訂單狀態依商品類型正確更新為「處理中」或「完成」。這一步僅證明測試通道可用，正式環境仍要另外驗證。

第三步：開啟你要的付款方式

RY WooCommerce Tools 把付款方式拆成多個獨立模組：信用卡、ATM 轉帳、超商代碼、WebATM 等等。每一個都可以單獨開關。你的策略應該是先開你最熟悉、最有把握的那一種（通常是信用卡），把它的測試跑通，再逐一加入其他方式。

不要一次把全部付款方式都打開。一次開全部，出問題時你會分不清是哪個模組壞掉。逐一開、逐一測，是工程上最基本的隔離手法。

第四步：切換到正式模式

測試全通之後，把測試模式關掉、換成正式金鑰，再依服務商規範跑一筆可核對的小額真實訂單。測試環境與正式環境的商店設定、回傳網址與權限可能不同，因此要分別驗證，並在測試後依正常退款與對帳流程處理該筆交易。

如果你同時也用 PayPal 收款，可以參考 WooCommerce PayPal 收款設定教學，把國際付款這條路也接起來，與 RY 的國內金流互補。

信用卡進階功能：先核對服務商、合約與外掛版本

3D Secure、分期與定期扣款涉及收單銀行、服務商合約、商店資格和外掛版本，不能看到服務商有這項產品，就推定免費外掛一定支援。需要這些功能時，先核對 RY Tools 當期設定頁與更新紀錄，再向服務商確認帳號是否開通；訂閱扣款還要檢查是否能和所用的訂閱外掛共同運作。不要自行儲存卡號或把金鑰放進公開文件。

超商取貨與宅配：物流設定怎麼不走冤枉路

物流設定要同時對齊服務商、外掛版本與商店合約。以綠界為例，目前物流選擇指南列有 7-ELEVEN、全家與萊爾富的超商方案，C2C、B2C 與宅配的通路及溫層不同；不要把舊版介面的所有選項都視為已開通。運送方式也要限制可搭配的付款方式。

「超商取貨付款」由顧客取件時付款；「超商取貨不付款」不在門市收取貨款，可搭配已完成的信用卡付款或另行確認入帳的 ATM 等方式。ATM 虛擬帳號開立成功不等於付款成功，先收款的訂單應確認入帳後再出貨。

• 超商取貨付款：使用對應的貨到付款流程，並核對服務商可代收的金額限制。
• 超商取貨不付款：依商店規則提供線上付款方式，出貨前核對實際收款。
• 宅配：是否能代收貨款取決於所選物流與合約，不是所有宅配選項都支援。

設定的時候，RY 外掛會要求你選擇要啟用哪些超商門市來源、寄件方式（店到店、店到店冷鏈等選項視服務商支援而定）。這裡的原則是先開一條你最有經驗的物流，例如僅先做 7-11 取貨，跑通之後再加全家。一次全開，除錯成本會暴增。至於綠界端的服務開通與物流型態核對，這篇後面的排查小節會一併展開。

運費設定與物流介接也要一起驗收。先以 WooCommerce 運送區域限制服務範圍，再設定實際使用的 RY 運送方式與其運費、免運門檻；不要另加一個無法建立物流單的固定運費方式來取代它。區域與計價規劃可參考 WooCommerce 運費設定全攻略，並測試優惠、偏遠地區和不同商品組合。

門店選擇與地址欄位的串接

超商取貨會使用門市選擇器傳回店號與門市資料；這和宅配的縣市、鄉鎮市區地址欄位是不同資料。若有調整結帳表單欄位、使用 RY City Select 或區塊結帳，請測試選店後資料是否保留、訂單是否記錄正確，以及不需要的地址欄位是否仍擋住結帳。RY 官方說明：免費版只支援傳統短代碼結帳；Pro 對區塊結帳僅有限度支援，作者仍建議優先使用傳統結帳。請核對結帳頁是否使用 [woocommerce_checkout]、選店後資料有無保留，再測試付款與物流單。

結帳頁選不到門市：分層排查「沒有授權物流」

先測通一條已開通的物流再擴充。綠界 C2C 是店到店，B2C 是大宗寄倉；RY 免費版與 Pro 的支援範圍不同，B2C 及部分低溫服務列在 Pro 功能中。若出現「沒有授權物流」，先核對帳號服務、物流型態、測試／正式環境與外掛設定，再依錯誤代碼處理；對齊 C2C／B2C 是檢查項目之一，不能保證排除所有原因。

我們在台灣市場協助店家除障時，習慣把「選不到門市」拆成三層：服務商端的授權與契約、外掛端的模組開關、結帳頁前端的元件載入。同一個症狀可能出自任何一層，逐層確認通常比反覆重裝外掛更快找到源頭。四個常見起點如下：

排查順序也有講究：服務商端只需登入後台就能確認，成本最低，先做；外掛端檢查設定頁與運送區域即可；前端元件的問題需要瀏覽器開發者工具，放在尾端處理。修好之後先別急著開放結帳，用測試模式重跑一筆完整的超商取貨訂單，確認地圖出現、門市可選、物流單號產生，三個訊號同時成立，才算真的排除。這筆驗證訂單的單號也順手記進排查紀錄，之後對帳或回溯問題時找得到對應。

四個方向都走完仍排除不了，回到日誌與錯誤代碼。RY 外掛會記錄服務商回傳的原始訊息，對照開發文件的代碼說明，多半能指出問題落在哪一層。建議讓每次排查都留下紀錄：改了什麼、回傳什麼、哪一層已確認正常；之後回報外掛作者或服務商客服，這份紀錄能省去反覆來回確認的時間。

訂單進來之後：寄件流程怎麼走

很多人把物流設定想成「結帳頁的事」，但真正的考驗在訂單成立之後：你要怎麼把貨送出去。若所選服務與外掛版本支援在訂單頁產生物流單，流程大致是這樣：

1. 訂單成立、付款確認（或貨到付款準備出貨）之後，進到該筆訂單的詳情頁。
2. 在 RY 外掛提供的物流區塊，選擇寄件的超商體系與服務類型（店到店、冷鏈等，視服務商支援）。
3. 產生物流單號，外掛會把這筆資料回報給服務商，這時你可以印出寄件單貼在包裹上。
4. 依所選方案寄件或交寄物流中心，再追蹤配送狀態。取貨通知應依包裹抵達門市等實際事件觸發，交寄本身不代表已可取件。

產生物流單失敗時，先查看外掛日誌與服務商回傳碼，核對服務是否開通、收件資料、商品規格、金額及環境設定。不要先假設是額度用完。測試環境可驗證 API 流程；正式寄件、到店、未取退回等實體物流事件仍需依合約與服務商測試規則驗收。

出貨之後還有一個收尾動作：把訂單匯出做財務對帳與出貨紀錄。這牽涉到你怎麼管理訂單資料，可以參考我們的 WooCommerce 訂單匯出與列印教學，把出貨單與對帳流程標準化。金流外掛把錢收進來，物流外掛把貨送出去，但真正讓你的電商營運可長可久的，是這些把資料整理乾淨的後台流程。

退貨與物流異常

超商逾期未取會進入服務商的退件流程。物流狀態與 WooCommerce 訂單狀態是否自動同步，取決於外掛設定與回傳是否成功，不能只看一個狀態就判定退貨完成。請安排聯絡、重新寄送或取消的規則；尚未付款的取貨付款訂單沒有原貨款可退，已收款訂單則另外確認退款。退件與重新寄送的費用依物流合約處理。

電子發票：需要另一套外掛與服務

電子發票應在正式收單前完成規劃，但RY Tools for WooCommerce 免費版與 Pro 版都不包含電子發票功能。以綠界為例，RY 開發者另有 RY ECPay Invoice for WooCommerce；其他加值中心也有各自的外掛與限制。申請、測試與授權要分開處理，不能把安裝金物流外掛當作已完成發票需求；若以其他方式開立，也要確認流程符合商店適用規定。

截至 2026 年 5 月，RY ECPay Invoice 官方頁面說明它是獨立的付費外掛，僅支援特定應稅、含稅售價的 B2C（B2C2B）情境，不支援 WooCommerce 稅金設定與折讓作業；實際限制仍要以購買時的文件為準。先用評估或測試環境確認發票類型、統編、載具、作廢與訂單狀態，再決定是否自動開立。

發票設定和稅務高度相關。商品課不課稅、運費如何處理、是否有免稅或混合稅別，不能僅靠一般外掛教學決定。先向記帳士、會計師或所用加值中心確認適用流程；WooCommerce 稅金設定完整教學可協助理解系統欄位，但不取代稅務意見。

測試模式與上線前檢核表

前面散落提過測試模式，這裡把它收攏成一張可逐項打勾的檢核表。你打算切到正式模式、對外開放結帳之前，對著這份清單走一遍：

通知驗收要區分「沒有觸發」、「沒有成功送出」與「已送出但被拒收或進垃圾信匣」。WordPress 的寄信結果受主機、寄件網域驗證及郵件服務影響；SMTP 或郵件 API 有助提供紀錄與管理發信，但不保證每封進入收件匣。

我們協助店家導入 RY Tools 時，會把這張表壓縮成一條固定順序：先在測試模式跑完一筆信用卡與一筆超商取貨付款，到綠界測試後台核對兩筆進件與物流單號都正確回報，才關閉測試開關、換上正式金鑰。把順序固定下來的好處是，一旦某個環節出狀況，你能立刻判斷問題落在金流、物流還是金鑰這三段裡的哪一段，不必把整條結帳流程從頭重測一次。

RY 系列與必裝外掛的協同：把生態拼起來

RY WooCommerce Tools 很少單獨存在。在一個健康的台灣 WooCommerce 網站裡，它通常和幾類外掛一起工作。我把這個「拼圖」列出來，幫你確認自己沒有缺角：

• 在地化基礎：RY City Select（鄉鎮市區下拉）。先確認核心縣市設定及結帳版本，再評估是否需要。
• SEO：選一套合適的 SEO 外掛管理標題、索引與結構化資料；外掛僅能協助設定，不能保證商品頁排名。如果想擴大必裝清單，看 WordPress 外掛終極推薦清單。
• 必裝電商外掛：從金物流到行銷的完整盤點，參考 WooCommerce 必裝外掛清單，確認 RY 外掛與其他工具不衝突。
• 備份與資安：前面提過，金流網站更需要。
• 發信：SMTP 處理訂單通知。

把職責拆清楚，升級或除錯時才知道該查哪一塊：RY Tools 管支援的金物流串接，電子發票由獨立外掛與加值中心處理，SEO 外掛管相關搜尋設定，備份外掛管災難還原。

常見地雷與升級維護：裝完之後才是真正考驗的開始

一個金流外掛的壽命不是「設定好那一刻」就結束。真正消耗你時間的，是後續的維護。底下是實務上最常被問到的幾個地雷：

HashKey 與 HashIV 貼反或帶空白

遇到檢查碼或簽章驗證失敗，先保留錯誤碼與已遮蔽機密值的日誌。核對 MerchantID、HashKey、HashIV 是否屬於同一服務和環境、複製時是否多了空白，再依 API 文件檢查送出的參數及外掛版本；不要把所有錯誤都歸因於貼錯金鑰。

PHP 版本太舊導致白畫面

外掛的最低需求不一定與 WooCommerce 核心相同。目前 RY 外掛庫列出 PHP 8.2、WordPress 6.8、WooCommerce 9.0；升級前應同時檢查佈景、金物流及其他外掛。先備份並在測試站驗證 PHP 與套件組合，再安排正式站維護。

升級 WooCommerce 後外掛相容性失效

升級前先核對 WooCommerce、RY 與其他擴充的相容版本與更新說明。依官方建議在 staging 測試整套預定更新，確認商品、結帳、付款與物流後，再於正式站執行相同版本組合；第三方外掛若指定升級順序，應以該版本說明為準。

正式環境收不到付款回傳

測試環境正常、正式訂單卻卡住時，先查 RY Tools 與 WooCommerce 記錄，確認服務商有呼叫正確的 ReturnURL／付款通知網址，且該網址能從外部連線。快取、安全外掛、防火牆、SSL 或主機規則都可能擋住回傳；是否需要額外的 IP 設定，應以服務商當期文件與客服回覆為準，不要自行猜測白名單。

訂單狀態卡住不更新

WooCommerce 的「處理中（Processing）」通常代表已付款、等待履約，不是付款失敗。核心沒有一個必然接在它後面的「已付款」狀態。若服務商確認付款，但訂單仍停在待付款或保留，才需比對交易與訂單備註、檢查通知網址和日誌。貨到付款等流程另有狀態規則，實際收款仍以服務商紀錄核對。

結帳頁資源載入拖慢速度

金流外掛可能在結帳頁載入額外的 JavaScript、iframe 與 API 呼叫，例如門市選擇器或支付欄位；實際成本要用瀏覽器與真實裝置量測。web.dev 說明速度會影響使用體驗與商業成效，但沒有「每慢一秒，跳出與轉換必然變動固定幅度」的通則。設定後應實測結帳流程，再依瀑布圖與效能資料處理圖片、未使用腳本及其他瓶頸。

退款流程：不是按一個鈕那麼簡單

退款必須核對實際金流。RY Pro 列有綠界信用卡取消授權／退刷功能；作者另提醒其操作與 WooCommerce 原生訂單項目退款不同。使用前確認所裝版本、付款方式與服務商紀錄，再處理訂單、庫存及發票；單純改成「已退款」不會自動返還款項，入帳時間也不能一概保證。

發票是另一條線。RY ECPay Invoice 官方目前明列不支援折讓作業，若情境需要折讓，要到綠界發票管理系統處理；作廢條件也應依發票狀態與稅務規定確認。建議把退款 SOP 拆成款項、發票、通知與訂單備註四部分，並由熟悉稅務的人員確認順序。

升級之前的備份紀律

前面提過升級要一次僅升一個，這裡補一條更根本的原則：任何升級動作之前，先做完整備份。不僅是檔案，還要包含資料庫，因為金流外掛的設定與交易記錄都存在資料庫裡。備份完成之後，最好在 staging 環境（一份與正式站隔離的測試副本）先跑升級，確認結帳流程沒壞，再動正式站。沒有 staging 環境，至少要在流量離峰時段升級，並準備好回滾方案；萬一升級後結帳壞了，才有復原依據。回復資料庫前也要保留備份後的新訂單、付款與物流紀錄，避免把已發生的交易覆蓋掉。

行動方案：今天就能動手的六步

可以先依下面清單建立最小可驗收流程，再增加付款與物流選項：

1. 盤點前置條件：確認 WooCommerce 正常、有綠界或藍新帳號、全站 HTTPS、PHP 版本符合。任何一項沒過，先補上。
2. 安裝 RY Tools for WooCommerce：從官方外掛庫安裝並啟用，確認環境符合最低需求。
3. 取得特店編號與金鑰：從服務商後台抄下特店編號、HashKey、HashIV，存放在安全的地方（不要存在公開的文件庫裡）。
4. 用測試模式跑通一筆訂單：開測試模式、填測試金鑰、刷測試卡，確認訂單狀態正確更新。
5. 逐一開啟付款與物流方式：每開一種就測一次，再開下一種。電子發票另以對應外掛、授權與服務商流程測試。
6. 切正式模式並完成上線檢核表：換正式金鑰、跑一筆真實小額交易、走完前面那張八項檢核表，然後才對外開放結帳。

RY Tools for WooCommerce 是一座免費的串接橋樑。真正決定流程能否運作的，是服務商帳號與金鑰、網站環境、結帳欄位、運費規則及回傳通知是否彼此吻合；發票則要由另一套服務接上。每次升級後重跑關鍵流程，比把「曾經測通」當成永久保證可靠。

把金物流接通之後，你會發現 WooCommerce 在台灣市場的潛力才剛剛釋放。這篇處理的是「收得到錢、發得出貨」的骨幹；接下來怎麼把商品頁的 SEO 做好、怎麼把轉換率再往上推，就是另一個戰場了。先把今天的六步走完，再回來看下一步。