Accepter des paiements dans Telegram
Cette solution s’adresse aux services qui vendent via Telegram : un bot qui envoie des liens de paiement dans une conversation, ou une mini-app, c’est-à-dire une application web qui s’ouvre dans Telegram. Vos clients paient sans quitter Telegram, le bot confirme la commande dans la conversation et l’argent arrive sur votre solde Volet.com, prêt à être retiré ou à servir au paiement de vos partenaires.
Est-ce pour vous ?
Cette solution vous convient si vous :
- Vendez via un bot un service utilisé en dehors de Telegram : un VPN, un hébergement, un produit SaaS, du conseil, des cours ou une réservation.
- Vendez des biens physiques via un bot ou une mini-app.
- Permettez aux utilisateurs de recharger depuis Telegram un solde dans votre propre service.
- Payez des partenaires ou des utilisateurs avec l’argent que collecte votre bot.
Un compte personnel suffit. Un compte Business n’est nécessaire que si les paiements doivent se faire au nom d’une entreprise ou si vos volumes dépassent les limites d’un compte personnel. Voir Choisir un compte personnel ou professionnel.
Envisagez une autre option si :
- Vous vendez des biens numériques ou du contenu utilisés dans Telegram même : publications payantes, objets de jeu, accès à une chaîne privée. Telegram impose pour cela sa propre monnaie, les Telegram Stars ; voir Vérifier ce que Telegram autorise ci-dessous.
- Vous gérez le bot seul et débutez. Voir Lancer un service en ligne payant ; tout ce que cette page dit de Telegram s’applique aussi.
- Vous payez aussi des prestataires, des partenaires ou des utilisateurs depuis le même solde. Pour la partie paiements sortants, voir Permettre aux utilisateurs de recharger et de retirer.
Vérifier ce que Telegram autorise
Telegram impose les Telegram Stars pour les biens et services numériques vendus et utilisés dans un bot ou une mini-app. Vous ne pouvez pas les vendre contre des cryptos via une passerelle de paiement. Voir les pages de Telegram sur les paiements de biens numériques et les conditions pour les développeurs de bots.
Une passerelle de paiement comme Volet.com convient à tout le reste : services utilisés en dehors de Telegram, biens physiques, recharges d’un solde dans votre propre service, paiements aux partenaires et règlements entre entreprises.
Ce que vous pouvez faire
Accepter des paiements
- Laissez vos clients payer en crypto depuis n’importe quel portefeuille externe, par exemple en USDT sur Tron ou en TON, ou depuis leur solde Volet.com. Les clients qui paient en crypto n’ont pas besoin de compte Volet.com. — Accepter les paiements crypto dépositaires, Accepter les paiements des utilisateurs Volet.com
- Ouvrez la page Hosted Checkout dans la mini-app : elle se charge dans le navigateur intégré de l’application, avec votre logo et les couleurs de votre marque. — Créer une passerelle de paiement
- Construisez votre propre écran de paiement dans la conversation ou la mini-app avec l’API, et affichez vous-même l’adresse et le montant aux clients. — Intégration API
- Indiquez à la passerelle l’adresse de votre bot, par exemple
https://t.me/example_bot: les clients la voient sur la page de paiement. — Configurer les paramètres - Présélectionnez le moyen de paiement et la langue de la page de paiement pour votre audience. — Configuration avancée de Hosted Checkout
Conserver et utiliser l’argent
- Recevez chaque paiement dans la devise de votre choix, quelle que soit celle utilisée par le client ; USD, USDT et USDC se convertissent à 1:1. — Règlement et conversion automatique
- Payez des partenaires ou des utilisateurs depuis le même solde, ou retirez vers un compte bancaire, une carte ou un portefeuille crypto. — Retirer ou envoyer des fonds
Qui fait quoi
| Ce qu’il faut | Voit et fait | Responsable de | |
|---|---|---|---|
| Vous | Un compte Volet.com vérifié, personnel ou Business, une passerelle de paiement approuvée, un bot créé dans @BotFather, un backend | Crée la demande de paiement, envoie le bouton de paiement ou ouvre la page de paiement, confirme la commande dans la conversation | Le respect des règles de Telegram, votre produit et sa livraison, les remboursements, le support client dans le bot |
| Vos clients | Telegram, et un portefeuille crypto ou un compte Volet.com | Appuient sur le bouton dans la conversation ou paient dans la mini-app, voient la page de paiement Volet.com avec l’adresse de votre bot | Le paiement sur le réseau indiqué sur la page |
| Telegram | — | Héberge votre bot et votre mini-app | Ses propres règles de paiement dans les bots, dont les Telegram Stars pour les biens numériques |
| Volet.com | — | Héberge la page de paiement, surveille la blockchain, contrôle les cryptos entrantes (AML), convertit les devises, notifie votre backend | Le traitement des paiements et le support pour les problèmes de paiement. Volet.com ne livre pas votre produit et ne rembourse pas vos clients |
Le parcours de l’argent
- Le client choisit un produit dans votre bot ou votre mini-app.
- Votre backend crée une demande de paiement dans Volet.com et enregistre l’identifiant de l’utilisateur Telegram avec la commande.
- Le bot envoie un bouton de paiement, ou la mini-app ouvre la page de paiement.
- Le client paie en crypto ou depuis son solde Volet.com. Pour la crypto, Volet.com attend les confirmations du réseau et contrôle le paiement.
- Le paiement est crédité sur votre compte dans votre devise de règlement et est disponible immédiatement.
- Volet.com envoie une notification à votre backend ; le bot confirme la commande dans la conversation et livre le produit.
Mise en place
Étape 1 : créer une passerelle de paiement
Commencez par Hosted Checkout : la page de paiement est hébergée par Volet.com, fonctionne dans une mini-app et prend en charge les paiements en crypto comme depuis un solde. Choisissez l’API si vous voulez que l’écran de paiement fasse partie de votre conversation ou de votre mini-app. Dans les paramètres de la passerelle, saisissez l’adresse de votre bot, activez la signature numérique, décidez si vous acceptez les paiements insuffisants et excédentaires, et indiquez la Status URL de votre backend. L’approbation prend généralement quelques heures. Voir Créer une passerelle de paiement et Choisir une méthode d’intégration.
Étape 2 : créer un bot dans Telegram
- Ouvrez @BotFather dans Telegram et créez un bot avec la commande
/newbot. - Enregistrez le jeton du bot. Votre backend l’utilise pour envoyer des messages via la Telegram Bot API.
- Pour ouvrir une interface web dans Telegram, créez une mini-app dans @BotFather et indiquez l’URL de votre application web. Voir Telegram Mini Apps.
Pour un premier bot, suivez le tutoriel de Telegram.
Étape 3 : afficher la page de paiement
- Dans une conversation avec le bot : envoyez un message avec un bouton inline qui ouvre votre URL de paiement. Voir InlineKeyboardButton.
- Dans une mini-app : ouvrez la page Hosted Checkout dans la mini-app, ou dans le navigateur de l’appareil avec
Telegram.WebApp.openLink. Voir Telegram Mini Apps.
Votre backend crée la demande de paiement avant l’ouverture de la page, afin que le bot puisse rapprocher le paiement de la commande. Voir Intégration de Hosted Checkout.
Étape 4 : confirmer la commande dans la conversation
Lorsque votre backend reçoit la notification de paiement et en vérifie la signature, envoyez un message au client depuis le bot et livrez le produit. Ne comptez pas sur le retour du client dans la conversation ou la mini-app.
Étape 5 : encaisser le premier paiement via le bot
Volet.com ne propose pas de sandbox, le premier paiement est donc un paiement réel : payez vous-même un petit montant via le bot, depuis un portefeuille crypto et depuis un compte Volet.com, et vérifiez que la confirmation arrive dans la conversation. L’intégration d’un petit bot prend environ une journée. Dès lors, chaque vente arrive sur votre solde : retirez-la, conservez-la en stablecoins ou utilisez-la pour payer vos partenaires. Voir Retirer ou envoyer des fonds.
Option en auto-garde
Dans une mini-app, les clients peuvent aussi payer directement de leur propre portefeuille vers le vôtre, via un smart contract Volet.com. Cela convient aux bots destinés à une audience habituée à la crypto et aux projets qui doivent détenir eux-mêmes leurs fonds.
- La mini-app connecte le portefeuille du client. Telegram impose TON Connect pour la connexion des portefeuilles dans une mini-app.
- Le client confirme le paiement dans son portefeuille, en USDT, en USDC ou en token natif sur un réseau pris en charge, TON compris.
- Le paiement arrive sur votre portefeuille ; votre backend vérifie la transaction on-chain et le bot confirme la commande dans la conversation.
- Pour retirer vers du fiat ou payer des partenaires via Volet.com, envoyez une partie des cryptos sur votre compte Volet.com. Une recharge sur une adresse permanente de votre portefeuille crypto, dans la même devise, est sans frais Volet.com. Voir Ajouter des fonds.
Ce qui change : les clients paient uniquement depuis des portefeuilles et paient les frais de réseau ; il n’y a pas de conversion automatique ; la configuration se fait au cas par cas avec l’équipe commerciale, qui peut aussi adapter le contrat à la logique de votre bot, par exemple des abonnements ou un accès réservé aux détenteurs d’un token. Voir Développement de smart contracts sur mesure. Voir Accepter les paiements crypto non dépositaires et Accepter des cryptos sur votre propre portefeuille.
Au quotidien
- Abonnements. Les paiements en crypto ne sont pas prélevés automatiquement chaque mois. Laissez vos clients recharger un solde dans votre service et déduisez-en l’abonnement selon votre calendrier, ou envoyez un nouveau bouton de paiement avant chaque période.
- Paiements en retard ou incomplets. Une demande de paiement en crypto est valable 60 minutes sans conversion et 15 minutes avec conversion. Un paiement en retard est renvoyé au client ou, dans certains cas, crédité sur votre compte. Vos paramètres de paiement insuffisant et excédentaire déterminent si un montant inférieur ou supérieur finalise la commande. Voir Traitement des paiements.
- « J’ai payé, mais le bot ne répond pas. » Vérifiez le statut de la commande dans votre backend ou via l’API avant de répondre ; le client a peut-être payé sur un autre réseau ou après l’expiration de la demande. Voir Un client affirme que le paiement est confirmé, mais la commande n’est pas payée.
- Remboursements. Volet.com n’annule pas les paiements effectués. Remboursez vous-même vos clients, par exemple par un transfert vers leur compte Volet.com ou par un paiement en crypto.
- Faux bots. Indiquez à vos clients quel est votre bot, et ne leur demandez jamais de connecter un portefeuille ou de payer en dehors de votre bot et de votre mini-app officiels.
- Comptabilité. Téléchargez vos relevés et conservez l’identifiant de l’utilisateur Telegram et l’identifiant de commande avec chaque paiement. Voir Relevés de compte.
Bon à savoir
- Les règles de Telegram priment. Les biens numériques utilisés dans Telegram se paient en Telegram Stars. Si vous acceptez des paiements depuis le propre portefeuille du client dans une mini-app (paiements non dépositaires), Telegram impose TON Connect pour la connexion du portefeuille. Les paiements via Hosted Checkout ou l’API ne connectent pas de portefeuille.
- Examen de la passerelle. Volet.com examine chaque nouvelle passerelle et le bot ou le site qu’elle dessert.
- Contrôle AML. Les paiements crypto entrants sont contrôlés, généralement dans le délai de traitement habituel. Voir Contrôle des transactions.
- Transactions définitives. Les paiements blockchain confirmés ne peuvent être ni annulés ni contrepassés.
- Limites. Vos limites actuelles s’affichent avant la confirmation de chaque transaction. Voir Limites.
Coûts
| Frais | Qui paie | Quand |
|---|---|---|
| Frais de traitement | Vous ; pour les paiements depuis un solde, vous pouvez les ajouter au montant payé par le client | À chaque paiement |
| Frais de réseau du paiement en crypto | Votre client | Lorsqu’il paie en crypto |
| Conversion | Vous | Lorsque le client paie dans une autre devise que votre devise de règlement, sauf les conversions 1:1 entre USD, USDT et USDC |
| Frais de retrait ou de paiement | Vous | Lorsque vous retirez ou payez des partenaires |
Il n’y a pas de frais de mise en place ni de frais mensuels côté Volet.com. Voir la page des frais pour les entreprises. Le montant exact des frais s’affiche toujours avant la confirmation.
Quand votre activité se développe
- Payez des partenaires ou des utilisateurs depuis le solde du bot. Voir Permettre aux utilisateurs de recharger et de retirer.
- Ajoutez un site au même solde avec Hosted Checkout ou un plugin CMS. Voir Lancer un service en ligne payant.
Pour les offres actuelles, consultez la page produit de la passerelle de paiement crypto.
Voir aussi
- Intégration de Hosted Checkout — demandes de paiement, notifications et signatures
- Intégration API — construire votre propre écran de paiement
- Échec d’un paiement à un service en ligne — ce que voient vos clients en cas de problème
- Les paiements crypto dans les mini-apps Telegram — un article de blog sur les règles et les coûts de Telegram
- Calculateur d’économies sur les paiements en stablecoins pour les entreprises — un calculateur du blog : ce que vous coûtent aujourd’hui les paiements clients et les paiements aux prestataires, et ce qu’ils coûteraient en stablecoins