O'yinlar, Telegram Stars va Premium — bir zumda to'ldiring.
Voucher va promokod o'yinlari. Tez orada sotuvga chiqadi.
Sotib olish uchun mahsulotni tanlang
API kalit olish uchun admin bilan bog'laning.
Har bir so'rovga API kalitingizni qo'shing:
X-API-Key: your_api_key_here
Telegram username mavjudligi va formatini tekshiradi. API kaliti shart emas.
curl -X POST "https://dyps.uz/v1/check-username/" \
-H "Content-Type: application/json" \
-d '{"username": "durov"}'| Parametr | Turi | Majburiy | Tavsif |
|---|---|---|---|
username | string | ✓ | Telegram username |
quantity | int | ✓ | Stars soni (50 - 10,000,000) |
type | string | ✓ | "stars" |
callback_url | string | Ixtiyoriy | Holat uchun webhook URL |
curl -X POST "https://dyps.uz/v1/buy-order/" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"username":"@johndoe","quantity":1000,"type":"stars"}'| Parametr | Turi | Majburiy | Tavsif |
|---|---|---|---|
username | string | ✓ | Telegram username |
quantity | int | ✓ | Oylar (3, 6 yoki 12) |
type | string | ✓ | "premium" |
callback_url | string | ✓ | Webhook URL (Premium uchun majburiy) |
curl -X POST "https://dyps.uz/v1/buy-order/" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"username": "@johndoe",
"quantity": 3,
"type": "premium",
"callback_url": "https://sizning-sayt.uz/webhook"
}'So'rov darhol pending holatda javob qaytaradi:
{
"success": true,
"order_id": "1b2c3d4e-...-uuid",
"status": "pending"
}Buyurtma bajarilgach (yoki xato bo'lsa), tizim siz bergan callback_url manziliga avtomatik POST yuboradi. Bu zanjirning eng oxirgi qadami — pirovard natija shu yerda keladi.
{
"order_id": "1b2c3d4e-...-uuid",
"status": "success", // yoki "cancelled"
"username": "johndoe",
"quantity": 3,
"order_type": "premium",
"ledger_id": "tx_abc123", // tranzaksiya ID (muvaffaqiyatda)
"amount": "12.5",
"error_message": null, // xato bo'lsa — sababi
"created_at": "2026-06-21T10:00:00",
"completed_at": "2026-06-21T10:00:08",
"timestamp": "2026-06-21T10:00:08.123456"
}Content-Type: application/json User-Agent: Telegram-Stars-Bot/3.0.0
@app.post("/webhook")
async def webhook(request: Request):
data = await request.json()
if data["status"] == "success":
# buyurtmani yakunlangan deb belgilang
notify_user(data["username"], data["ledger_id"])
else:
# status == "cancelled" → error_message ni tekshiring
log_error(data["error_message"])
return {"received": True} # 200 qaytaring3 qadam: o'yinlarni oling → mahsulotlarni oling → sotib oling. To'lov balansdan olinadi.
Har bir API kalit bitta foydalanuvchiga bog'langan. Xarid qilinganda narx (UZS) shu kalit egasining balansidan yechiladi. Balans yetarli bo'lmasa — 400 xato, xarid bo'lmaydi. Provayder rad etsa — balans avtomatik qaytariladi.
| Turi | Tavsif | API |
|---|---|---|
| AVTO | O'yin hisobini to'ldirish (Player ID bilan) | /v1/topup/buy/ |
| PROMOKOD | Raqamli kodlar / voucher (soni bilan) | /v1/simple/buy/ |
Sotuvga tayyor o'yinlarni qaytaradi. kind=auto (to'ldirish) yoki kind=promo (promokod). Har birining id sini keyingi qadamda ishlating.
curl "https://dyps.uz/v1/games/?kind=auto" \ -H "X-API-Key: your_api_key_here"
{
"success": true,
"kind": "auto",
"games": [
{ "id": 32, "name": "Pubg Uc Recharge", "kind": "auto" }
]
}Tanlangan o'yin mahsulotlarini, narxlarini (UZS) va zaxirasini qaytaradi. is_topup qaysi xarid API ekanini bildiradi. Sotib olish uchun product_id ni oling.
curl "https://dyps.uz/v1/games/32/products/" \ -H "X-API-Key: your_api_key_here"
{
"success": true,
"game": "Pubg Uc Recharge",
"is_topup": true,
"sellable": true,
"products": [
{ "id": 6, "name": "60 UC", "price": 12400, "stock": 0 },
{ "id": 1, "name": "325 UC", "price": 61900, "stock": 0 }
]
}Balansdan to'lov olinadi, so'rov provayderga yuboriladi va uning javobi data maydonida qaytariladi. Xatolik bo'lsa balans avtomatik qaytariladi.
| Parametr | Turi | Majburiy | Tavsif |
|---|---|---|---|
product_id | int | ✓ | Mahsulot id (2-qadamdan) |
player_id | string | ✓ | O'yinchi / akkaunt ID si |
curl -X POST "https://dyps.uz/v1/topup/buy/" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"product_id": 6, "player_id": "123456789"}'Muvaffaqiyatli javob — provayderdan qaytgan ma'lumot bilan:
{
"success": true,
"message": "Order completed",
"order_id": "1b2c3d4e-...-uuid",
"total": 12400,
"status": "success",
"data": { ... } // provayderdan qaytgan javob
}Xatolik (balans yetarli emas / sotuvda yo'q / provayder xatosi) — 4xx/502 va balans qaytariladi.
Promokod o'yinlari (is_topup=False) uchun: raqamli kodlar sotib olinadi. Balansdan to'lov olinadi, kodlar delivery_items da qaytadi.
| Parametr | Turi | Majburiy | Tavsif |
|---|---|---|---|
product_id | int | ✓ | Mahsulot id (2-qadamdan) |
quantity | int | ✓ | Nechta dona (1+) |
curl -X POST "https://dyps.uz/v1/simple/buy/" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"product_id": 12, "quantity": 2}'Muvaffaqiyatli javob — yetkazilgan kodlar bilan:
{
"success": true,
"order_id": "1b2c3d4e-...-uuid",
"total": 24400,
"quantity": 2,
"status": "success",
"delivery_items": ["CODE-AAAA-1111", "CODE-BBBB-2222"]
}