Skip to main content

​
概覽

帳獸支援與綠界科技（ECPay）整合，自動接收付款通知並建立訂單。設定完成後，當消費者透過綠界科技完成付款，帳獸會自動接收通知、驗證安全性並建立對應的訂單記錄。

​
設定步驟

1

進入綠界金流設定頁面

登入後台，進入 金流設定 > 綠界金流設定。
2

輸入金鑰憑證

輸入你在綠界科技後台取得的 API 金鑰：
欄位說明
MerchantID商店代號
HashKey16 字元金鑰，從綠界商店後台取得
HashIV16 字元金鑰，從綠界商店後台取得
使用綠界科技正式環境的憑證。確認你的綠界帳號已完成商店設定並通過審核。
3

設定 Notify URL

系統會自動產生一組專屬的 Notify URL：
POST https://app.zangsho.com/webhook/ecpay/{your_merchant_code}
將此 URL 設定到你的綠界科技後台的付款完成通知回傳網址。
每個商家都有獨立的 Notify URL，其中 {your_merchant_code} 是你的商家代碼。
4

設定轉發 URL（可選）

如果你希望將綠界的付款通知同時轉發到你自己的伺服器，可以設定轉發 URL。帳獸收到綠界通知後，會將原始資料轉發到你指定的 URL，並附帶以下額外欄位：
{
  "_event": "ecpay.notify",
  "_provider": "ecpay",
  "MerchantID": "...",
  "MerchantTradeNo": "...",
  "TradeNo": "...",
  "TradeAmt": 1990,
  "PaymentType": "Credit_CreditCard",
  "TradeDate": "2026/02/09 08:00:00"
}
轉發失敗時，系統會自動重試最多 3 次（間隔 30 秒 → 60 秒 → 120 秒）。
5

儲存設定

點擊儲存完成設定。

​
自動訂單建立

綠界科技通知到達後，帳獸會自動：
  1. 驗證通知真實性 — 確認通知確實來自綠界科技
  2. 建立或更新訂單 — 根據通知內容自動建立訂單記錄（冪等處理，不會重複建立）
  3. 對應支付方式 — 自動將綠界的 PaymentType 轉換為帳獸的支付方式

​
支付方式對應

綠界 PaymentType帳獸支付方式
Credit_CreditCard信用卡（credit_card）
ATM_*ATM 轉帳（atm）
CVS_*超商繳費（cvs）
ApplePayApple Pay（apple_pay）
綠界的 ATM 與超商繳費有多種子類型（如 ATM_TAISHIN、CVS_CVS），帳獸會統一對應到 atm 和 cvs。

​
模擬付款

當綠界通知中的 SimulatePaid 為 1 時，表示這是一筆模擬付款，帳獸不會更新訂單狀態。模擬付款僅用於測試流程是否正常運作。

​
Notify 記錄

你可以在後台查看所有接收到的綠界科技通知記錄：
  • 記錄保留期限：90 天
  • 篩選條件：可依 provider 篩選（ecpay）
  • 詳情展開：查看完整通知內容與處理結果

​
常見問題

請確認以下事項：
  1. 綠界後台的付款完成通知回傳網址設定正確
  2. 使用 HTTPS 協定
  3. 你的帳獸帳號狀態正常
  4. 綠界的交易確實已完成付款
帳獸會進行冪等處理 — 同一筆訂單編號只會建立一次訂單記錄。重複的通知會被安全忽略。
會。測試環境的交易也會建立訂單記錄（但 SimulatePaid=1 的模擬付款不會更新訂單狀態）。你可以稍後刪除測試資料。

​
下一步

藍新金流

設定藍新金流整合。

自動化整合

使用 n8n 或 Make 串接付款通知建立自動化工作流。