newebpay-query

newebpay-query 技能為 AI 開發助理提供了一個標準化工作流程，用於將藍新金流的交易查詢功能整合至現有的支付模組中。此工具專為開發電商平台、支付閘道或商家後台的工程師設計，協助其解決訂單狀態同步、交易驗證及自動化對帳的難題。透過自動化處理 QueryTradeInfo API 的實作，能確保支付資料的準確性與系統穩定性。

• 提供明確的實作架構，包含如何利用 HashKey 與 HashIV 產生符合規格的 SHA256 CheckValue 檢核碼。

• 內建標準化的請求建構邏輯，包含參數封裝、時間戳記 (TimeStamp) 管理以及 JSON 回應處理。

• 支援多種整合情境，包括 API 即時狀態檢查、前端訂單歷史查詢，以及後台排程自動化對帳。

• 簡化常見 API 錯誤的排除流程，涵蓋交易查無此筆 (TRA10001)、檢核碼錯誤 (TRA10002) 與時間戳記誤差 (TRA10003) 的處理建議。

• 使用者需確保環境變數中正確設定了 NEWEBPAY_MERCHANT_ID、NEWEBPAY_HASH_KEY 與 NEWEBPAY_HASH_IV。

• 此工具適用於測試與正式環境，包含自動切換機制，可彈性連接測試站點 (ccore.newebpay.com) 或正式站點 (core.newebpay.com)。

• 核心輸入包含商店訂單編號 (MerchantOrderNo) 與訂單金額 (Amt)，兩者均為產生強制性 CheckValue 的關鍵參數。

• 輸出資訊包含交易狀態 (TradeStatus)，例如 0 為未付款、1 為已付款、2 為失敗、3 為已取消、6 為退款，可直接用於更新後端訂單資料庫。