Telegram Stars va Premium sotib olish uchun oddiy REST API. Kassangizga wallet ulang — keyin faqat bitta so'rov yuboring.
Base URL
https://starsapi.uz
Auth
X-API-Key
Format
JSON / Query
Response
success · error_code
Tezkor boshlash
Kassa yaratingPanelda yangi kassa yarating va Gram wallet seed ni ulang (12 yoki 24 so'z — Keeper, Tonkeeper, Trust Wallet)
API kalit olingKassaning API kalitini X-API-Key headerga qo'shing
So'rov yuboringusername va amount bilan POST yuboring — tayyor
API kalit xavfsizligi.Kalitni frontend yoki mobil ilovaga joylamang; so‘rovlarni faqat serveringizdan yuboring. Xarid endpointlari uchun limit: har IP manzilga daqiqasiga 30 ta so‘rov.
Birinchi xarid
Kerak bo'ladi
Kassaning API kaliti (panel → kassa)
Kassaga ulangan Gram hamyon va unda yetarli balans; gaz uchun ~0.05 TON zaxira
/stars/pricing va /premium/pricing javobidagi total.selected — kassa hamyonidan yechiladigan jami summa: narx va xizmat haqi. Uni oxirgi foydalanuvchiga tasdiqlash tugmasidan oldin ko'rsating. Tarmoq gazi alohida, hamyondan TON'da yechiladi. Bajarilgan tranzaksiya qaytarilmaydi.
202 PENDING javobida qayta to'lamang: order_id bilan har 5 soniyada holatni so'rang, yakuniy holat SUCCESS yoki FAILED bo'ladi. FAILED da pul kassaga qaytadi.
Sinab ko'rish
Kalitingiz bilan so'rov yuborib, haqiqiy javobni shu yerda ko'ring. Pul yechadigan endpointlar (/stars/buy, /premium/buy, /ton/topup) bu yerda yo'q.
Kalit faqat shu brauzerda qoladi, so'rov to'g'ridan-to'g'ri starsapi.uz ga ketadi.
Shart emas — bir xil buyurtma (kassa, username, miqdor) oldingisi tugaganidan keyin 5 s ichida qayta kelsa, server uni o'zi ushlaydi va birinchi buyurtmani duplicate: true bilan qaytaradi. Kalit bilan: bir kalit bilan faqat bitta buyurtma ochiladi, qayta yuborilsa birinchi javob qaytadi (idempotent_replay: true). 1–100 belgi, 30 kun saqlanadi. JSON'da idempotency_key sifatida ham yuborsa bo'ladi
wait
boolean
Ixtiyoriy
true — to'lov blokcheynda tasdiqlanguncha kutadi (~3 s). Standart: kutmaydi — Fragment'ga to'lov tarmoqqa yuborilishi bilan (~1 s) success va order_id qaytadi; kam uchraydigan keyingi rad GET /order/{order_id} da FAILED bo'ladi va pul kassaga qaytariladi
{
"success": false,
"error": "Hamyon seqno'sini o'qib bo'lmadi (tonapi javob bermayapti) — xabar yuborilmadi, pul yechilmadi. Birozdan keyin qayta urinib ko'ring",
"error_code": "SEQNO_UNAVAILABLE"
}
WALLET_FROZEN200
{
"success": false,
"error": "Hamyon zanjirda muzlatilgan (frozen) — xabar yuborilmadi, pul yechilmadi",
"error_code": "WALLET_FROZEN"
}
Shart emas — bir xil buyurtma (kassa, username, miqdor) oldingisi tugaganidan keyin 5 s ichida qayta kelsa, server uni o'zi ushlaydi va birinchi buyurtmani duplicate: true bilan qaytaradi. Kalit bilan: bir kalit bilan faqat bitta buyurtma ochiladi, qayta yuborilsa birinchi javob qaytadi (idempotent_replay: true). 1–100 belgi, 30 kun saqlanadi. JSON'da idempotency_key sifatida ham yuborsa bo'ladi
wait
boolean
Ixtiyoriy
true — to'lov blokcheynda tasdiqlanguncha kutadi (~3 s). Standart: kutmaydi — Fragment'ga to'lov tarmoqqa yuborilishi bilan (~1 s) success va order_id qaytadi; kam uchraydigan keyingi rad GET /order/{order_id} da FAILED bo'ladi va pul kassaga qaytariladi
{
"success": false,
"error": "Hamyon seqno'sini o'qib bo'lmadi (tonapi javob bermayapti) — xabar yuborilmadi, pul yechilmadi. Birozdan keyin qayta urinib ko'ring",
"error_code": "SEQNO_UNAVAILABLE"
}
WALLET_FROZEN200
{
"success": false,
"error": "Hamyon zanjirda muzlatilgan (frozen) — xabar yuborilmadi, pul yechilmadi",
"error_code": "WALLET_FROZEN"
}
{
"success": false,
"error": "Hamyon seqno'sini o'qib bo'lmadi (tonapi javob bermayapti) — xabar yuborilmadi, pul yechilmadi. Birozdan keyin qayta urinib ko'ring",
"error_code": "SEQNO_UNAVAILABLE"
}
WALLET_FROZEN200
{
"success": false,
"error": "Hamyon zanjirda muzlatilgan (frozen) — xabar yuborilmadi, pul yechilmadi",
"error_code": "WALLET_FROZEN"
}
Kassa valyutasiga mos qiymat: ton bo'lsa TON, usdt bo'lsa USD
result.fee_percent
number
Kassaga qo'llanadigan xizmat haqi, %
result.total
object
Narx + xizmat haqi — hamyondan haqiqatda yechiladigan summa (gazsiz)
Narx Fragmentdan olinadi va 60 soniya keshlanadi. 50 ta minimal chegara faqat /stars/buy da tekshiriladi — narx istalgan musbat miqdor uchun hisoblanadi.
Gaz uchun TON yetadimi. false bo'lsa hech qanday xarid o'tmaydi
result.stars.max_amount
integer
Balansga sig'adigan maksimal Stars (fee va gaz hisobga olingan). 50 dan kam bo'lsa 0
result.stars.asset
string
Hisob asosi: TON yoki USDT
result.stars.total
object
Shu Stars miqdorining fee bilan umumiy qiymati
result.premium.packages[]
array
Balansga yetadigan Premium paketlari; hech biri yetmasa bo'sh massiv
Hisob kassa fee'si va gaz zaxirasini (0.05 TON) hisobga oladi — max_amount ni to'g'ridan-to'g'ri /stars/buy ga yuborish mumkin. USDT kassada ham gaz TON'da to'lanadi.