kryptogo-pay-query

KryptoGO Payment 交易查詢任務

你的任務是在用戶的專案中實作 KryptoGO Payment 交易查詢功能。

Step 1: 確認需求

用戶輸入: $ARGUMENTS

詢問用戶：

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

   • 單筆 Payment Intent 查詢（客戶查詢、客服查詢）
   • 列表查詢與篩選（批次對帳、管理後台）
   • 支付狀態確認（Webhook 備援方案）

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

   • 確認是否已有 KryptoGO Payment 環境設定

Step 2: 建立查詢功能

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

核心功能:

1. getPaymentIntent(paymentIntentId) - 查詢單筆 Payment Intent
2. listPaymentIntents(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 存在