Telegram Stars API
Sprzedawaj Telegram Stars i Premium we własnym bocie, sklepie lub aplikacji. Jedno API HTTPS, jedno saldo wspólne z botem StarKerak i stroną.
Co robi API
- POST /api/v1/check-username — zweryfikuj odbiorcę i otrzymaj krótkotrwały token weryfikacyjny
- POST /api/v1/stars/buy i /api/v1/premium/buy — twórz zamówienia (wymagany Idempotency-Key)
- GET /api/v1/order/{id} i /api/v1/orders — statusy i historia
- GET /api/v1/prices, /api/v1/account, portfel USD i faktury USDT
Uwierzytelnianie używa nagłówka X-API-Key. Klucze tworzy się w panelu i nie wygasają, dopóki ich nie unieważnisz.
Gotowe na produkcję
Każde zamówienie niesie Twój Idempotency-Key, więc ponowienia nigdy nie obciążają podwójnie. Weryfikacja odbiorcy zapobiega płatnościom na nieistniejące nazwy użytkowników. Limit to 10 żądań na sekundę na klucz.
Wszystkie zamówienia są opłacane z salda USD (currency=USD; UZS jest traktowane jako USD). Przekaż max_usd, aby ograniczyć akceptowaną cenę.
Przejrzystość
Każde zrealizowane zamówienie otrzymuje TxId zapisany w publicznym rejestrze PayStars, więc Ty i Twoi klienci możecie niezależnie zweryfikować dostawę.
Cena Fragment, 0% (strona: 5%)
Zamówienia z kluczem API z salda USD są wyceniane według bieżącej ceny Fragment 0% (strona: 5%); zamówienia ze strony i miniaplikacji dokładna kwota jest pokazana przed płatnością. Cenę pobierzesz przez POST /usd/quote i ograniczysz parametrem max_usd. Szczegóły na stronie Fragment API.
Często zadawane pytania
Czy jest środowisko testowe?
Podczas integracji używaj małych prawdziwych zamówień (50 Stars); klucz idempotencji sprawia, że ponowienia są bezpieczne.
Jakie języki są obsługiwane?
Dowolny język z HTTPS. Zobacz szybkie starty w Python, Node.js i PHP.
Czy klucze API wygasają?
Nie. Klucze pozostają ważne, dopóki nie unieważnisz ich w panelu.
Czy mogę płacić w USD?
Tak — doładuj saldo USD za pomocą USDT (TON, BEP20 lub TRC20) i wyślij currency=USD.
Related pages
Gotowy do zamówienia?
Zaloguj się przez Telegram — Twoje saldo StarKerak działa na stronie, w WebApp i przez API.
