Krypto-Zahlungen in Telegram annehmen: geplant und heute funktionsfähig
Krypto-Zahlungen in Telegram annehmen: der Ablauf über einen Bot, was der Telegram-Checkout von Qvard plant und der heute funktionierende Weg über die API.
Krypto-Zahlungen in Telegram anzunehmen heißt, dass der Kunde eine Bestellung direkt im Chat mit Ihrem Bot bezahlt. Qvard plant einen Telegram-Checkout, der noch nicht veröffentlicht ist. Dieser Leitfaden erklärt den Ablauf und den Weg, der heute funktioniert: Der Bot legt die Zahlung über die API an, der Button führt zur gehosteten Seite, und der Webhook bestätigt die Bestellung.
Warum Telegram ein nützlicher Kanal ist
Viele Shops und Communitys verkaufen bereits über Telegram-Bots und Kanäle. Ein Zahlungsschritt direkt im Chat erspart es, den Kunden vor der Bestellung auf eine andere Website zu schicken.
Status: der Telegram-Checkout steht auf der Roadmap
Ein nativer Qvard-Checkout in Telegram ist noch nicht veröffentlicht, und dieser Artikel beschreibt ihn nicht als verfügbar. Der Ablauf unten nutzt die Live-API, die gehostete Zahlungsseite und den Webhook.
Was heute funktioniert
Das Backend des Bots legt die Zahlung mit POST /api/v1/payment und dem Header x-api-key an, erhält eine redirectUrl und sendet sie dem Kunden als Button. Der Kunde bezahlt auf der gehosteten Seite, und der Webhook liefert den finalen Status an Ihr Backend.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Der Aufruf vom Server des Bots
Senden Sie die Bestell-ID als id und den Preis in USD als price aus dem Backend des Bots. Bewahren Sie den API-Schlüssel in der Serverkonfiguration auf, niemals in der Chat-Logik, die Kunden sehen können.
Die Bestellung im Chat anzeigen
Senden Sie dem Kunden eine kurze Nachricht mit der Bestellübersicht und dem Button, der die redirectUrl öffnet. Verwenden Sie einfache Sprache und zeigen Sie die Summe, damit der Kunde weiß, was er bezahlt.
Die Bestellung per Webhook bestätigen
Wenn der Webhook die id und den Status paid liefert, markieren Sie die Bestellung als bezahlt und senden die Bestätigung in den Chat. Ein Klick auf den Button allein bestätigt die Bestellung nicht.
FAQ
Gibt es heute einen nativen Qvard-Checkout in Telegram?
Noch nicht. Der Telegram-Checkout steht auf der Roadmap. Heute nutzt der Bot die API, einen Button mit der redirectUrl und den Webhook.
Muss der Kunde Telegram verlassen?
Die Zahlungsseite öffnet sich über den Button. Die Unterhaltung bleibt im Chat, und das Ergebnis kommt über Ihren Webhook zurück zum Bot.
Kann ich das mit einem Bot nutzen, den ich bereits habe?
Ja. Ergänzen Sie den Zahlungsaufruf und den Button in der bestehenden Bot-Logik und verarbeiten Sie den Webhook im Backend.
Wie teste ich den Bot-Ablauf?
Legen Sie aus einer Testbestellung eine Demo-Rechnung an, bezahlen Sie sie auf der gehosteten Seite und prüfen Sie, dass der Bot die Bestellung nach dem Webhook bestätigt.
