Telegram-Mini-App-Zahlungen: Krypto innerhalb einer Mini-App annehmen
Telegram-Mini-App-Zahlungen erklärt: Krypto innerhalb einer Telegram-Mini-App annehmen, was Qvard für Mini-Apps plant und der Weg über die API heute.
Telegram-Mini-App-Zahlungen bedeuten, dass ein Shop, der als Web-App innerhalb von Telegram gebaut ist, für seine Artikel Krypto annimmt. Qvard plant einen Checkout für Mini-Apps, der noch nicht veröffentlicht ist. Dieser Leitfaden erklärt, wie eine Zahlung in einer Mini-App funktionieren würde, und den Weg, der heute funktioniert: Das Backend der Mini-App legt die Zahlung über die API an, öffnet die gehostete Seite und bestätigt die Bestellung per Webhook.
Was eine Zahlung in einer Mini-App ist
Eine Telegram-Mini-App ist eine Web-Anwendung, die sich im Chat öffnet. Eine Zahlung in einer Mini-App heißt, dass der Kunde in der App einen Artikel wählt und ihn bezahlt, ohne Telegram lange zu verlassen.
Status: Mini-App-Checkout steht auf der Roadmap
Ein nativer Qvard-Checkout für Telegram-Mini-Apps ist noch nicht veröffentlicht, und dieser Artikel beschreibt ihn nicht als verfügbar. Der Weg unten nutzt die Live-API, die gehostete Zahlungsseite und den Webhook.
Was heute funktioniert
Das Backend der Mini-App legt die Zahlung mit POST /api/v1/payment und dem Header x-api-key an, erhält eine redirectUrl und öffnet für den Kunden die gehostete Seite. Danach liefert der Webhook den finalen Status an das Backend, das den Artikel freischaltet.
Den Schlüssel im Backend behalten
Eine Mini-App läuft im Browser des Kunden, der API-Schlüssel darf daher niemals im Frontend-Code stehen. Nur das Backend ruft POST /api/v1/payment auf.
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
}Den Artikel per Webhook freischalten
Die Mini-App zeigt den Artikel erst als freigeschaltet, wenn der Webhook die id und den Status paid für diese Bestellung übermittelt hat. Bis dahin bleibt der Artikel gesperrt, auch wenn der Kunde zur App zurückkehrt.
Für den nativen Mini-App-Checkout planen
Wenn der native Checkout erscheint, könnte sich das Zahlungsfenster direkt in der App öffnen. Bis dahin halten Sie die Bestelllogik und den Webhook im Backend, sodass später nur das Frontend wechselt.
FAQ
Kann eine Telegram-Mini-App heute Krypto annehmen?
Ja. Das Backend der Mini-App legt die Zahlung über die API an, öffnet die gehostete Seite und schaltet den Artikel frei, sobald der Webhook den Status paid bestätigt. Der native Mini-App-Checkout steht auf der Roadmap.
Darf die Mini-App die Zahlungs-API direkt aus dem Browser aufrufen?
Nein. Bewahren Sie den API-Schlüssel im Backend auf und rufen Sie den Zahlungs-Endpoint nur von dort aus auf.
Muss der Kunde die Mini-App verlassen?
Heute öffnet sich für die Zahlung die gehostete Seite, und das Ergebnis kommt über Ihr Backend und den Webhook zurück in die Mini-App.
Wie teste ich eine Zahlung in der Mini-App?
Legen Sie aus einem Testartikel eine Demo-Rechnung an, bezahlen Sie sie auf der gehosteten Seite und prüfen Sie, dass der Artikel nach dem Webhook freigeschaltet wird.
