Krypto-Zahlungen im Telegram-Bot akzeptieren (USDT Schritt für Schritt)
Telegram-Bots und bezahlte Communities leben von sofortiger Auslieferung. So binden Sie ein Krypto-Payment-Gateway in Ihren Bot ein, damit Nutzer in USDT zahlen und automatisch Zugang erhalten.
Um Krypto-Zahlungen in einem Telegram-Bot zu akzeptieren, lässt das Backend des Bots über die API eines Krypto-Payment-Gateways eine Rechnung erstellen, sobald der Nutzer auf „Kaufen“ tippt, sendet den zurückgegebenen Checkout-Link als Inline-Button und lauscht auf den signierten Webhook des Gateways. Ist die Zahlung bestätigt, liefert der Bot Produkt, Schlüssel oder Kanal-Einladung automatisch aus.
Telegram-Bots und bezahlte Communities passen besonders gut zum Krypto-Checkout: Die Nutzer sind international, viele halten bereits USDT, und sie erwarten die Lieferung in Sekunden. Dieser Leitfaden zeigt Architektur, Nachrichtenfluss und die Details, die das Ganze zuverlässig machen.
Warum Krypto so gut zu Telegram-Bots passt
- Globales Publikum: Bot-Nutzer kommen von überall; ein einziger USDT-Preis funktioniert für alle.
- Mobile-first-Zahlung: Der gehostete Checkout öffnet sich im Telegram-Browser, und eine Wallet-App kann den QR-Code scannen oder die Adresse kopieren.
- Sofortige Automatisierung: Ein signierter Webhook lässt den Bot ausliefern, ohne dass jemand einen Block-Explorer prüft.
- Schnelle Netzwerke: Auf TRON und BNB Smart Chain werden Zahlungen meist in etwa einer Minute bestätigt.
Telegram-Bots und bezahlte Communities gehören neben SaaS, Hosting und digitalen Gütern zu den Kern-Anwendungsfällen, für die mistKET gebaut wurde.
Architektur: drei Komponenten
| Komponente | Aufgabe |
|---|---|
| Telegram-Bot (über die Bot API) | Spricht mit dem Nutzer: Menüs, Buttons, Liefernachrichten |
| Ihr Backend | Speichert Bestellungen, ruft die Gateway-API auf, empfängt Webhooks, verwahrt Secrets |
| mistKET-Gateway | Gehosteter Checkout, Blockchain-Überwachung, Bestätigungen, Abrechnung |
Egal welches Framework Sie nutzen – das Muster, um Krypto-Zahlungen im Telegram-Bot zu akzeptieren, ist immer gleich. Bot und Backend sind meist ein und derselbe kleine Dienst. Entscheidend ist, dass API- und Webhook-Secrets auf dem Server liegen – niemals in Nachrichten oder clientseitigem Code. Die offizielle Telegram-Dokumentation für Bots finden Sie unter core.telegram.org.
Schritt für Schritt: Krypto-Zahlungen im Telegram-Bot akzeptieren
- Nutzer wählt ein Produkt — z. B. „1 Monat Zugang“ über eine Inline-Tastatur. Ihr Backend legt eine Bestellung mit der Telegram-User-ID an.
- Backend erstellt eine Rechnung — ein einziger signierter
POST /api/v1/invoicesmit Betrag, Währung, Ihrer Bestell-ID und einer Callback-URL. - Bot sendet einen Bezahl-Button — einen Inline-URL-Button auf die zurückgegebene
checkout_url, dazu ein kurzer Hinweis: „Senden Sie den exakten Betrag im gewählten Netzwerk.“ - Nutzer zahlt — auf der gehosteten Seite wählt er USDT auf TRON, BSC, Ethereum oder Arbitrum (oder TRX, BNB, ETH) und zahlt aus seiner Wallet oder von seiner Börse.
- Webhook trifft ein — nach den Bestätigungen erhält Ihr Callback ein signiertes
invoice.confirmed-Event mit Ihrer Bestell-ID. - Bot liefert aus — Signatur prüfen, Bestellung als bezahlt markieren, dann Lizenzschlüssel, Datei oder einen Einmal-Einladungslink zum Kanal in den Chat des Nutzers senden.
Ein minimales Datenmodell
Für einen kostenpflichtigen Bot brauchen Sie keine komplexe Datenbank. Drei Tabellen decken die meisten Fälle ab:
| Tabelle | Wichtige Felder | Zweck |
|---|---|---|
| users | telegram_id, username, access_until | Wer Zugang hat und bis wann |
| orders | order_id, telegram_id, product, amount, status | Eine Zeile pro Kaufversuch |
| invoices | order_id, invoice_uuid, checkout_url, network, paid_amount | Verknüpfung zwischen Ihrer Bestellung und der Gateway-Rechnung |
Trifft der Webhook ein, suchen Sie die Bestellung über order_id, prüfen, ob sie nicht schon ausgeliefert wurde, aktualisieren den Status und schreiben dem Nutzer über seine telegram_id. Das ist der gesamte Lieferzyklus.
Beispieltexte für Nachrichten
Klare Formulierungen im Chat reduzieren Support-Anfragen. Eine Abfolge, die sich bewährt:
- Rechnungsnachricht: „Ihre Bestellung: 1 Monat Zugang, 15 USD. Tippen Sie auf Bezahlen, um die sichere Zahlungsseite zu öffnen. Senden Sie den exakten Betrag im gewählten Netzwerk.“
- Bezahlt: „Zahlung erkannt. Wir warten auf die Netzwerkbestätigungen – das dauert meist ein bis zwei Minuten.“
- Bestätigt: „Zahlung bestätigt. Hier ist Ihr Einladungslink – er funktioniert genau einmal.“
- Unterbezahlt: „Wir haben weniger als den Rechnungsbetrag erhalten. Öffnen Sie dieselbe Zahlungsseite, um den Restbetrag zu senden.“
- Abgelaufen: „Diese Rechnung ist abgelaufen. Tippen Sie unten für eine neue.“
Support ohne Screenshots
Fragt ein Nutzer nach einer Zahlung, bitten Sie nur um die Bestellnummer. Öffnen Sie die Rechnung im Händler-Dashboard, sehen Sie erwarteten Betrag, erhaltenen Betrag, Netzwerk und Transaktions-Hash – Screenshots oder Wallet-Adressen des Nutzers brauchen Sie nie. Ein „Support“-Button im Bot kann die Bestellnummer automatisch mitschicken; so wird aus den meisten Zahlungsfragen eine Zehn-Sekunden-Abfrage statt eines langen Gesprächs.
Gute UX-Muster im Chat
- Status-Updates senden. Bei
invoice.paidantworten Sie „Zahlung gesehen, warte auf Bestätigungen“; beiinvoice.confirmedliefern Sie aus. - Preis in Dollar anzeigen und die Umrechnung dem Gateway überlassen. Der Kurs ist für die Laufzeit der Rechnung fixiert.
- Den Countdown einmal erklären, damit niemand beim Anblick eines Timers nervös wird.
- Einen Button „Status prüfen“ anbieten, der die Rechnung über die API abfragt – praktisch, wenn ein Nutzer später zurückkommt.
- Teilzahlungen freundlich behandeln. Bei
invoice.underpaidsagen Sie dem Nutzer, wie viel fehlt; Teilzahlungen summieren sich bis zum Gesamtbetrag. - Ablauf behandeln. Bei
invoice.expiredbieten Sie mit einem Tippen eine neue Rechnung an.
Abos und bezahlte Communities
Für monatlichen Zugang erstellen Sie zum Ende jeder Periode eine neue Rechnung und senden sie einige Tage vorher als Verlängerungsnachricht. Trifft invoice.confirmed ein, verlängern Sie das Zugangsdatum des Nutzers in Ihrer Datenbank. Geht bis Periodenende keine Zahlung ein, entziehen Sie den Zugang. Krypto-Überweisungen werden vom Zahler angestoßen, deshalb ist jede Verlängerung eine Rechnung, die der Nutzer selbst bezahlt – eine automatische Abbuchung wie bei Karten gibt es nicht.
Checkliste für Zuverlässigkeit
- Idempotenz: Webhooks werden über Stunden mit Back-off wiederholt, dasselbe Event kann also zweimal ankommen. Prüfen Sie vor jedem Versand, ob die Bestellung bereits ausgeliefert ist.
- Signaturprüfung: Verifizieren Sie
X-Mistket-Signature(HMAC-SHA256 aus Timestamp und Raw-Body mit Ihrem Webhook-Secret), bevor Sie einem Event vertrauen. - Chatnachrichten sind kein Beweis. Ein „Ich habe bezahlt“ oder ein Screenshot ersetzt niemals den Webhook.
- IP-Allowlist: Beschränken Sie den API-Zugriff im Händler-Panel auf Ihren Bot-Server.
- Logs: Das Dashboard zeigt Webhook-Zustellprotokolle, erwartete und erhaltene Beträge sowie Transaktions-Hashes für Supportfälle.
Vollständige Codebeispiele für Signierung und Verifizierung finden Sie unter Krypto-Payment-API-Integration.
Noch kein Entwickler? Starten Sie mit Zahlungslinks
Betreiben Sie eine kleine bezahlte Gruppe manuell, können Sie Rechnungen im Händler-Panel erstellen und den Link per Privatnachricht senden. Sobald die Zahlung im Dashboard bestätigt ist, fügen Sie das Mitglied von Hand hinzu. Das skaliert nicht, aber Sie können Ihre Preise validieren, bevor Sie einen Bot bauen. Siehe Krypto-Zahlungslinks und Rechnungen.
Jetzt starten
Bereit, Krypto-Zahlungen in Ihrem eigenen Telegram-Bot zu akzeptieren? Beantragen Sie ein Händlerkonto über Telegram @mistnetwork mit dem Link zu Ihrem Bot oder Ihrer Community und dem erwarteten Volumen. Nach der Freigabe erhalten Sie am selben Tag Ihre API-Schlüssel. Request- und Webhook-Beispiele finden Sie im Entwicklerbereich, Ihre Schlüssel verwalten Sie über den Händler-Login.
