藍新金流整合與通知處理

【這篇解決什麼問題】

你要完成藍新金流接入，讓付款通知可自動更新訂單狀態。

【設定重點】

1) 到後台 金流設定 > 藍新金流設定
2) 填入 HashKey（32 字元）與 HashIV（16 字元）
3) 選擇測試或正式環境
4) 使用系統提供的專屬 Webhook URL

【系統處理流程】

• 解密 TradeInfo（AES-128-CBC）
• 驗證 TradeSha（SHA256）
• 以冪等方式建立或更新訂單
• PaymentType 會映射為平台內支付方式

【重要行為】

• 藍新通知處理完成後會回應 HTTP 200，避免重送
• 可設定轉發 URL，把解密後內容轉發到你的系統

【訂閱週期自動偵測】

如果你有啟用 SaaS 指標模組，帳獸會從藍新交易的商品描述（ItemDesc）自動判斷訂閱週期：

• 包含「月繳」「月費」「monthly」→ 月繳
• 包含「季繳」「quarterly」→ 季繳
• 包含「半年繳」「semi-annual」→ 半年繳
• 包含「年繳」「年費」「yearly」「annual」→ 年繳

💡 在藍新的商品描述中加入週期關鍵字（如「專業方案月繳」），帳獸就能自動偵測並正確計算 MRR。

【常見問題】

Q1：為什麼藍新一直重送通知？

先確認你的接收端能穩定回應成功，並檢查網路與簽章驗證流程。

Q2：可以同時保留原始通知與轉發通知嗎？

可以，建議保留稽核紀錄並定期檢視失敗率。

【下一步】

• 若你也用綠界，請看「綠界金流整合與 Notify 驗證」
• 需要通用事件推送請看「Webhook 設定、測試與失敗重試」