Paiements crypto dans un bot Telegram : ajouter le paiement crypto à votre bot
Paiements crypto dans un bot Telegram : comment ajouter le paiement crypto à votre bot, le checkout natif prévu par Qvard et le parcours actuel via l’API.
Un bot Telegram avec paiements crypto enregistre la commande dans le chat et envoie au client un bouton de paiement. Qvard prévoit un checkout natif pour Telegram, qui n’est pas encore publié. Ce guide montre comment ajouter le paiement crypto à un bot dès aujourd’hui, avec l’API en production, la page hébergée et le webhook.
Ce que le bot doit faire
Le bot recueille la commande, crée le paiement sur votre backend, envoie au client le bouton et attend le webhook. Le chat sert de vitrine, tandis que le paiement lui-même a lieu sur la page hébergée.
Statut : le checkout natif pour bots est sur la feuille de route
Un checkout natif Qvard pour bots Telegram n’est pas encore publié, et cet article ne le présente pas comme disponible. L’intégration ci-dessous fonctionne aujourd’hui avec l’API existante.
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 de paiement depuis le backend du bot
Le backend du bot envoie POST /api/v1/payment avec l’en-tête x-api-key, l’identifiant de commande dans id et le total en USD dans price. La réponse contient le redirectUrl, qui devient le bouton.
Le bouton et le message de commande
Envoyez un seul message avec la commande, le montant et le bouton vers le redirectUrl. Gardez-le court, et ne promettez ni livraison ni accès avant que le webhook ne confirme le paiement.
Recevoir le statut sur votre backend
Votre endpoint webhook reçoit id et status, vérifie l’en-tête x-api-key et met la commande à jour. Seul le statut paid doit débloquer le produit ou le service.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Gérer les répétitions et les échecs
Si le client ferme la page, la commande reste en attente et le bot peut proposer à nouveau le même lien de paiement. Rendez le gestionnaire de webhook sûr en cas de répétition, car le même message peut arriver deux fois.
FAQ
Un bot Telegram peut-il encaisser la crypto aujourd’hui ?
Oui. Le bot crée le paiement via l’API, envoie un bouton vers le redirectUrl et confirme la commande par webhook. Le checkout natif Telegram est sur la feuille de route.
Ai-je besoin d’un framework de bot particulier ?
Non. Tout code de bot capable d’appeler un endpoint HTTPS et de recevoir un webhook peut créer des paiements via l’API.
Où stocker la clé d’API ?
Uniquement sur le backend du bot. Ne mettez jamais la clé dans les messages du chat ni dans du code visible par le client.
Comment tester le paiement 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 reçoit le webhook.
