File contents 藍新金流交易查詢任務
你的任務是在用戶的專案中實作藍新金流交易查詢功能。
Step 1: 確認需求
用戶輸入: $ARGUMENTS
詢問用戶：
查詢情境 ：需要什麼查詢功能？
單筆訂單查詢（客戶查詢、客服查詢）
批次對帳（每日/定時對帳）
支付狀態確認（NotifyURL 備援）
專案框架 ：你使用什麼框架？
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
時間戳記錯誤
確認伺服器時間正確
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1 --- 2 name: paid-tw-skills-newebpay-query 3 description: 藍新金流交易查詢任務 4 --- 5 6 # 藍新金流交易查詢任務 7 8 你的任務是在用戶的專案中實作藍新金流交易查詢功能。 9 10 ## Step 1: 確認需求 11 12 用戶輸入: `$ARGUMENTS` 13 14 詢問用戶： 15 16 1. **查詢情境**：需要什麼查詢功能？ 17 - 單筆訂單查詢（客戶查詢、客服查詢） 18 - 批次對帳（每日/定時對帳） 19 - 支付狀態確認（NotifyURL 備援） 20 21 2. **專案框架**：你使用什麼框架？ 22 - 確認是否已有 NewebPay 環境設定 23 24 ## Step 2: 建立查詢功能 25 26 在現有的支付模組中加入查詢方法，或建立新模組。 27 28 **核心功能:** 29 1. `generateCheckValue(orderNo, amount)` - 產生 SHA256 檢核碼 30 2. `queryTrade(orderNo, amount)` - 查詢單筆交易 31 32 ## Step 3: 實作程式碼 33 34 根據框架加入查詢功能。 35 36 ## Step 4: 整合到應用 37 38 建議整合方式： 39 - **API 端點**: `GET /api/orders/:orderNo/status` 40 - **管理後台**: 訂單詳情頁顯示即時狀態 41 - **定時任務**: 對帳排程 42 43 --- 44 45 ## API 參考 46 47 ### 端點 48 49 | 環境 | URL | 50 |------|-----| 51 | 測試 | `https://ccore.newebpay.com/API/QueryTradeInfo` | 52 | 正式 | `https://core.newebpay.com/API/QueryTradeInfo` | 53 54 ### 請求參數 55 56 | 參數 | 類型 | 必填 | 說明 | 57 |------|------|:----:|------| 58 | MerchantID | String(15) | ✓ | 商店代號 | 59 | Version | String | ✓ | `1.3` | 60 | RespondType | String | ✓ | `JSON` | 61 | CheckValue | String | ✓ | SHA256 檢核碼 | 62 | TimeStamp | Number | ✓ | Unix timestamp | 63 | MerchantOrderNo | String(30) | ✓ | 商店訂單編號 | 64 | Amt | Number | ✓ | 訂單金額 | 65 66 ### CheckValue 產生規則 67 68 ``` 69 原始字串: IV={HashIV}&Amt={金額}&MerchantID={商店代號}&MerchantOrderNo={訂單編號}&Key={HashKey} 70 結果: SHA256 後轉大寫 71 ``` 72 73 ### TradeStatus 交易狀態 74 75 | 值 | 說明 | 76 |:--:|------| 77 | 0 | 未付款 | 78 | 1 | 已付款 | 79 | 2 | 付款失敗 | 80 | 3 | 已取消 | 81 | 6 | 退款 | 82 83 --- 84 85 ## 詳細參考文件 86 87 - [程式碼範例 (PHP/Node.js)](references/code-examples.md) 88 89 --- 90 91 ## 常見錯誤 92 93 | 代碼 | 說明 | 解決方式 | 94 |------|------|---------| 95 | TRA10001 | 查無此筆交易 | 確認訂單編號正確 | 96 | TRA10002 | CheckValue 檢核錯誤 | 確認參數順序與大小寫 | 97 | TRA10003 | 時間戳記錯誤 | 確認伺服器時間正確 | 98 99 --- 100 > Converted and distributed by [TomeVault](https://tomevault.io/claim/paid-tw) — claim your Tome and manage your conversions. 101 <!-- tomevault:4.0:skill_md:2026-04-11 -->
commit 840759e379
Frequently asked questions How do I install the Paid Tw Skills Newebpay Query skill? Run npx skillmds@latest add tomevault-io/paid-tw-skills-newebpay-query in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Paid Tw Skills Newebpay Query skill do? 藍新金流交易查詢任務 It is listed under Coding & Dev Tools on SkillMD.
Is Paid Tw Skills Newebpay Query safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Paid Tw Skills Newebpay Query? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Paid Tw Skills Newebpay Query free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Paid Tw Skills Newebpay Query? tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io