Agent skill
kryptogo-pay-query
Implements KryptoGO Payment query functionality for checking payment intent status and listing payment intents. Use when building order status checking, transaction verification, or payment confirmation features for KryptoGO 穩定幣支付.
Install this agent skill to your Project
npx add-skill https://github.com/paid-tw/skills/tree/main/plugins/kryptogo-pay/skills/kryptogo-pay-query
SKILL.md
KryptoGO Payment 交易查詢任務
你的任務是在用戶的專案中實作 KryptoGO Payment 交易查詢功能。
Step 1: 確認需求
用戶輸入: $ARGUMENTS
詢問用戶:
-
查詢情境:需要什麼查詢功能?
- 單筆 Payment Intent 查詢(客戶查詢、客服查詢)
- 列表查詢與篩選(批次對帳、管理後台)
- 支付狀態確認(Webhook 備援方案)
-
專案框架:你使用什麼框架?
- 確認是否已有 KryptoGO Payment 環境設定
Step 2: 建立查詢功能
在現有的支付模組中加入查詢方法,或建立新模組。
核心功能:
getPaymentIntent(paymentIntentId)- 查詢單筆 Payment IntentlistPaymentIntents(filters)- 列出 Payment Intents
Step 3: 實作程式碼
根據框架加入查詢功能。
Step 4: 整合到應用
建議整合方式:
- API 端點:
GET /api/payment/intent/:id - 管理後台: 訂單詳情頁顯示即時狀態
- 定時任務: 對帳排程(輪詢未完成的訂單)
API 參考
查詢單筆 Payment Intent
| 項目 | 說明 |
|---|---|
| 方法 | GET |
| 路徑 | /v1/studio/api/payment/intent/{payment_intent_id} |
| Headers | X-Client-ID, X-STUDIO-API-KEY, Origin |
列出 Payment Intents
| 項目 | 說明 |
|---|---|
| 方法 | GET |
| 路徑 | /v1/studio/api/payment/intents |
| Headers | X-Client-ID, X-STUDIO-API-KEY, Origin |
Payment Status 狀態
| 狀態 | 說明 |
|---|---|
pending |
等待付款 |
success |
付款成功 |
expired |
付款逾時 |
insufficient_not_refunded |
金額不足,等待退款 |
insufficient_refunded |
金額不足,已退款 |
詳細參考文件
- 程式碼範例 (Node.js/Python)
常見錯誤
| 代碼 | 說明 | 解決方式 |
|---|---|---|
| 4001 | Invalid client_id | 確認 X-Client-ID 正確 |
| 4002 | Invalid API key | 確認 X-STUDIO-API-KEY 正確 |
| 4006 | Invalid payment_intent_id | 確認 Payment Intent ID 存在 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
kryptogo-pay-webhook
Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications. Use when building webhook endpoints, handling payment callbacks, or implementing 支付狀態通知 for KryptoGO Payment.
kryptogo-pay
Provides KryptoGO Payment integration overview and guides users to the appropriate skill. Use when starting KryptoGO crypto payment integration, setting up environment, or needing general guidance about KryptoGO 穩定幣支付.
kryptogo-pay-transfer
Implements KryptoGO Payment token transfer/withdrawal functionality using the Asset Pro Transfer API. Use when building withdrawal features, sending tokens to users, or implementing 穩定幣提領轉帳 for KryptoGO Payment.
kryptogo-pay-checkout
Implements KryptoGO Payment checkout integration including Payment Intent creation, React SDK usePayment hook, and Direct API integration. Use when integrating crypto payment, creating checkout flows, or building KryptoGO 穩定幣收款頁面.
payuni-webhook
Implements PAYUNi webhook handling including signature verification, replay attack prevention, and payment status updates. Use when building payment notification endpoints for 統一金流.
payuni-checkout
Implements PAYUNi UPP checkout integration including AES256 encryption, form submission, and payment callback handling. Use when integrating payment gateway, creating checkout flows, or building 統一金流 payment pages.
Didn't find tool you were looking for?