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:

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
| Krok | Co robi bot | Co wysyła Telegram |
|---|---|---|
| 1 | sendInvoice z currency = XTR | — |
| 2 | Czeka | pre_checkout_query |
| 3 | answerPreCheckoutQuery (w ciągu 10 sekund) | — |
| 4 | Czeka | successful_payment |
| 5 | Zapisuje 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:
- Faktura wieloczatowa: przekazane kopie zachowują przycisk Zapłać, więc płacić może wielu użytkowników. Faktury inline są zawsze wieloczatowe.
- 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
Related pages
Kup Stars i Premium za USD (USDT)
Przez klucz API: cena Fragment, 0% (strona: 5%).
More news
Pisanie polityki zwrotów dla bota Telegram Stars: szablon i przykładyCo powinna obejmować polityka zwrotów bota Telegram Stars: uprawnienia, okres, /paysupport i refundStarPayment oraz przykładowe sformułowania do dostosowania.Czytaj →
Co się dzieje z Twoimi Telegram Stars, gdy tracisz dostęp do kontaStars należą do Twojego konta Telegram, a nie do telefonu. Dowiedz się, co się z nimi dzieje po utracie dostępu, jak wrócić na konto i jak chronić saldo.Czytaj →
Prowadzenie ewidencji przychodów z Telegram Stars jako twórca lub firmaJak prowadzić przejrzystą ewidencję przychodów z Telegram Stars: co zapisywać, jak śledzić wypłaty z Fragment, jak oddzielać sprawy osobiste od firmowych i o co zapytać księgowego.Czytaj →