★ Dla programistów

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ą.

Automatyczna dostawawiększość zamówień w kilka minut
Sprawdzenie nazwy użytkownikaprzed płatnością
Otwarte cenytakie same na stronie i w API
Publiczny rejestrkażde zamówienie otrzymuje TxId

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.

Gotowy do zamówienia?

Zaloguj się przez Telegram — Twoje saldo StarKerak działa na stronie, w WebApp i przez API.