# 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 穩定幣支付.

- Skill: `paid-tw/kryptogo-pay-query` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add paid-tw/kryptogo-pay-query`
- Raw SKILL.md: https://api.skillmd.com/api/skills/paid-tw/kryptogo-pay-query/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: paid-tw (https://skillmd.com/u/paid-tw)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/paid-tw/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)](references/code-examples.md)

---

## 常見錯誤

| 代碼 | 說明 | 解決方式 |
|------|------|---------|
| 4001 | Invalid client_id | 確認 `X-Client-ID` 正確 |
| 4002 | Invalid API key | 確認 `X-STUDIO-API-KEY` 正確 |
| 4006 | Invalid payment_intent_id | 確認 Payment Intent ID 存在 |