Qo‘llanma · PayStars

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:

PayStars API dasturchilar uchun: botingizda Stars va Premium sotishning to'liq oqimi

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.

QismNima qiladi
KirishX-API-Key sarlavhasi, kalitlar kabinetda yaratiladi
BalansUSD, USDT (TON, BEP20 yoki TRC20) bilan to'ldiriladi
NarxFragment narxi × 1,05, sentgacha yuqoriga yaxlitlanadi
CheklovBitta kalitga 10 so'rov/soniya
ShaffoflikHar 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

  1. Kalitni server muhit o'zgaruvchisida saqlang, kodga yozmang.
  2. 50 Stars'lik kichik real buyurtma bilan butun oqimni sinang.
  3. 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

Stars va Premium’ni USD (USDT) bilan oling

API kalit orqali: 0% (Fragment narxi). Sayt orqali: 5%.

Boshlash