paid-tw 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 - 若無特定指定 → 提供以下環境設定引導
環境設定檢查
詢問用戶以下問題：
整合方式：你要如何串接 KryptoGO Payment？
- React SDK（前端
@kryptogo/kryptogokit-sdk-react） - Direct API（後端直接呼叫 REST API）
- 兩者都要（前端 SDK + 後端 API）
- React SDK（前端
環境狀態：是否已有 KryptoGO Studio 帳號？
- 是，已有 Client ID 和 API Key
- 否，需要申請
環境變數設定
引導用戶建立環境變數：
# 後端 API 整合用
KRYPTOGO_CLIENT_ID=your_client_id
KRYPTOGO_STUDIO_API_KEY=your_studio_api_key
KRYPTOGO_ORIGIN=your_domain
指導用戶:
- 前往 KryptoGO Studio 註冊帳號
- 在 Account Settings 建立 API Key（僅顯示一次，請妥善保存）
- 在專案根目錄建立或編輯
.env檔案 - 加入上述環境變數
- 確保
.env已加入.gitignore
快速啟動（Express 範例伺服器）
若用戶希望快速開始：
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 的場景
npm install @kryptogo/kryptogokit-sdk-react wagmi viem@2.x @tanstack/react-query
2. Direct API 整合（後端）
適合：純後端服務、自訂前端、跨平台整合
Required Headers:
X-Client-ID: 你的 Client IDX-STUDIO-API-KEY: 你的 Studio API KeyOrigin: 你的網域
重要注意事項
- API Key 必須保密，不可暴露在前端程式碼中
- 所有 API 呼叫應從後端發起（保護憑證）
- 目前支援 Arbitrum 鏈上的 USDT/USDC
- Payment Intent 有效時間為 30 分鐘
- 回調端點需回應 HTTP 200 確認收到