Әзірлеушілерге арналған PayStars API: ботыңызда Stars және Premium сатудың толық процесі
PayStars REST API басынан аяғына дейін қалай жұмыс істейді: X-API-Key, пайдаланушы атын тексеру, max_usd бар USD баға ұсыныстары, идемпотентті тапсырыстар, 409 price_changed қатесі және TxId тексеруі — интеграция жоспары ретінде.
Жарияланды: · Жаңартылды:

Өз ботыңызда, дүкеніңізде немесе қолданбаңызда Telegram Stars және Premium сатқыңыз келе ме? PayStars API сізге бір HTTPS интерфейсі мен сайтпен ортақ USD теңгерімін береді. API анықтамасын қайталамай, бұл мақала интеграцияны басынан аяғына дейін қалай құруды көрсетеді.
Архитектураға қысқаша шолу
Жүйеңіз үш нәрсе жасайды: теңгерімді USDT-пен толтырады, баға сұрайды және тапсырыс жасайды. Қалғанының бәрі, соның ішінде Telegram-ның ресми сатып алу ағыны арқылы жеткізу, PayStars жағында жүреді.
| Бөлім | Не істейді |
|---|---|
| Қол жеткізу | X-API-Key тақырыбы; кілттер басқару тақтасында жасалады |
| Теңгерім | USD, USDT арқылы толтырылады (TON, BEP20 немесе TRC20) |
| Баға | Fragment бағасы × 1.05, центке дейін жоғары дөңгелектеледі |
| Шек | Бір кілтке секундына 10 сұрау |
| Ашықтық | Әр аяқталған тапсырыс үшін жария TxId |
1-кезең: теңгерімді толтыру
POST /usd/invoice сома мен тізбекпен ("ton", "bsc" немесе "trc20") 30 минут жарамды нақты соманы қайтарады. Ең азы — 0.1 USDT.
2-кезең: алушыны тексеру
POST /api/v1/check-username алушыны тексеріп, қысқа мерзімді растау токенін қайтарады. Бұл жоқ пайдаланушы аттарына төлемді болдырмайды: тұтынушы қате терсе, ештеңе ұсталмай тұрып білесіз.
3-кезең: бағаны алу және шектеу
POST /api/v1/usd/quote ағымдағы бағаны (usd) және үстемені (markup_percent: 5) қайтарады. Баға нарыққа ілеседі, сондықтан:
- әр тапсырыс алдында жаңа баға ұсынысын сұраңыз;
- max_usd мәнін ұсынылған сомаға тең етіп беріңіз;
- әрқашан currency: "USD" жіберіңіз, әйтпесе тіркелгінің сақталған баптауы қолданылады.
4-кезең: тапсырыс жасау
POST /api/v1/stars/buy немесе /api/v1/premium/buy. Әр сұрауда Idempotency-Key болуы керек, сондықтан байланыс үзіліп, қайталасаңыз, екі рет ұсталмайсыз. Кілтті дерекқорыңызда тапсырыс идентификаторымен бірге сақтаңыз.
5-кезең: күйді бақылау
GET /api/v1/order/{id} және /api/v1/orders күйлер мен тарихты береді. Көп тапсырыс бірнеше минут ішінде жеткізіледі. Аяқталған тапсырыс PayStars жария тізілімінде сіз де, тұтынушыңыз да тексере алатын TxId алады.
Қателерді дұрыс өңдеу
- 409 price_changed бағаның max_usd-тан асқанын және ештеңе ұсталмағанын білдіреді. Жаңа баға ұсынысын алып, тұтынушыға жаңартылған бағаны көрсетіңіз.
- Сұрау шегі: секундына 10 сұраудан аспаңыз; кезек немесе кідіріспен қайталау қосыңыз.
- Қайталаулар: әрқашан сол Idempotency-Key-ді қайта пайдаланыңыз.
Іске қоспас бұрын
- API кілтін кодта емес, сервердің орта айнымалысында сақтаңыз.
- Бүкіл процесті 50 Stars шағын нақты тапсырысымен өткізіңіз.
- Тұтынушыларға олардың TxId-ін көрсетіңіз — бұл сенім арттырады.
Толық құжаттама мен жылдам бастаулар: PayStars Stars API және API үшін USD баға белгілеу. Бот ішіндегі төлемдер үшін боттардағы цифрлық тауарлар тек Stars арқылы төленеді бөлімін қараңыз.
ЖҚС
Сынақ ортасы бар ма?
Жеке сынақ ортасы жоқ; интеграция кезінде шағын нақты тапсырыстармен (50 Stars) тексеріңіз.
Қай бағдарламалау тілдері жұмыс істейді?
HTTPS сұрау жібере алатын кез келген тіл. Python, Node.js және PHP үшін жылдам бастау нұсқаулары бар.
Теңгерімді қалай толтырамын?
TON, BEP20 немесе TRC20 желілеріндегі USDT арқылы, ең азы 0.1 USDT; әр шоттың нақты сомасы 30 минут жарамды.
Дереккөздер
Related pages
Stars пен Premium-ді USD (USDT) арқылы сатып алу
API кілті арқылы: Fragment бағасы, 0% (сайт: 5%).
More news
Өзбекстанда Telegram Stars және Premium: картамен немесе USDT арқылы төлеуӨзбекстанда Telegram Stars немесе Premium сатып алу: @StarKerakBot арқылы Uzcard және Humo, paystars.uz/uz/ сайтында USDT, ресми қолданба жолдары және білуге тиіс жергілікті ережелер.Оқу →
Байқау жеңімпаздарын Telegram Stars немесе Premium арқылы марапаттау: ұйымдастырушыға арналған нұсқаулықӨз викторинаңыздың, байқауыңыздың немесе хакатоныңыздың жеңімпаздарына Telegram Stars немесе Premium жеткізу: бюджет, @usernames жинау, PayStars арқылы жеткізу және кейінгі есеп.Оқу →
PayStars жиі қойылатын сұрақтар: кіру, USDT толықтыру және Stars пен Premium тапсырыстары туралыPayStars туралы ең жиі сұрақтар бір бетте: Telegram арқылы кіру, USDT (TON, BEP20 немесе TRC20) арқылы толықтыру, Stars пен Premium тапсырысы, жеткізу уақыты, қауіпсіздік және API.Оқу →