curl https://coindonate.uz/api/v1/account \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "account": {
    "id": 6,
    "name": "My Game Shop",
    "email": "[email protected]",
    "api_enabled": true,
    "balance_usd": 39.12,
    "balance_uzs": 481200,
    "retail_markup_pct": 15.0,
    "personal_discount_pct": 0.0,
    "total_discount_pct": 3.0,
    "has_validator": true
  },
  "tariffs": [
    {
      "plan": "Reseller",
      "kind": "reseller",
      "period": "1m",
      "status": "active",
      "validator_access": false,
      "discount_pct": 3.0,
      "expires_at": "2026-08-04T10:00:00"
    }
  ],
  "usd_to_uzs": 12300.0
}

curl https://coindonate.uz/api/v1/balance \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "balance_usd": 39.12,
  "balance_uzs": 481200,
  "name": "My Game Shop"
}

curl https://coindonate.uz/api/v1/games \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "games": [
    {
      "key": "pubg-mobile",
      "name": "PUBG Mobile",
      "image_url": "https://coindonate.uz/...",
      "category": "mobile",
      "popular": true,
      "id_type": "numeric",
      "id_label": "Player ID",
      "amount_based": false,
      "requires_server": false,
      "server_label": "",
      "has_validator": false
    },
    {
      "key": "mobile-legends",
      "name": "Mobile Legends",
      "id_type": "numeric",
      "id_label": "Player ID",
      "amount_based": false,
      "requires_server": true,
      "server_label": "Server ID",
      "has_validator": true
    },
    {
      "key": "telegram-stars",
      "name": "Telegram Stars",
      "id_type": "text",
      "id_label": "Telegram username",
      "amount_based": true,
      "requires_server": false,
      "has_validator": true
    }
  ]
}

curl https://coindonate.uz/api/v1/gifts \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "gifts": [
    {
      "gift_id": 5170145012310081615,
      "emoji": "💝",
      "custom_emoji_id": "5465263910414195580",
      "stars": 15,
      "limited": false,
      "price_usd": 0.2364,
      "price_uzs": 2900.0,
      "min_purchase_stars": 50
    }
  ]
}

curl -X POST https://coindonate.uz/api/v1/gifts/send \
  -H "X-API-Key: cd_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "gift_id": 5170145012310081615,
    "player_id": "devsardor",
    "external_ref": "your-order-id-123",
    "notification_url": "https://your-site.com/webhook"
  }'

{
  "success": true,
  "order_id": 82,
  "status": "delivered",
  "game_key": "gift",
  "product_name": "🎁 Gift (25⭐)",
  "recipient": "devsardor",
  "gift_stars": 25,
  "stars_bought": 50,        # 0 = sent free from pool
  "charged_usd": 0.788,      # 0 when sent from pool
  "charged_uzs": 9600.0,
  "message": "Gift delivered"
}

{
  "success": true, "dry_run": true, "status": "validated",
  "gift_stars": 25, "pool_stars": 20,
  "will_buy_stars": 50, "would_charge_usd": 0.788, "would_charge_uzs": 9600.0,
  "balance_usd": 3746.5
}

400  no connected account (connect one in dashboard → Gift akkaunt)
400  connected account has no @username (required to buy stars)
404  gift not found / sold out
422  insufficient balance

curl https://coindonate.uz/api/v1/games/pubg-mobile/products \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "products": [
    {
      "id": "12345",
      "name": "60 UC",
      "amount": null,
      "price_usd": 0.9208,
      "price_uzs": 11300,
      "retail_usd": 1.0589,
      "retail_uzs": 13000,
      "image": "/api/product-img/xxx.webp"
    }
  ],
  "meta": {
    "id_type": "numeric",
    "id_label": "Player ID",
    "amount_based": false,
    "requires_server": false,
    "server_label": "",
    "has_validator": false
  }
}

{
  "success": true,
  "products": [
    { "id": "amt_50",  "name": "50 Stars",  "amount": 50,
      "price_usd": 0.788, "price_uzs": 9700,  "retail_usd": 0.9062, "retail_uzs": 11100 },
    { "id": "amt_100", "name": "100 Stars", "amount": 100,
      "price_usd": 1.576, "price_uzs": 19400, "retail_usd": 1.812, "retail_uzs": 22300 }
  ],
  "meta": { "id_type": "text", "id_label": "Telegram username", "amount_based": true,
            "requires_server": false, "has_validator": true }
}

curl -X POST https://coindonate.uz/api/v1/games/mobile-legends/validate \
  -H "X-API-Key: cd_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "player_id": "123456789", "server_id": "2345" }'

{
  "success": true,
  "valid": true,
  "player_id": "123456789",
  "username": "PlayerNick",
  "premium": false
}

{
  "success": false,
  "valid": false,
  "message": "Player not found"
}

curl https://coindonate.uz/api/v1/orders/142 \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "order": {
    "id": 142,
    "game_key": "pubg-mobile",
    "product_name": "60 UC",
    "player_id": "52425715863",
    "server_id": "",
    "amount_usd": 0.9208,
    "amount_uzs": 11300.0,
    "status": "delivered",
    "external_ref": "bot_user_42",
    "created_at": "2026-07-02T10:30:00",
    "updated_at": "2026-07-02T10:30:22"
  }
}

curl "https://coindonate.uz/api/v1/orders?page=1&per_page=20&status=delivered&date_from=2026-07-01" \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "orders": [
    {
      "id": 142,
      "game_key": "pubg-mobile",
      "product_name": "60 UC",
      "player_id": "52425715863",
      "quantity": 1,
      "amount_usd": 0.9208,
      "amount_uzs": 11300.0,
      "status": "delivered",
      "external_ref": "bot_user_42",
      "created_at": "2026-07-02T10:30:00"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 137, "total_pages": 7 }
}

curl https://coindonate.uz/api/v1/promocodes/games \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "games": [
    { "key": "roblox-us", "name": "ROBLOX US CARD" },
    { "key": "discord-nitro", "name": "Discord Nitro" },
    { "key": "xbox-usa", "name": "XBOX Giftcards (USA)" }
  ]
}

curl https://coindonate.uz/api/v1/promocodes/games/roblox-us/products \
  -H "X-API-Key: cd_your_key"

{
  "success": true,
  "products": [
    {
      "id": "80",
      "name": "Roblox 10$ US",
      "price_usd": 9.717,
      "price_uzs": 119500,
      "retail_usd": 11.1745,
      "retail_uzs": 137400,
      "currency": "USD",
      "is_active": true,
      "stock": 178
    }
  ]
}

curl -X POST https://coindonate.uz/api/v1/promocodes/games/roblox-us/order \
  -H "X-API-Key: cd_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "product_id": "80", "quantity": 2 }'

{
  "success": true,
  "order_id": 143,
  "status": "delivered",
  "product_name": "Roblox 10$ US",
  "quantity": 2,
  "unit_price_usd": 9.717,
  "amount_usd": 19.434,
  "amount_uzs": 239000,
  "codes": ["ABCD-1234-EFGH", "WXYZ-5678-IJKL"],
  "pin_code": "ABCD-1234-EFGH",
  "message": "Delivered"
}

{
  "detail": "This item is currently out of stock"
}