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
   • 否，需要申請

環境變數設定

引導用戶建立環境變數：

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

指導用戶:

1. 前往 KryptoGO Studio 註冊帳號
2. 在 Account Settings 建立 API Key（僅顯示一次，請妥善保存）
3. 在專案根目錄建立或編輯 .env 檔案
4. 加入上述環境變數
5. 確保 .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 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 確認收到