Poradnik · PayStars

PayStars API dla deweloperów: pełny przepływ sprzedaży Stars i Premium w Twoim bocie

Jak działa PayStars REST API od początku do końca: X-API-Key, sprawdzanie nazw użytkowników, wyceny w USD z max_usd, idempotentne zamówienia, błąd 409 price_changed i weryfikacja TxId — jako plan integracji.

Opublikowano: · Zaktualizowano:

PayStars API dla deweloperów: pełny przepływ sprzedaży Stars i Premium w Twoim bocie

Chcesz sprzedawać Telegram Stars i Premium we własnym bocie, sklepie lub aplikacji? PayStars API daje jeden interfejs HTTPS i saldo w USD współdzielone ze stroną. Zamiast powtarzać dokumentację API, ten artykuł pokazuje, jak zbudować integrację od początku do końca.

Architektura w skrócie

Twój system robi trzy rzeczy: doładowuje saldo za pomocą USDT, pyta o cenę i tworzy zamówienie. Cała reszta, w tym dostawa przez oficjalny przepływ zakupu Telegram, odbywa się po stronie PayStars.

CzęśćCo robi
DostępNagłówek X-API-Key; klucze tworzy się w panelu
SaldoUSD, doładowywane za pomocą USDT (TON, BEP20 lub TRC20)
CenaCena Fragment × 1.05, zaokrąglona w górę do centa
Limit10 żądań na sekundę na klucz
PrzejrzystośćPubliczny TxId dla każdego zrealizowanego zamówienia

Etap 1: doładowanie salda

POST /usd/invoice z kwotą i siecią ("ton", "bsc" lub "trc20") zwraca dokładną kwotę ważną przez 30 minut. Minimum to 0.1 USDT.

Etap 2: weryfikacja odbiorcy

POST /api/v1/check-username sprawdza odbiorcę i zwraca krótkotrwały token weryfikacyjny. Dzięki temu nie płacisz na nieistniejące nazwy użytkowników: jeśli klient zrobi literówkę, dowiesz się o tym, zanim cokolwiek zostanie pobrane.

Etap 3: pobranie i ograniczenie ceny

POST /api/v1/usd/quote zwraca aktualną cenę (usd) i narzut (markup_percent: 5). Cena podąża za rynkiem, więc:

  • przed każdym zamówieniem pobierz świeżą wycenę;
  • przekaż max_usd równe podanej kwocie;
  • zawsze wysyłaj currency: "USD", w przeciwnym razie użyta zostanie zapisana preferencja konta.

Etap 4: utworzenie zamówienia

POST /api/v1/stars/buy lub /api/v1/premium/buy. Każde żądanie musi zawierać Idempotency-Key, więc jeśli połączenie padnie i ponowisz żądanie, nie zostaniesz obciążony dwa razy. Zapisz klucz razem z identyfikatorem zamówienia w swojej bazie danych.

Etap 5: śledzenie statusu

GET /api/v1/order/{id} i /api/v1/orders dają statusy i historię. Większość zamówień jest dostarczana w ciągu kilku minut. Zrealizowane zamówienie otrzymuje TxId, który Ty i Twój klient możecie sprawdzić w publicznym rejestrze PayStars.

Prawidłowa obsługa błędów

  • 409 price_changed oznacza, że cena przekroczyła max_usd i nic nie zostało pobrane. Pobierz nową wycenę i pokaż klientowi zaktualizowaną cenę.
  • Limit żądań: nie przekraczaj 10 żądań na sekundę; dodaj kolejkę lub wycofanie.
  • Ponowienia: zawsze używaj tego samego Idempotency-Key.

Przed uruchomieniem

  1. Trzymaj klucz API w zmiennej środowiskowej serwera, nie w kodzie.
  2. Przeprowadź cały przepływ z małym, prawdziwym zamówieniem 50 Stars.
  3. Pokazuj klientom ich TxId — to buduje zaufanie.

Pełna dokumentacja i szybkie starty: PayStars Stars API oraz cennik USD dla API. O płatnościach w bocie przeczytaj: towary cyfrowe w botach opłaca się wyłącznie w Stars.

Najczęstsze pytania

Czy jest środowisko testowe?

Nie ma osobnego środowiska testowego; podczas integracji testuj małymi, prawdziwymi zamówieniami (50 Stars).

Które języki programowania działają?

Każdy język, który potrafi wysyłać żądania HTTPS. Są szybkie starty dla Python, Node.js i PHP.

Jak doładować saldo?

Za pomocą USDT w sieciach TON, BEP20 lub TRC20, minimum 0.1 USDT; każda faktura ma dokładną kwotę ważną przez 30 minut.

Źródła

Kup Stars i Premium za USD (USDT)

Przez klucz API: cena Fragment, 0% (strona: 5%).

Zacznij