WordPress 藍新金流串接教學：WooCommerce NewebPay 設定完整步驟

藍新金流的後台比綠界好看很多，報表功能也更實用。但串接的時候？眉角不比綠界少。特別是 Hash Key 和 Hash IV 的填入順序，PTT 上一堆人問「為什麼一直出現 Hash 驗證失敗」，十之八九就是這兩個欄位搞混了。

這篇教學會從藍新帳號申請開始，一路帶你到正式上線收款。我們幫客戶串過的藍新案例也不少，踩過的坑全都整理進來了。

---

重點摘要： 藍新 NewebPay 的 WordPress 串接流程跟綠界類似：安裝外掛 → 填入 API 金鑰（Hash Key + Hash IV + 商店代號）→ 設定回傳網址 → 測試 → 上線。信用卡一次付清手續費 2.8%（含稅），信用卡撥款為交易請款日 +10 日。最常出的錯是 Hash 驗證失敗，通常是金鑰前後多了空格或 Key/IV 填反了。

---

💡 金流串接搞不定？加 LINE 免費諮詢，幫你搞定藍新金流串接。 👉 加 LINE 免費諮詢

---

藍新金流特色與適用場景

藍新 NewebPay 是台灣的第三方支付平台，在功能面跟綠界很接近，但有幾個明顯差異值得你知道。根據藍新官網費率表，藍新一次付清國內信用卡手續費為 2.8%（含稅），提領手續費每筆 NT$10、每月前 5 次免手續費（藍新金流, 2026）。根據 W3Techs 2026 年 10 月數據，WordPress 驅動全球約四成的網站（W3Techs, 2026），WooCommerce 的藍新外掛已非常成熟。根據 GlobeNewsWire 報告，台灣 B2C 電商市場預估 2025 年達 209.7 億美元（GlobeNewsWire, 2026）。

首先，藍新的後台介面現代化很多。帳務報表可以自訂日期範圍匯出，對帳比綠界方便不少。如果你的會計很在意報表品質，藍新會讓他比較開心。

付款與撥款方面，藍新支援的付款方式與綠界各有不同（藍新也提供條碼繳費），撥款天數則依付款方式而定：信用卡為交易請款日 +10 日、ATM 虛擬帳號為付款日 +7 日。

藍新 vs 綠界怎麼選

比較項目	藍新 NewebPay	綠界 ECPay
後台介面	現代化，好用	老舊但堪用
付款方式數量	與綠界各有不同（也有條碼繳費）	與藍新各有不同
信用卡手續費	2.8%（含稅）	2.75%（未稅，另加 5% 營業稅與每筆 1 元處理費，含稅約 2.89%）
撥款速度	信用卡請款日 +10 日、ATM 付款日 +7 日、超商代碼付款日 +10 日	付款後 10 日內
WordPress 外掛	選擇較少	選擇最多
帳務報表	強	普通

如果你已經在猶豫，可以看我們整理的各金流平台完整比較再做決定。

串接前準備工作

串接之前，三個東西必須先到位。

藍新帳號申請與審核流程

1. 到藍新官網（newebpay.com）註冊商店帳號
2. 填寫商店基本資料與營業資訊
3. 提交審核（需要網站網址、身分證明、銀行帳戶）
4. 等待審核通過

個人賣家可以申請，但跟綠界一樣，部分功能會受限。

取得商店代號與 API 金鑰

審核通過後，登入藍新後台：

1. 前往「商店管理 → API 串接」
2. 記下三個關鍵資訊：
   • 商店代號（Merchant ID）
   • Hash Key
   • Hash IV

這三個資訊等等串接要用。認真提醒你：Hash Key 和 Hash IV 不要搞混，它們是不一樣的東西。

WooCommerce 環境確認

確認你的 WordPress 網站：

• WooCommerce 已安裝啟用
• 幣別設定為 TWD
• SSL 憑證已安裝（HTTPS）
• PHP 版本 8.0 以上（藍新官方外掛需求；RY Tools for WooCommerce 需 8.2 以上） 藍新最適合的使用場景其實是「重視帳務報表」的中型電商。如果你的會計每月花兩小時在綠界後台對帳，換到藍新大概只要半小時。帳務效率的差距是我們推薦藍新的主要理由。

第一步：安裝藍新 WooCommerce 金流外掛

藍新的 WordPress 外掛選擇比綠界少，目前比較推薦的有：

• Newebpay Payment（藍新官方外掛）
• RY Tools for WooCommerce（也支援藍新）

安裝方式跟一般外掛相同：WordPress 後台 → 外掛 → 安裝外掛 → 搜尋外掛名稱 → 安裝並啟用。

