Anleitung · Telegram Stars

Telegram Stars-Rechnungen (XTR) in Bots: der Zahlungsablauf für Entwickler, Schritt für Schritt

Digitale Güter in einem Bot gegen Stars verkaufen: sendInvoice mit XTR, die Antwort auf pre_checkout_query innerhalb von 10 Sekunden, successful_payment, Speichern der Zahlungskennung und eine Checkliste für den Start.

Veröffentlicht:

Telegram Stars-Rechnungen (XTR) in Bots: der Zahlungsablauf für Entwickler, Schritt für Schritt

Verkauft Ihr Bot etwas Digitales, etwa ein Abonnement, Inhalte, KI-Anfragen oder Gegenstände im Spiel? Dann erfolgt die Zahlung ausschließlich in Telegram Stars. Dieser Artikel führt den Ablauf einer Telegram Stars-Rechnung (XTR) aus Entwicklersicht durch und folgt der offiziellen Bot-API-Dokumentation. Warum es Stars sein müssen, erfahren Sie unter digitale Güter in Bots nur über Stars.

Der Ablauf im Überblick

SchrittWas der Bot tutWas Telegram sendet
1sendInvoice mit currency = XTR—
2Wartetpre_checkout_query
3answerPreCheckoutQuery (innerhalb von 10 Sekunden)—
4Wartetsuccessful_payment
5Speichert die Zahlungskennung und liefert die Güter—

Schritt 1: Rechnung erstellen

Es gibt zwei Wege:

  • Bot-Rechnung: die Methode sendInvoice. Da die Güter digital sind, ist provider_token eine leere Zeichenkette und das Feld currency lautet XTR. Die Rechnung kann in einen privaten Chat, eine Gruppe oder einen Kanal gehen.
  • Inline-Rechnung: Unterstützt Ihr Bot den Inline-Modus, können Nutzer die Rechnung mit inputInvoiceMessageContent an Freunde, Gruppen und Kanäle weitergeben. Die Schaltfläche „Bezahlen“ lässt sich mehrfach verwenden.

Schritt 2: Weiterleitungsverhalten festlegen

Der Parameter start_parameter steuert dies:

  1. Multi-Chat-Rechnung: Weitergeleitete Kopien behalten eine Schaltfläche „Bezahlen“, sodass viele Nutzer zahlen können. Inline-Rechnungen sind immer Multi-Chat.
  2. Single-Chat-Rechnung: zahlbar nur in dem Chat, an den sie gesendet wurde; weitergeleitete Kopien zeigen stattdessen eine Deep-Link-Schaltfläche zum Bot.

Beachten Sie, dass eine Single-Chat-Rechnung im privaten Chat mit Ihrem Bot nur einmal bezahlt werden kann. In jedem Fall entscheidet Ihr Bot stets, ob eine neue Zahlung akzeptiert wird.

Schritt 3: Vorprüfung

Der Nutzer (kauft bei Bedarf zuerst Stars) tippt auf „Bezahlen“. Ihr Bot erhält eine pre_checkout_query mit den Bestelldetails und muss mit answerPreCheckoutQuery innerhalb von 10 Sekunden antworten, sonst wird die Transaktion abgebrochen. Lehnen Sie ab, geben Sie einen verständlichen Grund an; Telegram zeigt ihn dem Nutzer.

Schritte 4–5: Kasse und Lieferung

Bei erfolgreicher Zahlung trifft eine Nachricht successful_payment ein. Erst dann sollten Sie liefern, denn die Antwort auf pre_checkout_query garantiert nicht, dass die Zahlung durchgegangen ist. Speichern Sie die telegram_payment_charge_id; Sie brauchen sie für Rückerstattungen.

Bevor Sie live gehen

  • Aktivieren Sie die Zwei-Schritt-Verifizierung für das Konto, das den Bot steuert.
  • Stellen Sie die Bedingungen über /terms und den Support über /support und /paysupport bereit.
  • Seien Sie auf Streitfälle und Rückerstattungen mit refundStarPayment vorbereitet. Mehr dazu unter Stars-Rückerstattungen und /paysupport.
  • Halten Sie den Server stabil und sichern Sie die Zahlungsdaten.

So testen Sie

Die spezielle Testumgebung von Telegram ermöglicht kostenlose Tests von Zahlungen mit Stars. Sobald alles funktioniert, wechseln Sie in den Produktivbetrieb.

Die Seite des Stars-Kaufs

Ihre Nutzer kaufen Stars in der App oder über @PremiumBot, und PayStars verkauft sie gegen USDT. Muss Ihr eigener Dienst Stars automatisch kaufen, decken die PayStars API und die API-Übersicht das ab.

Häufige Fragen

Kann ich Krypto oder eine andere Währung statt Stars akzeptieren?

Nein. Digitale Güter und Dienstleistungen in Telegram-Apps werden ausschließlich in Stars bezahlt.

Wie teste ich Zahlungen?

Verbinden Sie Ihren Bot mit der speziellen Testumgebung von Telegram, in der sich Zahlungen mit Stars kostenlos testen lassen.

Wie erstatte ich etwas zurück?

Mit der Methode refundStarPayment in der Bot API.

Quellen

Stars und Premium mit USD (USDT) kaufen

Per API-Schlüssel: reiner Fragment-Preis, 0 % (Website: 5 %).

Jetzt starten