# CDK Bot

> CDK Bot — buy game keys, gift cards, and digital products, built for AI agents. Agent-native REST API for buying digital products (video game keys, gift cards, subscriptions), paid in stablecoins and other crypto (USDC, USDT, EURC) on Base chain (x402 protocol). Zero registration. Instant delivery. Onchain-verified refunds. Built for AI agents and the operators building them.

CDK Bot is infrastructure: agents call our API, we source the product from licensed wholesale distributors, payment is verified onchain, and the key is delivered in a single HTTP response. No accounts, no API keys for browsing, no human checkout flow. Pricing is transparent — every product response includes live competitor prices (G2A / ENEBA / KINGUIN) so an agent can rank by total cost without scraping.

## Quick start for agents

- [Agent discovery manifest](https://api.cdk.bot/.well-known/agent.json): full capability descriptor — endpoints, auth, payment, rate limits, SLAs
- [x402 capability descriptor](https://api.cdk.bot/.well-known/x402): x402-specific service card — payment chains, tokens, paywalled endpoints
- [OpenAPI 3.1 spec](https://api.cdk.bot/openapi.json): machine-readable API schema
- [Interactive docs](https://api.cdk.bot/docs): Swagger UI
- [Health endpoint](https://api.cdk.bot/health): liveness, latency, live trust stats

## MCP server (for Claude Desktop, Cursor, Cline, ChatGPT)

- [MCP endpoint](https://mcp.cdk.bot/mcp): streamable-http transport, zero config, no auth for browsing
- [MCP server card](https://mcp.cdk.bot/.well-known/mcp/server-card.json): SEP-1649 discovery card
- 8 tools: `search_games`, `get_game_details`, `browse_filters`, `get_price_quote`, `confirm_purchase`, `check_order`, `request_refund`, `submit_review`

## Payment

- Stablecoins and other crypto (USDC, USDT, EURC) on Base chain (instant, direct onchain transfer, x402 protocol)
- Human checkout (no code): https://api.cdk.bot/pay?game_id=<id> — connect a wallet on desktop or scan the QR with a mobile wallet, pay USDC, key delivered in-page
- USDC contract on Base: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- Verification: onchain ERC-20 Transfer log parsing via viem, 5 block confirmations
- Quote TTL: 5 minutes (price locked by `quote_id`)
- Sandbox: Base Sepolia testnet, set `"chain": "base-sepolia"` in `POST /purchase`

## Refund policy

- `not_delivered` — auto-approved, instant USDC return
- `key_invalid`, `key_already_redeemed`, `wrong_product` — supplier-verified, 24h SLA
- 30-day dispute window from purchase date
- `POST /refund` with `order_id`, `wallet_address`, `reason`

## Endpoints

- `GET /games` — search and filter the catalog (q, platform, device, region, language, product_type, page, limit)
- `GET /games/match?title=...&platform=...` — smart single-match endpoint (returns best_match + alternatives)
- `GET /games/{id}` — single product details with live marketplace price comparison
- `POST /purchase` — x402 payment flow (402 returns quote, resubmit with tx_hash to deliver key)
- `GET /orders/{id}` — order status, delivery state, key code
- `GET /orders/{id}/receipt` — structured purchase receipt with onchain payment proof
- `POST /refund` — submit refund claim

## Contact

- Website: https://cdk.bot
- Email: info@cdk.bot
- Terms: https://cdk.bot/terms