# Kryptogo Pay

> >

- **Type:** Skill
- **Install:** `agentstack add skill-paid-tw-skills-kryptogo-pay`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [paid-tw](https://agentstack.voostack.com/s/paid-tw)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [paid-tw](https://github.com/paid-tw)
- **Source:** https://github.com/paid-tw/skills/tree/main/plugins/kryptogo-pay/skills/kryptogo-pay

## Install

```sh
agentstack add skill-paid-tw-skills-kryptogo-pay
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# KryptoGO Payment 穩定幣支付整合指南

你的任務是幫助用戶設定 KryptoGO Payment 環境並引導至適當的串接功能。

## 用戶需求分析

用戶輸入: `$ARGUMENTS`

根據用戶需求，判斷下一步：
- 若包含「收款」「checkout」「建立支付」「payment intent」→ 引導使用 `/kryptogo-pay-checkout`
- 若包含「查詢」「query」「訂單狀態」→ 引導使用 `/kryptogo-pay-query`
- 若包含「webhook」「回調」「callback」「通知」→ 引導使用 `/kryptogo-pay-webhook`
- 若包含「提領」「轉帳」「transfer」「withdrawal」→ 引導使用 `/kryptogo-pay-transfer`
- 若無特定指定 → 提供以下環境設定引導

## 環境設定檢查

詢問用戶以下問題：

1. **整合方式**：你要如何串接 KryptoGO Payment？
   - React SDK（前端 `@kryptogo/kryptogokit-sdk-react`）
   - Direct API（後端直接呼叫 REST API）
   - 兩者都要（前端 SDK + 後端 API）

2. **環境狀態**：是否已有 KryptoGO Studio 帳號？
   - 是，已有 Client ID 和 API Key
   - 否，需要申請

## 環境變數設定

引導用戶建立環境變數：

```bash
# 後端 API 整合用
KRYPTOGO_CLIENT_ID=your_client_id
KRYPTOGO_STUDIO_API_KEY=your_studio_api_key
KRYPTOGO_ORIGIN=your_domain
```

**指導用戶:**
1. 前往 [KryptoGO Studio](https://studio.kryptogo.com) 註冊帳號
2. 在 Account Settings 建立 API Key（僅顯示一次，請妥善保存）
3. 在專案根目錄建立或編輯 `.env` 檔案
4. 加入上述環境變數
5. 確保 `.env` 已加入 `.gitignore`

## 快速啟動（Express 範例伺服器）

若用戶希望快速開始：

```bash
npx create-kg-express-test my-app
cd my-app
cp .env.example .env
# 編輯 .env 填入 STUDIO_API_KEY、CLIENT_ID、ORIGIN
npm install && npm start
```

## 下一步

完成環境設定後，根據用戶需求引導：

| 需求 | Skill | 說明 |
|------|-------|------|
| 建立支付收款 | `/kryptogo-pay-checkout` | 建立 Payment Intent 收取穩定幣 |
| 查詢交易狀態 | `/kryptogo-pay-query` | 查詢單筆或列表 Payment Intent |
| 處理 Webhook 回調 | `/kryptogo-pay-webhook` | 接收支付狀態變更通知 |
| 提領/轉帳 | `/kryptogo-pay-transfer` | 將穩定幣轉至外部錢包 |

## API 資訊

| 項目 | 說明 |
|------|------|
| Base URL | `https://wallet.kryptogo.app` |
| API 文件 | `https://www.kryptogo.com/docs/api/payment` |
| Studio | `https://studio.kryptogo.com` |
| 支援代幣 | USDT、USDC（Arbitrum） |
| 支援法幣 | TWD、USD |
| 手續費 | 1% 固定費率 |
| 狀態更新 | 8 秒內（ETH 除外）|
| 最低金額 | fiat_amount >= 0.01 |

## 支援的支付方式

- **KryptoGO Wallet**（推薦）：掃描 QR Code 支付
- **MetaMask / WalletConnect**：瀏覽器錢包或 WalletConnect 連線
- **QR Code 轉帳**：從交易所或其他錢包手動轉帳

## 兩種整合路徑

### 1. React SDK 整合（前端）

適合：需要前端支付 UI 的場景

```bash
npm install @kryptogo/kryptogokit-sdk-react wagmi viem@2.x @tanstack/react-query
```

### 2. Direct API 整合（後端）

適合：純後端服務、自訂前端、跨平台整合

Required Headers:
- `X-Client-ID`: 你的 Client ID
- `X-STUDIO-API-KEY`: 你的 Studio API Key
- `Origin`: 你的網域

## 重要注意事項

1. API Key 必須保密，不可暴露在前端程式碼中
2. 所有 API 呼叫應從後端發起（保護憑證）
3. 目前支援 Arbitrum 鏈上的 USDT/USDC
4. Payment Intent 有效時間為 30 分鐘
5. 回調端點需回應 HTTP 200 確認收到

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [paid-tw](https://github.com/paid-tw)
- **Source:** [paid-tw/skills](https://github.com/paid-tw/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-paid-tw-skills-kryptogo-pay
- Seller: https://agentstack.voostack.com/s/paid-tw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.