关于 newebpay-query
用于在项目中实现 NewebPay 交易查询的技能，涵盖单笔订单查询与批次对账，并提供检核码、API 参数及状态说明。
主要功能
- 01实现 SHA256 检核码生成
- 02查询单笔交易状态
- 03支持批次对账场景
- 04提供 API 参数与错误说明
适用场景
- 01在客服页面查询订单状态
- 02安排每日或定时交易对账
- 03通过 NotifyURL 备用流程确认付款
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/newebpay-query确认已加载。
附带文件references/code-examples.md
详细介绍
来自项目 README藍新金流交易查詢任務
你的任務是在用戶的專案中實作藍新金流交易查詢功能。
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 | 退款 |
詳細參考文件
常見錯誤
| 代碼 | 說明 | 解決方式 |
|---|---|---|
| TRA10001 | 查無此筆交易 | 確認訂單編號正確 |
| TRA10002 | CheckValue 檢核錯誤 | 確認參數順序與大小寫 |
| TRA10003 | 時間戳記錯誤 | 確認伺服器時間正確 |
评论
支持 Markdown