Poradnik · Telegram Stars

Faktury Telegram Stars (XTR) w botach: przebieg płatności dla deweloperów, krok po kroku

Sprzedaż dóbr cyfrowych za Stars w bocie: sendInvoice z XTR, odpowiedź na pre_checkout_query w ciągu 10 sekund, successful_payment, zapis identyfikatora obciążenia i lista kontrolna przed startem.

Opublikowano:

Faktury Telegram Stars (XTR) w botach: przebieg płatności dla deweloperów, krok po kroku

Czy Twój bot sprzedaje coś cyfrowego, na przykład subskrypcję, treści, zapytania do SI lub przedmioty w grze? Wtedy płatność odbywa się wyłącznie w Telegram Stars. Ten artykuł omawia przebieg faktury Telegram Stars (XTR) z perspektywy dewelopera, zgodnie z oficjalną dokumentacją Bot API. Dlaczego muszą to być Stars, wyjaśnia artykuł dobra cyfrowe w botach tylko przez Stars.

Przebieg w skrócie

KrokCo robi botCo wysyła Telegram
1sendInvoice z currency = XTR—
2Czekapre_checkout_query
3answerPreCheckoutQuery (w ciągu 10 sekund)—
4Czekasuccessful_payment
5Zapisuje identyfikator obciążenia i dostarcza towar—

Krok 1: utwórz fakturę

Są dwa sposoby:

  • Faktura bota: metoda sendInvoice. Ponieważ towary są cyfrowe, provider_token to pusty ciąg, a pole currency ma wartość XTR. Fakturę można wysłać na czat prywatny, do grupy lub na kanał.
  • Faktura inline: jeśli bot obsługuje tryb inline, inputInvoiceMessageContent pozwala użytkownikom udostępniać fakturę znajomym, grupom i kanałom. Jej przycisk Zapłać można użyć wielokrotnie.

Krok 2: wybierz zachowanie przy przekazywaniu

Steruje tym parametr start_parameter:

  1. Faktura wieloczatowa: przekazane kopie zachowują przycisk Zapłać, więc płacić może wielu użytkowników. Faktury inline są zawsze wieloczatowe.
  2. Faktura jednoczatowa: płatna tylko na czacie, na który została wysłana; przekazane kopie pokazują zamiast tego przycisk z bezpośrednim odnośnikiem do bota.

Pamiętaj, że fakturę jednoczatową wysłaną na prywatny czat z botem można opłacić tylko raz. W obu przypadkach bot zawsze decyduje, czy przyjąć nową płatność.

Krok 3: wstępne sprawdzenie

Użytkownik (w razie potrzeby najpierw kupując Stars) klika Zapłać. Bot otrzymuje pre_checkout_query ze szczegółami zamówienia i musi odpowiedzieć metodą answerPreCheckoutQuery w ciągu 10 sekund, inaczej transakcja zostanie anulowana. Jeśli odrzucasz, podaj powód zrozumiały dla człowieka; Telegram pokaże go użytkownikowi.

Kroki 4–5: finalizacja i dostawa

Gdy płatność się powiedzie, przychodzi wiadomość successful_payment. Dopiero wtedy dostarczaj, bo odpowiedź na pre_checkout_query nie gwarantuje, że płatność przeszła. Zapisz telegram_payment_charge_id; będzie potrzebny do zwrotów.

Zanim uruchomisz na produkcji

  • Włącz weryfikację dwuetapową na koncie, które kontroluje bota.
  • Podaj regulamin przez /terms, a wsparcie przez /support i /paysupport.
  • Bądź gotów na spory i zwroty metodą refundStarPayment. Więcej w zwrotach Stars i /paysupport.
  • Utrzymuj stabilność serwera i rób kopie zapasowe danych o płatnościach.

Jak testować

Dedykowane środowisko testowe Telegram pozwala testować płatności Stars za darmo. Gdy wszystko działa, przełącz się na produkcję.

Strona kupowania Stars

Użytkownicy kupują Stars w aplikacji lub przez @PremiumBot, a PayStars sprzedaje je za USDT. Jeśli Twoja usługa musi kupować Stars automatycznie, opisują to PayStars API i przegląd API.

Najczęstsze pytania

Czy mogę przyjmować kryptowaluty lub inną walutę zamiast Stars?

Nie. Dobra i usługi cyfrowe w aplikacjach Telegram opłaca się wyłącznie w Stars.

Jak testować płatności?

Podłącz bota do dedykowanego środowiska testowego Telegram, w którym płatności Stars można testować za darmo.

Jak wystawić zwrot?

Metodą refundStarPayment w Bot API.

Źródła

Kup Stars i Premium za USD (USDT)

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

Zacznij