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

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

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

---

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

---

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

---

藍新金流特色與適用場景

藍新 NewebPay 是台灣第二大的第三方支付平台，在功能面跟綠界很接近，但有幾個明顯差異值得你知道。根據金管會統計，2025 年底台灣電子支付使用人數達 3,765 萬（經濟日報, 2025）。根據 ke2b 報告，藍新信用卡含稅費率約 2.8%，且每月享 5 次免費提領（ke2b, 2025）。根據 tenten 報告，台灣行動購物佔電商交易量已達 60%（tenten, 2025），金流體驗在行動端尤其重要。根據 W3Techs 數據，WordPress 驅動全球約 42.5% 的網站（W3Techs, 2026），WooCommerce 的藍新外掛已非常成熟。根據 GlobeNewsWire 報告，台灣 B2C 電商市場 2025 年達 209.7 億美元（GlobeNewsWire, 2026）。

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

但藍新也有不足。支援的付款方式比綠界少（沒有超商條碼繳費），信用卡分期需要額外申請開通，不是預設就有。撥款速度也不太穩定，有時候 7 天入帳，有時候要等到 14 天。

藍新 vs 綠界怎麼選

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

串接前準備工作

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

藍新帳號申請與審核流程

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

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

取得商店代號與 API 金鑰

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

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

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

WooCommerce 環境確認

確認你的 WordPress 網站：

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

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

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

• PayNow for WooCommerce（藍新官方合作開發）
• RY WooCommerce Tools（也支援藍新）

安裝方式跟一般外掛相同：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 的 e-commerce 版和 Web_Design 版，藍新串接相關的討論不少。最常被問到的問題是「為什麼一直 Hash 驗證失敗」和「正式環境跟測試環境怎麼切換」——答案都在上面了。

常見問題 FAQ

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

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

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

A: 信用卡分期需要在藍新後台另外申請，不是預設功能。申請後需要等審核通過，審核時間約 3-5 天。分期期數通常可選 3/6/12 期。

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

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

延伸閱讀

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

---

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

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

👉 加 LINE 免費諮詢

---

---

常見問題

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

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

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

信用卡分期需要在藍新後台另外申請，不是預設功能。申請後需要等審核通過，審核時間約 3-5 天。分期期數通常可選 3/6/12 期。

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

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