Paiements dans une mini app Telegram : encaisser la crypto dans une mini app
Paiements dans une mini app Telegram : encaisser la crypto dans une mini app Telegram, le checkout des mini apps prévu par Qvard et le chemin de l’API.
Les paiements dans une mini app Telegram signifient qu’une boutique conçue comme application web dans Telegram encaisse la crypto pour ses articles. Qvard prévoit un checkout pour les mini apps, qui n’est pas encore publié. Ce guide explique comment fonctionnerait un paiement dans une mini app et le parcours qui marche aujourd’hui : le backend de la mini app crée le paiement via l’API, ouvre la page hébergée et confirme la commande par webhook.
Qu’est-ce qu’un paiement dans une mini app
Une mini app Telegram est une application web qui s’ouvre dans le chat. Un paiement dans une mini app signifie que le client choisit un article dans l’application et le paie sans quitter Telegram trop longtemps.
Statut : le checkout des mini apps est sur la feuille de route
Un checkout Qvard natif pour les mini apps Telegram n’est pas encore publié, et cet article ne le présente pas comme disponible. Le parcours ci-dessous utilise l’API en production, la page hébergée et le webhook.
Ce qui fonctionne aujourd’hui
Le backend de la mini app crée le paiement avec POST /api/v1/payment et l’en-tête x-api-key, reçoit un redirectUrl et ouvre la page hébergée pour le client. Ensuite, le webhook transmet le statut final au backend, qui débloque l’article.
Garder la clé sur le backend
Une mini app s’exécute dans le navigateur du client : la clé d’API ne doit donc jamais figurer dans le code front-end. Seul le backend appelle POST /api/v1/payment.
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
}Débloquer l’article par webhook
La mini app n’affiche l’article comme débloqué qu’après que le webhook a transmis l’id et le statut paid de cette commande. Jusque-là, l’article reste verrouillé, même si le client revient dans l’application.
Prévoir le checkout natif des mini apps
Lorsque le checkout natif sortira, la fenêtre de paiement pourra s’ouvrir dans l’application. D’ici là, gardez la logique de commande et le webhook sur le backend, pour que seul le front-end change ensuite.
FAQ
Une mini app Telegram peut-elle encaisser la crypto aujourd’hui ?
Oui. Le backend de la mini app crée le paiement via l’API, ouvre la page hébergée et débloque l’article une fois que le webhook confirme le statut paid. Le checkout natif des mini apps est sur la feuille de route.
La mini app peut-elle appeler l’API de paiement directement depuis le navigateur ?
Non. Gardez la clé d’API sur le backend et n’appelez l’endpoint de paiement que depuis là.
Le client doit-il quitter la mini app ?
Aujourd’hui, la page de paiement hébergée s’ouvre pour le paiement, et le résultat revient à la mini app via votre backend et votre webhook.
Comment tester un paiement dans une mini app ?
Créez une facture de démo à partir d’un article de test, payez-la sur la page hébergée et vérifiez que l’article se débloque après le webhook.
