PayStars API dasturchilar uchun: botingizda Stars va Premium sotishning to'liq oqimi
PayStars REST API qanday ishlaydi: X-API-Key, username tekshiruvi, USD kotirovkasi va max_usd, idempotent buyurtmalar, 409 price_changed xatosi va TxId orqali tekshirish — integratsiya rejasi.
Chop etilgan: · Yangilangan:

O'z botingiz, do'koningiz yoki ilovangizda Telegram Stars va Premium sotmoqchimisiz? PayStars API — buning uchun bitta HTTPS interfeys va sayt bilan umumiy USD balansi. Bu maqola API sahifasidagi texnik ma'lumotlarni takrorlamaydi, balki integratsiyani boshidan oxirigacha qanday qurishni ko'rsatadi.
Arxitektura bir qarashda
Sizning tizimingiz uchta ishni qiladi: balansni USDT bilan to'ldiradi, narxni so'raydi va buyurtma yaratadi. Qolgani — Telegram'ning rasmiy xarid oqimi orqali yetkazish — PayStars tomonida.
| Qism | Nima qiladi |
|---|---|
| Kirish | X-API-Key sarlavhasi, kalitlar kabinetda yaratiladi |
| Balans | USD, USDT (TON, BEP20 yoki TRC20) bilan to'ldiriladi |
| Narx | Fragment narxi × 1,05, sentgacha yuqoriga yaxlitlanadi |
| Cheklov | Bitta kalitga 10 so'rov/soniya |
| Shaffoflik | Har bir bajarilgan buyurtmaga ommaviy TxId |
1-bosqich: balansni to'ldirish
POST /usd/invoice so'roviga summa va tarmoq (TON, BEP20 yoki TRC20) yuborasiz va 30 daqiqa amal qiladigan aniq summa olasiz. Minimal — 0.1 USDT.
2-bosqich: qabul qiluvchini tekshirish
POST /api/v1/check-username qabul qiluvchini tekshiradi va qisqa muddatli tasdiq tokenini qaytaradi. Bu mavjud bo'lmagan username'ga to'lovning oldini oladi — mijoz xato yozsa, pul yechilmasdan oldin bilasiz.
3-bosqich: narxni olish va cheklash
POST /api/v1/usd/quote joriy narxni (usd) va ustamani (markup_percent: 5) qaytaradi. Narx bozorga bog'liq, shuning uchun:
- har buyurtmadan oldin yangi kotirovka oling;
- buyurtmaga max_usd ni kotirovka summasiga teng qilib qo'ying;
- har doim currency: "USD" yuboring — aks holda akkauntdagi saqlangan sozlama ishlatiladi.
4-bosqich: buyurtma yaratish
POST /api/v1/stars/buy yoki /api/v1/premium/buy. Har bir so'rov Idempotency-Key bilan bo'lishi shart: tarmoq uzilib, so'rovni qayta yuborsangiz, ikkinchi marta pul yechilmaydi. Kalitni buyurtma ID'si bilan birga o'z bazangizda saqlang.
5-bosqich: holatni kuzatish
GET /api/v1/order/{id} va /api/v1/orders — holat va tarix. Ko'p buyurtmalar bir necha daqiqada yetkaziladi. Bajarilgan buyurtma TxId oladi va uni PayStars ommaviy reyestrida siz ham, mijozingiz ham tekshira oladi.
Xatolarni to'g'ri ushlash
- 409 price_changed — narx max_usd'dan oshdi, hech narsa yechilmadi. Yangi kotirovka olib, mijozga yangi narxni ko'rsating.
- Cheklovdan oshish — sekundiga 10 so'rovdan ko'p yubormang; navbat yoki kechikish qo'shing.
- Qayta urinish — har doim o'sha Idempotency-Key bilan.
Ishga tushirishdan oldin
- Kalitni server muhit o'zgaruvchisida saqlang, kodga yozmang.
- 50 Stars'lik kichik real buyurtma bilan butun oqimni sinang.
- Mijozga TxId'ni ko'rsating — bu ishonchni oshiradi.
To'liq hujjatlar va quickstart'lar: PayStars Stars API va API uchun USD narxlash. Bot ichidagi to'lovlar uchun: botlarda raqamli tovarlar faqat Stars bilan.
Ko‘p beriladigan savollar
Sandbox bormi?
Alohida sandbox yo'q; integratsiya paytida kichik real buyurtmalar (50 Stars) bilan sinash tavsiya qilinadi.
Qaysi dasturlash tilida ishlaydi?
HTTPS so'rov yubora oladigan istalgan tilda. Python, Node.js va PHP uchun quickstart'lar bor.
Balans qanday to'ldiriladi?
TON, BEP20 yoki TRC20 tarmog'idagi USDT bilan, minimal 0.1 USDT; invoys aniq summa bilan 30 daqiqa amal qiladi.
Manbalar
Foydali sahifalar
Stars va Premium’ni USD (USDT) bilan oling
API kalit orqali: 0% (Fragment narxi). Sayt orqali: 5%.
Boshqa yangiliklar
O‘zbekistonda Telegram Stars va Premium: karta yoki USDT bilan to‘lashO‘zbekistonda Telegram Stars yoki Premium olish: @StarKerakBot’da Uzcard va Humo, paystars.uz/uz/ saytida USDT, rasmiy yo‘llar va bilish kerak bo‘lgan mahalliy qoidalar.O‘qish →
Tanlov g'oliblarini Telegram Stars yoki Premium bilan taqdirlash: tashkilotchi uchun rejaO'zingiz o'tkazgan viktorina, tanlov yoki xakaton g'oliblariga Telegram Stars yoki Premium topshirish: byudjet, @username yig'ish, PayStars orqali yetkazish va hisobot.O‘qish →
PayStars FAQ: kirish, USDT bilan to'ldirish, Stars va Premium buyurtmalari bo'yicha ko'p beriladigan savollarPayStars haqida eng ko'p beriladigan savollar bir sahifada: Telegram orqali kirish, USDT (TON, BEP20, TRC20) bilan to'ldirish, Stars va Premium buyurtmasi, yetkazish muddati, xavfsizlik va API.O‘qish →