Implements NewebPay transaction query functionality using QueryTradeInfo API. Use when building order status checking, transaction verification, or payment confirmation features for 藍新金流.
你的任務是在用戶的專案中實作藍新金流交易查詢功能。
用戶輸入: $ARGUMENTS
詢問用戶：
查詢情境：需要什麼查詢功能？
專案框架：你使用什麼框架？
在現有的支付模組中加入查詢方法，或建立新模組。
核心功能:
generateCheckValue(orderNo, amount) - 產生 SHA256 檢核碼queryTrade(orderNo, amount) - 查詢單筆交易根據框架加入查詢功能。
建議整合方式：
GET /api/orders/:orderNo/status| 環境 | 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 | ✓ | 訂單金額 |
原始字串: IV={HashIV}&Amt={金額}&MerchantID={商店代號}&MerchantOrderNo={訂單編號}&Key={HashKey}
結果: SHA256 後轉大寫
| 值 | 說明 |
|---|---|
| 0 | 未付款 |
| 1 | 已付款 |
| 2 | 付款失敗 |
| 3 | 已取消 |
| 6 | 退款 |
| 代碼 | 說明 | 解決方式 |
|---|---|---|
| TRA10001 | 查無此筆交易 | 確認訂單編號正確 |
| TRA10002 | CheckValue 檢核錯誤 | 確認參數順序與大小寫 |
| TRA10003 | 時間戳記錯誤 | 確認伺服器時間正確 |