---

name: newebpay-query description: > Implements NewebPay transaction query functionality using QueryTradeInfo API. Use when building order status checking, transaction verification, or payment confirmation features for 藍新金流. argument-hint: "[查詢情境: 單筆查詢/批次對帳/狀態確認]" context: fork agent: general-purpose disable-model-invocation: true allowed-tools:

• Read
• Write
• Edit
• Bash
• Grep
• Glob user-invocable: true

---

藍新金流交易查詢任務

你的任務是在用戶的專案中實作藍新金流交易查詢功能。

Step 1: 確認需求

用戶輸入: $ARGUMENTS

詢問用戶：

1. 查詢情境：需要什麼查詢功能？

   • 單筆訂單查詢（客戶查詢、客服查詢）
   • 批次對帳（每日/定時對帳）
   • 支付狀態確認（NotifyURL 備援）

2. 專案框架：你使用什麼框架？

   • 確認是否已有 NewebPay 環境設定

Step 2: 建立查詢功能

在現有的支付模組中加入查詢方法，或建立新模組。

核心功能:

1. generateCheckValue(orderNo, amount) - 產生 SHA256 檢核碼
2. queryTrade(orderNo, amount) - 查詢單筆交易

Step 3: 實作程式碼

根據框架加入查詢功能。

Step 4: 整合到應用

建議整合方式：

• API 端點: GET /api/orders/:orderNo/status
• 管理後台: 訂單詳情頁顯示即時狀態
• 定時任務: 對帳排程

---

API 參考

端點

請求參數

CheckValue 產生規則

Copy原始字串: IV={HashIV}&Amt={金額}&MerchantID={商店代號}&MerchantOrderNo={訂單編號}&Key={HashKey}
結果: SHA256 後轉大寫

TradeStatus 交易狀態

---

詳細參考文件

• 程式碼範例 (PHP/Node.js)

---

常見錯誤