RY WooCommerce Tools 教學:綠界金流與物流設定
RY WooCommerce Tools 完整設定教學,帶你把綠界金流與物流串接到 WooCommerce。涵蓋 MerchantID、HashKey、HashIV 介接資料填寫、測試與正式模式切換、超商取貨與宅配物流設定,以及 HashKey 與 HashIV 填寫錯誤的排查解法。
作者:褚崇名(Sliven)
本頁目錄
- 為什麼 WooCommerce 在台灣需要一座「在地化橋樑」
- RY Tools for WooCommerce 到底做了什麼:一張表看懂它的金物流版圖
- 免費外掛、付費外掛、自己刻:三條路怎麼選
- 四樣東西缺一不可:安裝前的準備清單
- 安裝與啟用:從 WordPress 外掛庫到你家後台
- 串接綠界金流:從特店編號到第一筆信用卡測試
- 第一步:找到你的三組金鑰
- 第二步:決定你要用測試模式還是正式模式
- 第三步:開啟你要的付款方式
- 第四步:切換到正式模式
- 信用卡進階功能:先核對服務商、合約與外掛版本
- 超商取貨與宅配:物流設定怎麼不走冤枉路
- 門店選擇與地址欄位的串接
- 訂單進來之後:寄件流程怎麼走
- 退貨與物流異常
- 電子發票:需要另一套外掛與服務
- 測試模式與上線前檢核表
- RY 系列與必裝外掛的協同:把生態拼起來
- 常見地雷與升級維護:裝完之後才是真正考驗的開始
- HashKey 與 HashIV 貼反或帶空白
- PHP 版本太舊導致白畫面
- 升級 WooCommerce 後外掛相容性失效
- 正式環境收不到付款回傳
- 訂單狀態卡住不更新
- 結帳頁資源載入拖慢速度
- 退款流程:不是按一個鈕那麼簡單
- 升級之前的備份紀律
- 行動方案:今天就能動手的六步
WooCommerce 裝好了、商品上架了、結帳頁也長得像樣了,但顧客點下「付款」那一刻,網站卻缺少台灣常用的金流、超商物流與電子發票流程。這不是系統故障,而是 WooCommerce 核心不會自動提供每個地區的服務商串接。
台灣商店常需要信用卡、ATM 轉帳、超商代碼繳費、超商取貨付款,以及獨立規劃的電子發票流程。這個落差,正是 RY Tools for WooCommerce 這類在地化外掛存在的理由。設定流程涵蓋外掛安裝、綠界(ECPay)金流與超商物流串接,也會釐清電子發票必須使用另外的對應外掛,避免混淆不同產品的功能。
重點摘述:RY Tools for WooCommerce 是一套免費的 WordPress 外掛,可讓 WooCommerce 串接綠界、藍新與速買配的部分金流、物流服務。核心動作是取得服務商提供的特店資料與金鑰、填入外掛設定,再用測試環境跑完整流程。電子發票不在這套免費外掛內,需另行評估相應的發票外掛與授權。
為什麼 WooCommerce 在台灣需要一座「在地化橋樑」
先看一個會影響你判斷的事實。WooCommerce 是目前全球市佔最高的電商系統,根據 W3Techs 的統計(2026 年 6 月),它在所有使用電商技術的網站中佔有壓倒性的比例。而它跑在 WordPress 上面,依 W3Techs 的統計(2026 年 6 月),WordPress 本身又吃下全球將近一半的網站市佔。換句話說,你選的技術 stack 是全世界最多人走的那條路,生態成熟、文件多、出問題找得到答案。
但全球常見的預設整合,不等於符合台灣商店需求。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 取貨」的運送方式。
底下這張「能力對應」表,可以幫你在裝外掛之前先掌握全貌:
| 類別 | 服務商提供的能力 | 外掛在 WooCommerce 裡提供什麼 |
|---|---|---|
| 金流 | 信用卡等服務商支援的付款方式 | 結帳頁的「信用卡」付款閘道 |
| 金流 | WebATM / ATM 轉帳 | 結帳頁的「ATM 轉帳」付款閘道 |
| 金流 | 超商代碼繳費 | 結帳頁的「超商代碼繳費」付款閘道 |
| 物流 | 超商取貨付款(7-11/全家/萊爾富/OK) | 結帳頁的「超商取貨付款」運送方式 |
| 物流 | 超商取貨不付款 | 結帳頁的「超商取貨」運送方式 |
| 物流 | 宅配(黑貓/新竹物流等) | 結帳頁的「宅配」運送方式 |
看懂這張表,你就會明白:RY Tools for WooCommerce 本身不是金流公司、物流公司或發票加值中心,它是一個轉接頭。實際可用的付款與配送方式,取決於服務商、商店合約、外掛版本與當前文件。電子發票則是另一套外掛與服務,不能從這張金物流表直接延伸。
這裡要先和另一篇文章做個分工。我們之前寫過一篇 WooCommerce 綠界金物流串接完整教學,那篇的重點放在「綠界這家服務商」的整體串接邏輯與後台申請流程;而這一篇聚焦在 RY WooCommerce Tools 這個「外掛」本身的設定介面、模組開關、與它的獨特行為。兩篇互補,不重疊。如果你僅想知道綠界怎麼申請,去那篇;如果你已經有綠界帳號、想知道 RY 外掛的欄位怎麼填,留在這裡。
免費外掛、付費外掛、自己刻:三條路怎麼選
在你決定用 RY WooCommerce Tools 之前,值得把市面上的三條路放在一起比一比。台灣的 WooCommerce 站長要接上綠界或藍新,大致僅有三個選擇,每一條都有它的代價,僅是代價的形式不同:
| 方案 | 成本 | 優點 | 代價與風險 |
|---|---|---|---|
| RY WooCommerce Tools(免費、開源) | 零授權費 | 原始碼公開,可串接支援的金流與物流服務 | 沒有官方客服、出問題僅能靠 issue 追蹤與社群;功能跟著作者個人的維護節奏走 |
| 服務商官方或第三方的付費外掛 | 年費或一次性授權 | 通常附客服與技術支援、更新較頻繁、有文件 | 要付錢、而且換服務商時可能要整套換掉 |
| 自己寫 API 串接 | 開發人力成本最高 | 完全客製、可控性最高、能做差異化功能 | 維護成本極高、WooCommerce 一改版你就得跟著改、出錯沒人可問 |
如果你是中小型台灣電商、賣的是實體商品,而且需要外掛目前支援的服務商,免費的 RY Tools for WooCommerce 值得列入測試名單。是否採用,仍要看服務商合約、所需付款物流、結帳區塊相容性與技術支援需求,不能僅用「免費」做決定。
如果你有自建分期邏輯、跨國多幣別、訂閱扣款、ERP 深度整合或特定發票需求,免費外掛的功能可能不夠,這時才比較付費擴充或客製串接。特別要注意:收款、物流與電子發票是三條不同的服務線,RY Tools for WooCommerce 能處理前兩者的部分串接,不代表已經解決發票。
還有一點容易被忽略:免費不代表沒價值。RY 外掛的價值來自作者持續投入的維護心力,以及一整個台灣 WooCommerce 社群共同累積的測試與回報。你能免費用它,是因為這個生態願意共享。理解這一點,你會更願意在遇到問題時回報 issue、回饋社群,而不是把外掛當成理所當然的免洗工具。
四樣東西缺一不可:安裝前的準備清單
實務上排查 RY WooCommerce Tools 的問題時,十次有八次不是外掛的錯,而是前置作業沒做好。你可以在動手安裝之前,對著底下這份清單打勾:
- 一個能正常運作的 WooCommerce:商品能上架、結帳頁能開啟。如果連這步都沒完成,先回頭看 WooCommerce 購物網站架設全攻略,或從 WooCommerce 金流物流設定全攻略 確認你已經摸熟原生的付款與運送概念。
- 一組綠界或藍新的特店帳號與金鑰:包含特店編號(MerchantID)、HashKey、HashIV。沒有這組,外掛裝了也僅是一個空殼。這組資料來自服務商後台,申請與審核流程不在這篇範圍。
- 全站強制 HTTPS:結帳頁與金鑰傳輸都應使用安全連線,實際服務商要求以其最新技術文件為準。HTTPS 也是網站安全與使用者信任的基本條件。
- 符合最低版本需求的環境:截至 2026 年 7 月,官方外掛庫頁面列出的最低需求為 PHP 8.2、WordPress 6.8、WooCommerce 9.0;安裝前仍要以外掛頁最新資訊為準。
四樣都齊了,再往下走。很多人省略準備清單直接裝外掛,然後在設定頁卡半天,其實卡的不是外掛,是某個前置條件漏了。
安裝與啟用:從 WordPress 外掛庫到你家後台
RY Tools for WooCommerce 是 WordPress 官方外掛庫裡的免費外掛,所以安裝方式跟一般外掛相同。如果你對安裝流程還不熟,可以對照 WordPress 外掛安裝教學。
路徑是:後台 → 外掛 → 安裝外掛 → 搜尋「RY Tools for WooCommerce」→ 立即安裝 → 啟用。啟用之後,再依目前版本的 RY Tools 設定頁開啟所需模組。
有一個小地方要提醒:RY 作者同時維護另一個叫 RY WC City Select 的外掛,功能是把結帳頁的縣市欄位變成下拉選單(解決台灣地址輸入的麻煩)。這兩個外掛是同一家出品、可以並存,但用途不同。如果你在煩惱地址欄位的問題,直接看我們寫的 WooCommerce 縣市下拉選單設定教學,那篇專門處理這件事。
啟用完成後,建議立刻把 RY 外掛排進你網站的維護清單,搭配一套可靠的 WordPress 備份外掛 與 WordPress 資安防護 方案。金流外掛牽涉到交易資料,一旦被入侵或設定被覆寫,後果比一般內容站嚴重得多,備份與資安不是選配。
串接綠界金流:從特店編號到第一筆信用卡測試
這一節是整篇最容易讓人翻車的地方。我會把流程拆得很細,因為細節錯一個字,整條刷卡流程就斷掉。
第一步:找到你的三組金鑰
登入綠界廠商後台,找到「系統開發管理」或「API 串接」相關頁面(實際路徑以綠界後台為準,版本會更新)。你要抄下三個值:
- 特店編號(MerchantID):一串數字,代表你的店家身分。
- HashKey:加解密用的金鑰,一長串英數字。
- HashIV:加解密用的初始向量,同樣是一長串英數字。
這三組資料務必複製貼上,不要手打。實務上常見的案例是手打少一個字、或前後多了空白,導致簽章驗證失敗,結帳頁跳出「檢查碼不正確」的錯誤訊息,排查半天找不到原因。換句話說,就是一個字元的問題。
第二步:決定你要用測試模式還是正式模式
串接服務商時,應先使用其測試環境(sandbox)與測試資料。測試環境不會真的扣款,適合先把結帳、付款回傳與訂單狀態走完;測試資料與操作方式以綠界當期文件為準,不要把網路文章裡的舊金鑰直接帶到正式站。
把測試模式打開、填入測試資料並儲存,再依綠界文件提供的測試卡號跑一筆訂單。確認付款頁能開啟、服務商回傳成功,且 WooCommerce 訂單狀態依商品類型正確更新為「處理中」或「完成」。這一步僅證明測試通道可用,正式環境仍要另外驗證。
第三步:開啟你要的付款方式
RY WooCommerce Tools 把付款方式拆成多個獨立模組:信用卡、ATM 轉帳、超商代碼、WebATM 等等。每一個都可以單獨開關。你的策略應該是先開你最熟悉、最有把握的那一種(通常是信用卡),把它的測試跑通,再逐一加入其他方式。
不要一次把全部付款方式都打開。一次開全部,出問題時你會分不清是哪個模組壞掉。逐一開、逐一測,是工程上最基本的隔離手法。
第四步:切換到正式模式
測試全通之後,把測試模式關掉、換成正式金鑰,再依服務商規範跑一筆可核對的小額真實訂單。測試環境與正式環境的商店設定、回傳網址與權限可能不同,因此要分別驗證,並在測試後依正常退款與對帳流程處理該筆交易。
如果你同時也用 PayPal 收款,可以參考 WooCommerce PayPal 收款設定教學,把國際付款這條路也接起來,與 RY 的國內金流互補。
信用卡進階功能:先核對服務商、合約與外掛版本
3D Secure、分期與定期扣款涉及收單銀行、服務商合約、商店資格和外掛版本,不能看到服務商有這項產品,就推定免費外掛一定支援。需要這些功能時,先核對 RY Tools 當期設定頁與更新紀錄,再向服務商確認帳號是否開通;訂閱扣款還要檢查是否能和所用的訂閱外掛共同運作。不要自行儲存卡號或把金鑰放進公開文件。
超商取貨與宅配:物流設定怎麼不走冤枉路
物流是台灣電商最在地、也最容易設定混亂的一塊。RY WooCommerce Tools 支援的超商物流涵蓋 7-11、全家、萊爾富、OK 等主要超商,再加上宅配。設定的核心觀念是:物流方式要和付款方式綁定清楚。
最常見的組合是「超商取貨付款」(貨到付款)與「超商取貨不付款」(先刷卡、再到店取貨)。這兩者差別在於付款發生的時機,前者是取貨時在超商付款,後者是結帳時就刷卡完成。RY 外掛讓你分別設定這兩種運送方式,你要做的是:
- 把超商取貨付款的運送方式,對應到「貨到付款」這種延遲付款的邏輯。
- 把超商取貨不付款的運送方式,限定僅能搭配信用卡或 ATM 這類即時付款。
- 宅配通常兩種都支援,看你的營運策略。
設定的時候,RY 外掛會要求你選擇要啟用哪些超商門市來源、寄件方式(店到店、店到店冷鏈等選項視服務商支援而定)。這裡的原則是先開一條你最有經驗的物流,例如僅先做 7-11 取貨,跑通之後再加全家。一次全開,除錯成本會暴增。綠界端的物流型態也要先對齊:超商寄貨分為 C2C(店到店)與 B2C(大宗寄貨),RY 免費版對應的是 C2C 超商取貨,若你在綠界會員專區開通的是 B2C 寄貨,就要評估付費版;外掛端與綠界會員專區「物流型態異動」的設定不一致時,結帳選門市會跳出「沒有授權物流」的錯誤,把兩邊物流類型設成相同即可排除。
另一個關鍵:運費規則。超商取貨通常有固定的運費(或滿額免運),宅配則可能依重量或體積計算。RY 外掛處理的是「物流管道」,但運費本身怎麼算,建議搭配 WooCommerce 原生的運送區域與運送方式來設定,細節可以看我們的 WooCommerce 運費設定全攻略。把運費規則與物流管道分開管理,你的設定才不會越疊越亂。
門店選擇與地址欄位的串接
超商取貨有一個獨特環節:顧客要在結帳時選擇取貨門市。RY 外掛會在結帳頁帶出地圖或門市選擇器,這需要你的結帳表單欄位有正確的對應。如果你用 RY WC City Select 把縣市改成了下拉選單(前面提過的那個兄弟外掛),兩邊的欄位要相容,門市選擇器才不會抓不到地址。地址欄位亂掉是超商物流報錯的主因之一,排查時記得從這裡看起。
訂單進來之後:寄件流程怎麼走
很多人把物流設定想成「結帳頁的事」,但真正的考驗在訂單成立之後:你要怎麼把貨送出去。若所選服務與外掛版本支援在訂單頁產生物流單,流程大致是這樣:
- 訂單成立、付款確認(或貨到付款準備出貨)之後,進到該筆訂單的詳情頁。
- 在 RY 外掛提供的物流區塊,選擇寄件的超商體系與服務類型(店到店、冷鏈等,視服務商支援)。
- 產生物流單號,外掛會把這筆資料回報給服務商,這時你可以印出寄件單貼在包裹上。
- 把包裹交給物流(超商寄送或物流車來收),顧客端會收到取貨通知。
這個流程裡最容易出問題的是「產生物流單失敗」。原因通常是物流單的數量額度用完了(服務商那邊的額度,不是外掛的)、收件地址不在服務範圍、或服務商後台沒開通對應的物流服務。RY 外掛一樣有自己的記錄頁,產生失敗時去那裡看回傳訊息,十之八九能直接定位。出貨這條線,建議你在測試階段就完整跑一次:下單、產生物流單、模擬出貨、模擬取貨。每一環節都摸過,正式營運時才不會手忙腳亂。
出貨之後還有一個收尾動作:把訂單匯出做財務對帳與出貨紀錄。這牽涉到你怎麼管理訂單資料,可以參考我們的 WooCommerce 訂單匯出與列印教學,把出貨單與對帳流程標準化。金流外掛把錢收進來,物流外掛把貨送出去,但真正讓你的電商營運可長可久的,是這些把資料整理乾淨的後台流程。
退貨與物流異常
超商取貨最常見的異常是「取貨逾期」。消費者選了門市卻沒有在期限內去取貨,包裹會被退回。RY 外掛與服務商之間會回傳這個狀態,訂單會標記為退貨或異常,你要有一套處理流程:是要聯絡消費者重新下單、還是直接取消訂單退款。這套流程建議在開賣之前就想清楚,否則第一筆退貨出現時你會現場想規則,對消費者體驗不好。退貨物流也是一條真實的成本,超商退件通常會產生費用,這個成本要算進你的商品定價裡,不能假裝它不存在。
電子發票:需要另一套外掛與服務
電子發票應在正式收單前完成規劃,但RY Tools for WooCommerce 免費版與 Pro 版都不包含電子發票功能。以綠界為例,RY 開發者另有 RY ECPay Invoice for WooCommerce;其他加值中心也有各自的外掛與限制。申請、測試與授權要分開處理,不能只裝 RY Tools 這套金物流外掛就開賣。
截至 2026 年 5 月,RY ECPay Invoice 官方頁面說明它是獨立的付費外掛,僅支援特定應稅、含稅售價的 B2C(B2C2B)情境,不支援 WooCommerce 稅金設定與折讓作業;實際限制仍要以購買時的文件為準。先用評估或測試環境確認發票類型、統編、載具、作廢與訂單狀態,再決定是否自動開立。
發票設定和稅務高度相關。商品課不課稅、運費如何處理、是否有免稅或混合稅別,不能僅靠一般外掛教學決定。先向記帳士、會計師或所用加值中心確認適用流程;WooCommerce 稅金設定完整教學可協助理解系統欄位,但不取代稅務意見。
測試模式與上線前檢核表
前面散落提過測試模式,這裡把它收攏成一張可逐項打勾的檢核表。你打算切到正式模式、對外開放結帳之前,對著這份清單走一遍:
| # | 檢核項目 | 怎麼確認 |
|---|---|---|
| 1 | HTTPS 全站生效 | 用無痕視窗開你的結帳頁,網址列是鎖頭、沒有混合內容警告 |
| 2 | 測試模式已跑通一筆完整訂單 | 測試卡刷過、訂單狀態正確更新、後台有交易記錄 |
| 3 | 正式金鑰已填入且儲存 | 特店編號、HashKey、HashIV 三組都來自正式環境、沒有殘留測試值 |
| 4 | 正式環境跑一筆真實小額交易 | 用自己的卡刷最低金額,確認款項真的進來 |
| 5 | 付款與物流的搭配合理 | 超商取貨付款不會要求先刷卡、超商取貨不付款一定搭配即時付款 |
| 6 | 獨立的發票外掛與服務已測試 | 確認授權、適用稅別、買受人資料、載具與作廢流程都正確 |
| 7 | 訂單通知信件正常寄出 | 顧客收到訂單確認信、你收到新訂單通知(必要時設定 WordPress SMTP 發信) |
| 8 | 訂單資料可匯出備份 | 確認能正常匯出訂單做財務對帳,參考 WooCommerce 訂單匯出與列印教學 |
這份清單不是官僚流程,每一項背後都是實務上實際會踩到的坑。例如第 7 項,很多人不知道 WordPress 預設的寄信方式極不穩定,訂單通知信被丟進垃圾信箱或根本沒寄出,顧客以為沒下單成功又重複下單,製造一堆幽靈訂單。把 SMTP 設好,是金流之外最值得優先處理的基礎建設。
RY 系列與必裝外掛的協同:把生態拼起來
RY WooCommerce Tools 很少單獨存在。在一個健康的台灣 WooCommerce 網站裡,它通常和幾類外掛一起工作。我把這個「拼圖」列出來,幫你確認自己沒有缺角:
- 在地化基礎:RY WC City Select(縣市下拉)。和 RY Tools 同一家,專門解地址欄位問題。
- SEO:選一套合適的 SEO 外掛管理標題、索引與結構化資料;外掛僅能協助設定,不能保證商品頁排名。如果想擴大必裝清單,看 WordPress 外掛終極推薦清單。
- 必裝電商外掛:從金物流到行銷的完整盤點,參考 WooCommerce 必裝外掛清單,確認 RY 外掛與其他工具不衝突。
- 備份與資安:前面提過,金流網站更需要。
- 發信:SMTP 處理訂單通知。
把職責拆清楚,升級或除錯時才知道該查哪一塊:RY Tools 管支援的金物流串接,電子發票由獨立外掛與加值中心處理,SEO 外掛管相關搜尋設定,備份外掛管災難還原。
常見地雷與升級維護:裝完之後才是真正考驗的開始
一個金流外掛的壽命不是「設定好那一刻」就結束。真正消耗你時間的,是後續的維護。底下是實務上最常被問到的幾個地雷:
HashKey 與 HashIV 貼反或帶空白
這是最經典的新手錯誤。症狀是結帳頁一直跳「檢查碼不正確」或「簽章驗證失敗」。排查方法很樸素:回去綠界後台重新複製一次,貼進 RY 設定頁時注意前後不要有空白,儲存後再測一筆。一字之差,就是通與不通的差別。
PHP 版本太舊導致白畫面
RY 外掛跟著 WooCommerce 的需求走,WooCommerce 又持續拉高 PHP 最低版本。如果你的主機還跑著很舊的 PHP,升級 WooCommerce 或 RY 外掛之後,可能會遇到致命錯誤、整個後台白畫面。解法是把主機 PHP 升到 WooCommerce 當前要求的版本,這通常是主機後台一個選項的事。
升級 WooCommerce 後外掛相容性失效
WooCommerce 每次大改版都可能動到金流外掛依賴的 hook。升級之前,先看 RY 外掛的更新記錄,確認它已支援新版 WooCommerce。升級的時候也要一次僅升一個:先升 WooCommerce、測試;再升 RY 外掛、測試。一次把所有東西都升級,壞了你根本不知道是誰害的。
正式環境收不到付款回傳
測試環境正常、正式訂單卻卡住時,先查 RY Tools 與 WooCommerce 記錄,確認服務商有呼叫正確的 ReturnURL/付款通知網址,且該網址能從外部連線。快取、安全外掛、防火牆、SSL 或主機規則都可能擋住回傳;是否需要額外的 IP 設定,應以服務商當期文件與客服回覆為準,不要自行猜測白名單。
訂單狀態卡住不更新
顧客付了錢,訂單卻停在「處理中」沒有變成「已付款」。這通常是服務商回傳的交易通知沒有被正確接收,原因可能是 SSL 問題、外掛衝突、或回傳網址被安全外掛擋掉。RY 外掛有自己的交易記錄頁,先去那裡看回傳訊息,通常就能定位問題。
結帳頁資源載入拖慢速度
金流外掛可能在結帳頁載入額外的 JavaScript、iframe 與 API 呼叫,例如門市選擇器或支付欄位;實際成本要用瀏覽器與真實裝置量測。web.dev 說明速度會影響使用體驗與商業成效,但沒有「每慢一秒,跳出與轉換必然變動固定幅度」的通則。設定後應實測結帳流程,再依瀑布圖與效能資料處理圖片、未使用腳本及其他瓶頸。
退款流程:不是按一個鈕那麼簡單
退款不僅是把 WooCommerce 訂單改成「已退款」。外掛是否能從後台發起退款、可退款期限與入帳時間,都取決於付款方式、服務商和目前版本;正式操作前要先跑一次服務商文件中的退款流程。退款完成時間由收單機構、發卡銀行與請款狀態決定,應把可查證的處理進度告知消費者,不要承諾固定天數。
發票是另一條線。RY ECPay Invoice 官方目前明列不支援折讓作業,若情境需要折讓,要到綠界發票管理系統處理;作廢條件也應依發票狀態與稅務規定確認。建議把退款 SOP 拆成款項、發票、通知與訂單備註四部分,並由熟悉稅務的人員確認順序。
升級之前的備份紀律
前面提過升級要一次僅升一個,這裡補一條更根本的原則:任何升級動作之前,先做完整備份。不僅是檔案,還要包含資料庫,因為金流外掛的設定與交易記錄都存在資料庫裡。備份完成之後,最好在 staging 環境(一份與正式站隔離的測試副本)先跑升級,確認結帳流程沒壞,再動正式站。沒有 staging 環境,至少要在流量離峰時段升級,並準備好回滾方案;萬一升級後結帳壞了,才能快速還原。
行動方案:今天就能動手的六步
讀到這裡,你可能覺得資訊量很大。沒關係,我把它收斂成一份你可以今天就開始執行的清單。不需要一次做完,但照這個順序走,你不會走冤枉路:
- 盤點前置條件:確認 WooCommerce 正常、有綠界或藍新帳號、全站 HTTPS、PHP 版本符合。任何一項沒過,先補上。
- 安裝 RY Tools for WooCommerce:從官方外掛庫安裝並啟用,確認環境符合最低需求。
- 取得三組金鑰:從服務商後台抄下特店編號、HashKey、HashIV,存放在安全的地方(不要存在公開的文件庫裡)。
- 用測試模式跑通一筆訂單:開測試模式、填測試金鑰、刷測試卡,確認訂單狀態正確更新。
- 逐一開啟付款與物流方式:每開一種就測一次,再開下一種。電子發票另以對應外掛、授權與服務商流程測試。
- 切正式模式並完成上線檢核表:換正式金鑰、跑一筆真實小額交易、走完前面那張八項檢核表,然後才對外開放結帳。
RY Tools for WooCommerce 是一座免費的串接橋樑。真正決定流程能否運作的,是服務商帳號與金鑰、網站環境、結帳欄位、運費規則及回傳通知是否彼此吻合;發票則要由另一套服務接上。每次升級後重跑關鍵流程,比把「曾經測通」當成永久保證可靠。
把金物流接通之後,你會發現 WooCommerce 在台灣市場的潛力才剛剛釋放。這篇處理的是「收得到錢、發得出貨」的骨幹;接下來怎麼把商品頁的 SEO 做好、怎麼把轉換率再往上推,就是另一個戰場了。先把今天的六步走完,再回來看下一步。
常見問題
RY WooCommerce Tools 免費版跟付費版有什麼不同?
綠界金流的測試模式跟正式模式怎麼切換?
為什麼結帳選超商門市會出現「沒有授權物流」?
HashKey 與 HashIV 填了卻一直報簽章驗證失敗,怎麼排查?
操作步驟
- 安裝並啟用 RY WooCommerce Tools 外掛(路徑:後台 → 外掛 → 安裝外掛 → 搜尋「RY WooCommerce Tools」→ 立即安裝 → 啟用)。
- 從綠界或藍新後台取得特店編號(MerchantID)、HashKey、HashIV 三組介接資料。
- 到 WooCommerce 設定裡的 RY 專屬分頁,勾選要串接的金物流商(綠界/藍新)。
- 開啟測試模式,填入測試介接資料(MerchantID/HashKey/HashIV),用測試信用卡跑一筆刷卡流程,確認訂單狀態正確更新、後台有交易記錄。
- 逐一開啟付款與物流方式,從信用卡開始,每開一種就測一次,再開下一種。
- 關閉金流與物流測試模式開關,換成正式介接資料,照驗收清單逐項打勾後下一筆小額真實訂單驗收上線。