Нұсқаулық · PayStars

Әзірлеушілерге арналған PayStars API: ботыңызда Stars және Premium сатудың толық процесі

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

Жарияланды: · Жаңартылды:

Әзірлеушілерге арналған PayStars API: ботыңызда Stars және Premium сатудың толық процесі

Өз ботыңызда, дүкеніңізде немесе қолданбаңызда 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-ді қайта пайдаланыңыз.

Іске қоспас бұрын

  1. API кілтін кодта емес, сервердің орта айнымалысында сақтаңыз.
  2. Бүкіл процесті 50 Stars шағын нақты тапсырысымен өткізіңіз.
  3. Тұтынушыларға олардың TxId-ін көрсетіңіз — бұл сенім арттырады.

Толық құжаттама мен жылдам бастаулар: PayStars Stars API және API үшін USD баға белгілеу. Бот ішіндегі төлемдер үшін боттардағы цифрлық тауарлар тек Stars арқылы төленеді бөлімін қараңыз.

ЖҚС

Сынақ ортасы бар ма?

Жеке сынақ ортасы жоқ; интеграция кезінде шағын нақты тапсырыстармен (50 Stars) тексеріңіз.

Қай бағдарламалау тілдері жұмыс істейді?

HTTPS сұрау жібере алатын кез келген тіл. Python, Node.js және PHP үшін жылдам бастау нұсқаулары бар.

Теңгерімді қалай толтырамын?

TON, BEP20 немесе TRC20 желілеріндегі USDT арқылы, ең азы 0.1 USDT; әр шоттың нақты сомасы 30 минут жарамды.

Дереккөздер

Stars пен Premium-ді USD (USDT) арқылы сатып алу

API кілті арқылы: Fragment бағасы, 0% (сайт: 5%).

Бастау