KryptoGO Payment Skills

AI Coding Agent skills for integrating KryptoGO Payment — accept USDT/USDC stablecoin payments with a single prompt.

Works with Claude Code, Cursor, Codex, GitHub Copilot, and other AI coding agents.

What is KryptoGO Payment?

KryptoGO Payment is a stablecoin payment infrastructure that lets any application accept crypto payments. Instead of dealing with volatile cryptocurrencies, your customers pay with stablecoins (USDT/USDC) while you price in fiat (TWD/USD).

Key features:

• Stablecoin checkout — Accept USDT/USDC on Arbitrum, priced in TWD or USD
• Real-time status — Payment confirmed within 8 seconds
• Webhook notifications — Instant status updates pushed to your backend
• Token transfers — Withdraw or distribute tokens with one API call
• 1% flat fee — Transparent pricing, no hidden costs
• Multiple wallets — KryptoGO Wallet, MetaMask, WalletConnect, QR code transfer

Getting Started

Step 1: Create a KryptoGO Account

1. Go to KryptoGO Studio and sign up
2. Create a new organization — this is your workspace for managing payments

Step 2: Get Your Client ID

After creating your organization:

1. Your Client ID is visible in the organization dashboard
2. The Client ID identifies your application in both the frontend SDK and API calls

Step 3: Generate an API Key

1. Navigate to User Setting → Account Setting in Studio
2. Click Create API Key
3. Enter a name (e.g., "Production Server") and optional description
4. Click Create

Important: Your API key is displayed only once. Copy and store it securely. If lost, you'll need to create a new one.

Step 4: Configure Environment Variables

Create a .env file in your project root:

KRYPTOGO_CLIENT_ID=your_client_id
KRYPTOGO_STUDIO_API_KEY=your_api_key
KRYPTOGO_ORIGIN=your_domain

Security: Always add .env to .gitignore. Never expose your API key in client-side code. All API calls with the API key should be made from your server.

Step 5: Install the Skills

# Install all KryptoGO Payment skills
npx skills add kryptogo/kryptogo-payment-skill

# Or install selectively
npx skills add kryptogo/kryptogo-payment-skill --skill kryptogo-pay

# List available skills
npx skills add kryptogo/kryptogo-payment-skill --list

Step 6: Start Building

Tell your AI agent what you need:

> Help me integrate KryptoGO stablecoin payments
> /kryptogo-pay-checkout
> I need a USDT checkout page for my e-commerce app

Available Skills

Skill	Description	When to Use
/kryptogo-pay	Overview & environment setup	First-time setup, general guidance
/kryptogo-pay-checkout	Create Payment Intents	Accept payments, build checkout flows
/kryptogo-pay-query	Query Payment Intents	Check payment status, reconciliation
/kryptogo-pay-webhook	Handle webhook callbacks	Receive real-time payment notifications
/kryptogo-pay-transfer	Transfer tokens	Withdrawals, payouts, token distribution

Trigger Keywords

AI agents will automatically load the relevant skill when you mention:

Skill	Keywords
kryptogo-pay	KryptoGO, stablecoin payment, crypto payment
kryptogo-pay-checkout	KryptoGO checkout, create payment, payment intent
kryptogo-pay-query	KryptoGO query, payment status
kryptogo-pay-webhook	KryptoGO webhook, callback, notification
kryptogo-pay-transfer	KryptoGO transfer, withdrawal, payout

Integration Paths

Path A: React SDK (Frontend)

Best for apps that need a payment UI. The SDK provides a usePayment hook and pre-built payment modal.

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

import { usePayment } from '@kryptogo/payment';

function PayButton() {
  const { openPaymentModal, isSuccess, txHash } = usePayment();

  return (
    <button onClick={() => openPaymentModal({
      fiat_amount: '10',
      fiat_currency: 'USD',
      callback_url: 'https://your-server.com/webhook',
      order_data: { order_id: '12345' },
    })}>
      Pay $10 USD
    </button>
  );
}

Path B: Direct API (Backend)

Best for server-to-server integrations, custom frontends, or cross-platform apps.

curl -X POST https://wallet.kryptogo.app/v1/studio/api/payment/intent \
  -H 'Content-Type: application/json' \
  -H 'X-Client-ID: YOUR_CLIENT_ID' \
  -H 'Origin: YOUR_DOMAIN' \
  -H 'X-STUDIO-API-KEY: YOUR_API_KEY' \
  -d '{"fiat_amount":"10.0","fiat_currency":"USD"}'

Path C: Quick Start (Express Template)

Get a working backend in 60 seconds:

npx create-kg-express-test my-app
cd my-app
cp .env.example .env
# Edit .env with your credentials
npm install && npm start

Pre-configured endpoints:

• POST /api/payment/intent — Create payment
• GET /api/payment/intent/:id — Check status
• GET /api/payment/intents — List all payments
• POST /api/asset_pro/transfer — Transfer tokens

Payment Flow

Create Payment Intent → User connects wallet → Select token → Confirm payment → On-chain confirmation → Webhook notification

Payment Statuses

Status	Description
pending	Waiting for user payment
success	Payment received and confirmed on-chain
expired	30-minute payment window closed
insufficient_not_refunded	Amount too low, pending refund
insufficient_refunded	Insufficient amount refunded

API Reference

Method	Endpoint	Description
POST	/v1/studio/api/payment/intent	Create a Payment Intent
GET	/v1/studio/api/payment/intent/{id}	Get a specific Payment Intent
GET	/v1/studio/api/payment/intents	List all Payment Intents
POST	/v1/studio/api/asset_pro/transfer	Transfer tokens

Base URL: https://wallet.kryptogo.app

Required Headers

Header	Description
X-Client-ID	Your Client ID
X-STUDIO-API-KEY	Your Studio API Key
Origin	Your domain
Content-Type	application/json

Supported Tokens & Chains

Chain	Token	Contract Address
Arbitrum	USDT	0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9
Arbitrum	USDC	0xff970a61a04b1ca14834a43f5de4533ebddb5cc8

More chains and tokens coming soon.

FAQ

Question	Answer
What are the fees?	Flat 1% per transaction
How fast is confirmation?	Within 8 seconds on Arbitrum
What fiat currencies are supported?	TWD and USD
What's the minimum amount?	0.01 in fiat currency
Are there withdrawal limits?	No limits currently
How do I reconcile?	Via KryptoGO Studio dashboard or API

Resources

• KryptoGO Website
• KryptoGO Studio
• API Documentation
• SDK Documentation

License

MIT

---

Built by KryptoGO