第二步：API 串接設定

這是整個串接最關鍵的步驟。填錯一個字就會出錯。

Hash Key 與 Hash IV 填入

到 WooCommerce 的付款設定頁面，找到藍新金流的選項，點進去設定：

1. 商店代號（Merchant ID）：從藍新後台複製
2. Hash Key：注意是 Key，不是 IV
3. Hash IV：注意是 IV，不是 Key 我們碰過不下五次客戶把 Hash Key 和 Hash IV 填反了，結果一直跳 Hash 驗證失敗的錯誤。藍新的 Hash Key 為 32 個字元、Hash IV 為 16 個字元，填之前多看一眼就能避免這個低級錯誤。

回傳網址與通知網址設定

這是另一個容易出錯的地方。藍新需要你在後台設定兩個網址：

• 回傳網址（Return URL）：付款完成後消費者跳轉回你網站的頁面
• 通知網址（Notify URL）：藍新用來通知你網站訂單狀態的背景網址

這兩個網址通常由外掛自動生成，你只需要在藍新後台填入外掛提供的網址就好。千萬不要自己亂改。

第三步：付款方式啟用與設定

跟綠界類似，你可以選擇要開啟哪些付款方式。藍新支援：

• 信用卡一次付清
• 信用卡分期
• 超商代碼繳費
• ATM/WebATM
• 超商條碼

建議先開信用卡 + 超商代碼，這兩個涵蓋最多消費者。

---

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

API 串接的眉角很多。如果你不想自己折騰 Hash Key、Hash IV 和回傳網址，直接交給我們處理，省時間也省麻煩。

👉 加 LINE 免費諮詢

---

第四步：測試與正式上線

藍新也有完整的測試環境。測試流程跟綠界類似：

1. 切換到測試模式，填入測試用金鑰
2. 到前台下一張測試訂單
3. 用測試信用卡號完成付款
4. 確認訂單狀態正確更新
5. 把每種付款方式都測過一遍

全部測試通過後，把金鑰換回正式環境，關閉測試模式就能上線了。記得上線後用自己的信用卡下一張小額訂單做最終驗證。

金流串接 API 常見問題排解

Hash 驗證失敗的原因與解法

這是藍新串接最常見的錯誤。可能的原因：

1. Hash Key 和 Hash IV 填反了 — Key 和 IV 長度不同，確認一下
2. 金鑰前後多了空格 — 重新複製一次
3. 用了測試環境的金鑰在正式環境 — 確認環境和金鑰對應
4. API 版本不對 — 確認外掛設定中的 API 版本與藍新後台一致

訂單狀態不同步處理

付款成功但訂單沒更新？排查方式：

1. 檢查通知網址（Notify URL）是否正確
2. 確認安全外掛沒有擋住藍新的回傳請求
3. 查看 WooCommerce 系統日誌有沒有錯誤
4. 到藍新後台確認該筆交易的狀態

PTT 網友常見問題整理

在 PTT 的 Web_Design 版，藍新串接相關的討論不少。最常被問到的問題是「為什麼一直 Hash 驗證失敗」和「正式環境跟測試環境怎麼切換」——答案都在上面了。

常見問題 FAQ

Q: 藍新跟綠界可以同時裝嗎？

A: 可以，但通常沒必要。兩家的核心功能（信用卡、超商代碼）高度重疊。同時裝只會讓結帳頁面變得混亂。除非你有特定原因需要兩家並行，否則選一家就好。

Q: 藍新的分期付款怎麼開通？

A: 依藍新官方外掛說明，使用前須先在藍新註冊會員並申請相關收款服務，待審核通過後即可使用；藍新費率表列出 3、6、12、18、24、30 期的分期手續費。

Q: 藍新串接失敗最常見的原因是什麼？

A: 排名第一是 Hash Key 和 Hash IV 填反或多空格（佔大約 60% 的串接問題）。第二是回傳網址設定錯誤。第三是測試環境和正式環境的金鑰搞混。這三個解決了，90% 的串接問題就不會發生。

延伸閱讀

• 回到金流串接完整攻略
• 也看看綠界串接教學
• 加入 LINE Pay 收款
• 金流搞定了？物流也一起設定

---

加 LINE 免費諮詢，金流串接交給專業的，你專心賣東西

不管是藍新、綠界還是 LINE Pay，GOT YOU DESIGN 幫你從申請到上線一次搞定。

👉 加 LINE 免費諮詢

---

如果你願意，我們陪你一步一步來

先加入 LINE 跟我們聊聊你的狀況，我們會給你適合的建議；也可以直接看看線上課程內容，選擇最適合自己的節奏。

先加入 LINE 聊聊