Tərtibatçılar üçün PayStars API: botunuzda Stars və Premium satmaq üçün tam axın
PayStars REST API-nin başdan sona necə işlədiyi: X-API-Key, istifadəçi adı yoxlamaları, max_usd ilə USD qiymət sorğuları, idempotent sifarişlər, 409 price_changed xətası və TxId yoxlaması, inteqrasiya planı kimi.
Dərc olunub: · Yenilənib:

Öz botunuzda, mağazanızda və ya tətbiqinizdə Telegram Stars və Premium satmaq istəyirsiniz? PayStars API sizə bir HTTPS interfeysi və saytla paylaşılan USD balansı verir. API arayışını təkrarlamaq əvəzinə bu məqalə inteqrasiyanı başdan sona necə qurmağı göstərir.
Arxitekturaya qısa baxış
Sisteminiz üç şey edir: balansı USDT ilə doldurur, qiymət soruşur və sifariş yaradır. Telegram-ın rəsmi alış axını ilə çatdırılma da daxil olmaqla, qalan hər şey PayStars tərəfində baş verir.
| Hissə | Nə edir |
|---|---|
| Giriş | X-API-Key başlığı; açarlar idarə panelində yaradılır |
| Balans | USD, USDT ilə doldurulur (TON, BEP20 və ya TRC20) |
| Qiymət | Fragment qiyməti × 1.05, sentə qədər yuxarı yuvarlaqlaşdırılır |
| Hədd | hər açar üçün saniyədə 10 sorğu |
| Şəffaflıq | Hər tamamlanmış sifariş üçün açıq TxId |
Mərhələ 1: balansı doldurun
Məbləğ və şəbəkə ("ton", "bsc" və ya "trc20") ilə POST /usd/invoice 30 dəqiqə etibarlı dəqiq məbləğ qaytarır. Minimum 0.1 USDT-dir.
Mərhələ 2: alıcını yoxlayın
POST /api/v1/check-username alıcını yoxlayır və qısamüddətli təsdiq tokeni qaytarır. Bu, mövcud olmayan istifadəçi adlarına ödənişin qarşısını alır: müştəri səhv yazsa, heç nə tutulmazdan əvvəl bunu öyrənirsiniz.
Mərhələ 3: qiyməti alın və məhdudlaşdırın
POST /api/v1/usd/quote cari qiyməti (usd) və əlavə haqqı (markup_percent: 5) qaytarır. Qiymət bazarı izləyir, ona görə:
- hər sifarişdən əvvəl təzə qiymət sorğulayın;
- max_usd dəyərini göstərilən məbləğə bərabər göndərin;
- həmişə currency: "USD" göndərin, əks halda hesabın saxlanmış seçimi istifadə olunur.
Mərhələ 4: sifarişi yaradın
POST /api/v1/stars/buy və ya /api/v1/premium/buy. Hər sorğu Idempotency-Key daşımalıdır ki, əlaqə kəsilsə və yenidən cəhd etsəniz, iki dəfə tutulmayasınız. Açarı sifariş ID-si ilə birlikdə verilənlər bazanızda saxlayın.
Mərhələ 5: statusu izləyin
GET /api/v1/order/{id} və /api/v1/orders sizə statusları və tarixçəni verir. Əksər sifarişlər dəqiqələr ərzində çatdırılır. Tamamlanmış sifariş həm sizin, həm də müştərinizin PayStars açıq reyestrində yoxlaya biləcəyi TxId alır.
Xətaların düzgün idarə edilməsi
- 409 price_changed qiymətin max_usd-dən yuxarı qalxdığını və heç nə tutulmadığını bildirir. Yeni qiymət alın və müştəriyə yenilənmiş qiyməti göstərin.
- Sorğu limiti: saniyədə 10 sorğunu aşmayın; növbə və ya artan fasilə əlavə edin.
- Təkrar cəhdlər: həmişə eyni Idempotency-Key-i yenidən istifadə edin.
Canlıya çıxmazdan əvvəl
- API açarını kodda yox, server mühit dəyişənində saxlayın.
- Bütün axını 50 Stars həcmində kiçik real sifarişlə işə salın.
- Müştərilərə TxId-lərini göstərin, bu etimad yaradır.
Tam sənədlər və sürətli başlanğıclar: PayStars Stars API və API üçün USD qiymətləndirməsi. Botdaxili ödənişlər üçün baxın: botlarda rəqəmsal mallar yalnız Stars ilə ödənilir.
TSS
Sınaq mühiti varmı?
Ayrı sınaq mühiti yoxdur; inteqrasiya zamanı kiçik real sifarişlərlə (50 Stars) yoxlayın.
Hansı proqramlaşdırma dilləri işləyir?
HTTPS sorğusu göndərə bilən istənilən dil. Python, Node.js və PHP üçün sürətli başlanğıclar var.
Balansı necə doldurum?
TON, BEP20 və ya TRC20 üzərində USDT ilə, minimum 0.1 USDT; hər hesab-fakturanın 30 dəqiqə etibarlı dəqiq məbləği var.
Mənbələr
Related pages
Stars və Premium-u USD (USDT) ilə alın
API açarı ilə: Fragment qiyməti, 0% (sayt: 5%).
More news
Özbəkistanda Telegram Stars və Premium: kartla və ya USDT ilə ödənişÖzbəkistanda Telegram Stars və ya Premium almaq: @StarKerakBot vasitəsilə Uzcard və Humo, paystars.uz/uz/ ünvanında USDT, rəsmi tətbiq marşrutları və bilməli olduğunuz yerli qaydalar.Oxu →
Müsabiqə qaliblərini Telegram Stars və ya Premium ilə necə mükafatlandırmaq olar: təşkilatçı üçün bələdçiÖz viktorina, müsabiqə və ya hakatonunuzun qaliblərinə Telegram Stars və ya Premium çatdırılması: büdcə, @usernames toplanması, PayStars vasitəsilə çatdırılma və yekun hesabat.Oxu →
PayStars TSS: Telegram ilə giriş, USDT ilə balans artırma və Stars və Premium sifarişləri haqqında ümumi suallarBir səhifədə PayStars haqqında ən çox verilən suallar: Telegram ilə giriş, USDT ilə balans artırma (TON, BEP20 və ya TRC20), Stars və Premium sifarişi, çatdırılma müddətləri, təhlükəsizlik və API.Oxu →