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:

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ęp | Nagłówek X-API-Key; klucze tworzy się w panelu |
| Saldo | USD, doładowywane za pomocą USDT (TON, BEP20 lub TRC20) |
| Cena | Cena Fragment × 1.05, zaokrąglona w górę do centa |
| Limit | 10 żą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
- Trzymaj klucz API w zmiennej środowiskowej serwera, nie w kodzie.
- Przeprowadź cały przepływ z małym, prawdziwym zamówieniem 50 Stars.
- 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
Related pages
Kup Stars i Premium za USD (USDT)
Przez klucz API: cena Fragment, 0% (strona: 5%).
More news
Telegram Stars i Premium w Uzbekistanie: płatność kartą lub USDTZakup Telegram Stars lub Premium w Uzbekistanie: Uzcard i Humo przez @StarKerakBot, USDT na paystars.uz/uz/, oficjalne ścieżki w aplikacji i lokalne zasady, które warto znać.Czytaj →
Jak nagradzać zwycięzców konkursów Telegram Stars lub Premium: poradnik organizatoraPrzekazywanie Telegram Stars lub Premium zwycięzcom własnego quizu, konkursu lub hackathonu: budżet, zbieranie @usernames, dostawa przez PayStars i raport końcowy.Czytaj →
PayStars — najczęstsze pytania: logowanie, doładowania USDT oraz zamówienia Stars i PremiumNajczęstsze pytania o PayStars na jednej stronie: logowanie przez Telegram, doładowanie USDT (TON, BEP20 lub TRC20), zamawianie Stars i Premium, czas dostawy, bezpieczeństwo i API.Czytaj →