藍新金流交易查詢任務
你的任務是在用戶的專案中實作藍新金流交易查詢功能。
Step 1: 確認需求
用戶輸入: $ARGUMENTS
詢問用戶：
查詢情境：需要什麼查詢功能？
-
單筆訂單查詢（客戶查詢、客服查詢）
-
批次對帳（每日/定時對帳）
-
支付狀態確認（NotifyURL 備援）
專案框架：你使用什麼框架？
- 確認是否已有 NewebPay 環境設定
Step 2: 建立查詢功能
在現有的支付模組中加入查詢方法，或建立新模組。
核心功能:
-
generateCheckValue(orderNo, amount)
-
產生 SHA256 檢核碼
-
queryTrade(orderNo, amount)
-
查詢單筆交易
Step 3: 實作程式碼
根據框架加入查詢功能。
Step 4: 整合到應用
建議整合方式：
-
API 端點: GET /api/orders/:orderNo/status
-
管理後台: 訂單詳情頁顯示即時狀態
-
定時任務: 對帳排程
API 參考
端點
環境 URL
測試 https://ccore.newebpay.com/API/QueryTradeInfo
正式 https://core.newebpay.com/API/QueryTradeInfo
請求參數
參數 類型 必填 說明
MerchantID String(15) ✓ 商店代號
Version String ✓ 1.3
RespondType String ✓ JSON
CheckValue String ✓ SHA256 檢核碼
TimeStamp Number ✓ Unix timestamp
MerchantOrderNo String(30) ✓ 商店訂單編號
Amt Number ✓ 訂單金額
CheckValue 產生規則
原始字串: IV={HashIV}&Amt={金額}&MerchantID={商店代號}&MerchantOrderNo={訂單編號}&Key={HashKey} 結果: SHA256 後轉大寫
TradeStatus 交易狀態
值 說明
0 未付款
1 已付款
2 付款失敗
3 已取消
6 退款
詳細參考文件
- 程式碼範例 (PHP/Node.js)
常見錯誤
代碼 說明 解決方式
TRA10001 查無此筆交易 確認訂單編號正確
TRA10002 CheckValue 檢核錯誤 確認參數順序與大小寫
TRA10003 時間戳記錯誤 確認伺服器時間正確