Accepter les paiements crypto dans Telegram : prévu et opérationnel aujourd’hui
Accepter les paiements crypto dans Telegram : un parcours via bot, ce que prévoit le checkout Telegram de Qvard et le chemin qui marche avec l’API.
Accepter les paiements crypto dans Telegram signifie que le client règle sa commande dans une conversation avec votre bot. Qvard prévoit un checkout Telegram, qui n’est pas encore publié. Ce guide explique le parcours et le chemin qui marche aujourd’hui : le bot crée le paiement via l’API, le bouton mène à la page hébergée et le webhook confirme la commande.
Pourquoi Telegram est un canal utile
De nombreuses boutiques et communautés vendent déjà via des bots et des canaux Telegram. Une étape de paiement dans la conversation évite d’envoyer le client sur un autre site avant de passer commande.
Statut : le checkout Telegram est sur la feuille de route
Un checkout Qvard natif dans 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 du bot crée le paiement avec POST /api/v1/payment et l’en-tête x-api-key, reçoit un redirectUrl et l’envoie au client sous forme de bouton. Le client paie sur la page hébergée, et le webhook transmet le statut final à votre 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
}L’appel depuis le serveur du bot
Envoyez l’identifiant de commande dans id et le prix en USD dans price depuis le backend du bot. Gardez la clé d’API dans la configuration serveur, jamais dans la logique du chat que voient les clients.
Afficher la commande dans le chat
Envoyez au client un court message avec le récapitulatif de la commande et le bouton qui ouvre le redirectUrl. Utilisez un langage simple et affichez le total, pour que le client sache ce qu’il paie.
Confirmer la commande par webhook
Lorsque le webhook transmet l’id et le statut paid, marquez la commande comme payée et envoyez la confirmation dans le chat. Un clic sur le bouton ne confirme pas la commande à lui seul.
FAQ
Existe-t-il aujourd’hui un checkout Qvard natif dans Telegram ?
Pas encore. Le checkout Telegram est sur la feuille de route. Aujourd’hui, le bot utilise l’API, un bouton avec le redirectUrl et le webhook.
Le client doit-il quitter Telegram ?
La page de paiement s’ouvre depuis le bouton. La conversation reste dans le chat, et le résultat revient au bot par votre webhook.
Puis-je utiliser cela avec un bot que j’ai déjà ?
Oui. Ajoutez l’appel de paiement et le bouton à la logique de votre bot existant, et gérez le webhook dans votre backend.
Comment tester le parcours du bot ?
Créez une facture de démo à partir d’une commande de test, payez-la sur la page hébergée et vérifiez que le bot confirme la commande après le webhook.
