Facture crypto Telegram : envoyer une facture crypto depuis votre bot
Facture crypto Telegram expliquée : comment envoyer une facture crypto depuis un bot Telegram, la facture dans le chat prévue par Qvard et ce qui marche.
Une facture crypto Telegram est une demande de paiement envoyée dans le chat avec le montant, la devise et un bouton de paiement. Qvard prévoit un flux de factures dans Telegram, qui n’est pas encore publié. Ce guide montre comment envoyer dès aujourd’hui une facture crypto depuis un bot : le bot crée la facture via l’API et le bouton ouvre la page hébergée.
Ce que contient une facture crypto
Une facture affiche la commande, le montant en USD, la date limite de paiement et un bouton de paiement. Le client voit ce qu’il doit et peut payer sans quitter longtemps la conversation.
Statut : la facture dans le chat est sur la feuille de route
Un flux de factures natif dans Telegram n’est pas encore publié, et cet article ne le présente pas comme disponible. Le parcours ci-dessous crée la facture via l’API en production et la relie à la page hébergée.
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
}Créer la facture depuis le bot
Le backend du bot appelle POST /api/v1/payment avec l’en-tête x-api-key, l’identifiant de commande dans id et le montant en USD dans price. Le redirectUrl renvoyé est le lien de la facture que le bot envoie au client.
Rédiger un message de facture clair
Affichez le numéro de commande, le montant en USD, ce que le client achète et le bouton. Ajoutez une courte note indiquant que le montant exact en crypto apparaîtra sur la page suivante, à taux fixe.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Suivre le statut de la facture
Le webhook transmet le statut de l’identifiant de commande. Tant que le statut n’est pas paid, la facture reste ouverte, et le bot peut rappeler le client une fois.
Faire expirer les anciennes factures
Ne laissez pas une facture impayée ouverte indéfiniment. Marquez-la comme expirée dans votre système après votre propre délai, et ne créez un nouveau paiement que si le client le demande.
FAQ
Un bot Telegram peut-il envoyer une facture crypto aujourd’hui ?
Oui. Le bot crée le paiement via l’API, envoie le redirectUrl comme lien de facture et met la commande à jour depuis le webhook. Un flux de factures natif dans Telegram est sur la feuille de route.
La facture est-elle payée lorsque le client appuie sur le bouton ?
Non. La facture n’est payée que lorsque le webhook transmet l’id et le statut paid.
Puis-je renvoyer une facture impayée ?
Oui, renvoyez le même redirectUrl tant que le paiement est ouvert, et ne créez un nouveau paiement que si l’ancien a expiré.
Comment tester une facture ?
Créez une facture de démo et vérifiez le message, le bouton et le résultat du webhook avant d’utiliser de vraies commandes.
