Guide d'installation, Règles des Stars & Frais Réels
Telegram nécessite sa propre monnaie Stars (XTR) pour les biens et services numériques vendus à l'intérieur des bots et des Mini Apps.
Les passerelles de paiement crypto interviennent pour tout ce que Stars ne couvre pas : services du monde réel, biens physiques, soldes de plateforme, dépôts et paiements B2B. Ce guide explique ce qui est réellement autorisé, deux façons pratiques de mettre en place l'acceptation des cryptomonnaies, ce que cela coûte et une solution de contournement pour la seule chose que la crypto ne peut pas encore faire — les abonnements récurrents.
Principaux enseignements
Il existe deux façons pratiques d'accepter des cryptomonnaies via une Mini App ou un bot Telegram : la garde automatisée et la non-garde automatisée (contrat intelligent).
Aucune blockchain ne prend actuellement en charge de véritables abonnements récurrents sans compromis sérieux sur la sécurité — la solution pratique est un solde rechargeable dans l'application.
Les paiements par carte à l'intérieur de la WebView d'une Mini App rencontrent souvent des difficultés avec 3D Secure et les vérifications de fraude — une raison pratique pour laquelle les cryptomonnaies ont tendance à fonctionner plus facilement dans cet environnement spécifique.
Les fausses Mini Apps conçues pour vider les portefeuilles connectés représentent une menace active et croissante en 2026.
Bots vs. Mini Apps
La plupart des contenus "comment accepter des cryptomonnaies sur Telegram" concernent en réalité des bots : vous envoyez un lien de paiement ou une facture sous forme de message de chat, l'utilisateur clique dessus, et un navigateur (ou le paiement intégré) s'ouvre.
Une Mini App est différente : c'est une application web complète qui s'ouvre directement dans Telegram sous forme de WebView, avec sa propre interface, navigation, et — si vous le souhaitez — son propre flux de paiement intégré dans l'interface utilisateur plutôt que ajouté comme un lien.
Le portefeuille crypto — accessible depuis l'icône de pièce jointe dans n'importe quel chat Telegram — est un bon exemple de ce que cela ressent réellement en pratique : soldes, flux d'envoi/réception, sa propre navigation, le tout sans quitter le chat.
Si vous construisez un service d'abonnement, un marché ou une plateforme de jeux en ligne, vous êtes presque certainement en train de créer une Mini App, et non un simple bot. Les étapes de configuration ci-dessous s'appliquent aux deux, mais l'expérience de paiement est nettement meilleure à l'intérieur d'une Mini App car la page de paiement peut se trouver dans votre interface au lieu de rediriger l'utilisateur ailleurs.
Telegram Stars vs. passerelles crypto
La documentation des paiements par bot de Telegram exige que les biens et services numériques vendus dans un bot ou une Mini App utilisent les Telegram Stars (code de devise XTR) — pas de cartes, pas de crypto. Cela couvre des choses comme le déverrouillage de contenu premium, l'achat de monnaie in-app pour un jeu, ou le paiement d'un abonnement numérique consommé entièrement à l'intérieur de Telegram.
Volet.com · Vérification des paiements Telegram
Étoiles, ou une passerelle crypto ?
Choisissez ce que vous vendez. La réponse suit les propres Conditions de Service des Développeurs de Bot de Telegram, pas des conseils généraux.
Où les passerelles de paiement en crypto sont l'outil approprié et légitime :
Services fournis en dehors de Telegram — une connexion VPN, hébergement, un produit SaaS, conseil, tout ce que l'utilisateur consomme hors plateforme même s'il paie pour cela à l'intérieur d'un bot Telegram.
Biens physiques — tout ce qui est expédié ou remis en personne.
Soldes et dépôts de plateforme — recharger un portefeuille à l'intérieur de votre propre application (c'est aussi la solution pratique pour le problème d'abonnement ci-dessous).
Paiements B2B et transfrontaliers — paiements d'affiliation, règlements de marché entre entreprises, qui tombent complètement en dehors de la définition de Telegram des "biens numériques vendus dans l'application".
Paiements par carte à l'intérieur d'un WebView de Mini App
Il y a une raison technique pour laquelle la crypto a tendance à sembler plus fluide que les cartes spécifiquement dans l'environnement de Telegram. Les Mini Apps fonctionnent à l'intérieur d'un WebView — un navigateur intégré, pas un complet — et les processeurs de cartes ont souvent du mal avec cet environnement : les contrôles anti-fraude peuvent échouer, et les fenêtres de confirmation 3D Secure échouent fréquemment à s'ouvrir correctement ou à rendre le contrôle à la page, laissant le client bloqué en plein paiement sans étape suivante claire.
La crypto contourne ce problème, car il n'y a pas de réseau de cartes et pas d'étape 3D Secure dans la boucle à casser à l'intérieur d'un WebView en premier lieu. Détaillons cela plus en détail.
Deux façons d'accepter la crypto dans Telegram
Bien sûr, vous êtes toujours libre de partager une adresse de portefeuille à la main et de vérifier les paiements vous-même — mais cela ne s'échelonne pas au-delà de factures occasionnelles. Pour tout ce que vous construisez pour durer, vous choisissez vraiment entre deux modèles automatisés.
Acceptation automatisée sous garde
C'est ce que la plupart des entreprises veulent réellement. Vous intégrez une passerelle de paiement — via API ou Checkout Hébergé — et elle gère tout le flux :
La passerelle génère automatiquement une facture et des détails de paiement pour chaque achat, tirant une adresse d'un pool et calculant le montant dû.
Le client envoie le paiement ; la passerelle l'associe automatiquement à la facture.
La passerelle notifie votre backend via webhook une fois le paiement confirmé, afin que vous puissiez délivrer l'accès automatiquement.
Les fonds sont crédités sur votre solde marchand — soit dans la même crypto que le client a payée, soit automatiquement convertis en stablecoin ou en fiat, ce qui est utile si votre tarification est fixée en USD et que vous ne voulez pas d'exposition à la volatilité de la crypto.
À l'intérieur de Telegram, cela semble différent selon la manière dont vous intégrez :
Via API, vous construisez l'interface vous-même dans les messages de votre bot ou à l'intérieur des écrans de votre propre Mini App.
Via Checkout Hébergé, la Mini App ouvre un webview avec une page de paiement prête à l'emploi — aucun développement backend requis de votre part, et cela fonctionne de la même manière que vous construisiez un bot ou une Mini App complète.
Voici à quoi ressemble la page de paiement hébergée de Volet.com
Ici, les fonds ne passent jamais par la passerelle. Le client connecte son propre portefeuille directement à votre caisse et paie via un contrat intelligent directement à votre portefeuille. La passerelle prend une petite commission de traitement mais ne custodie jamais les fonds ; le règlement se fait entièrement à l'intérieur de la transaction elle-même.
Le flux utilisateur réel ressemble à ceci :
Le client appuie sur "Connecter le portefeuille".
Il est redirigé vers son application de portefeuille pour approuver la connexion — sur mobile, cela ouvre l'application de portefeuille elle-même ; sur desktop, une extension de navigateur ou un scan QR.
Il est renvoyé à votre caisse.
Il confirme les détails de la transaction.
Il est redirigé vers son portefeuille à nouveau pour signer le paiement.
Il est renvoyé à une page de confirmation, qui attend que la transaction se finalise sur la chaîne avant de marquer la commande comme complète.
Un autre détail technique : la notification API n'est pas partie du contrat intelligent. Le transfert blockchain lui-même est la seule chose qui se passe sur la chaîne — tout le reste (mise à jour du statut de la commande, accord d'accès, envoi d'une confirmation) est une logique backend séparée de votre côté, déclenchée par le webhook une fois que la passerelle détecte la transaction.
Ce flux exact — connecter le portefeuille, signer une transaction — est également ce que les escrocs imitent. Des clones frauduleux d'applications Mini populaires à gagner en tapant, y compris des imitations de Notcoin et Hamster Kombat, ont incité les utilisateurs à connecter leurs portefeuilles uniquement pour qu'un contrat intelligent malveillant draine instantanément et irréversiblement des fonds.
Cela ne rend pas la connexion du portefeuille dangereuse par conception, mais la légitimité doit être visiblement évidente : un domaine de paiement cohérent et vérifiable, une approbation de dépense fixe et détaillée plutôt qu'une approbation ouverte, et une règle stricte selon laquelle un véritable processus de paiement ne demande jamais une phrase de récupération ou un dépôt à l'avance — seulement une signature de l'application de portefeuille du client.
TON (Gram) en tant que blockchain native de Telegram
TON (The Open Network), récemment renommé à son nom original Gram, est le seul choix pour TON Connect dans le flux non-custodial ci-dessus. Ce n'est pas une recommandation — c'est une règle. Les propres Conditions de Service des Développeurs de Bot de Telegram exigent que toute Mini App touchant à la fonctionnalité de portefeuille se connecte exclusivement via TON Connect.
Pourquoi Telegram impose cela : TON est la propre blockchain de Telegram, et l'entreprise a une participation directe et croissante dans son succès. En mai 2026, Telegram a pris le contrôle direct de l'infrastructure de TON : l'entreprise a mis en jeu 2,2 millions de tokens pour devenir le plus grand validateur du réseau, remplaçant la Fondation TON en tant qu'opérateur principal.
L'acceptation custodiale via l'API de Volet.com ou le Checkout Hébergé ne rencontre pas du tout cela — il n'y a pas d'étape de connexion de portefeuille se produisant à l'intérieur de la Mini App elle-même, donc les actifs que vous pouvez accepter ne sont pas restreints de la même manière.
Aucune blockchain aujourd'hui ne prend en charge la facturation récurrente automatique comme le fait un réseau de cartes — les approximations les plus proches nécessitent soit de donner à un contrat intelligent une autorisation permanente pour retirer des fonds indéfiniment (un compromis de sécurité significatif que la plupart des entreprises ne devraient pas accepter) ou de construire quelque chose de si fragile qu'il ne vaut pas la peine d'être expédié.
La solution pratique est un solde rechargeable au lieu d'un abonnement :
L'utilisateur recharge un solde à l'intérieur de votre Mini App en utilisant de la crypto — via le même flux custodial ou non-custodial décrit ci-dessus.
Votre application déduit le coût de l'abonnement de ce solde selon un calendrier que vous contrôlez.
Vous pouvez même conserver et afficher ce solde en termes fiat (donc l'utilisateur voit "$9.99 restants" au lieu d'un montant crypto fluctuant) tout en acceptant la recharge elle-même en crypto.
Cela nécessite un peu plus de travail de développement à l'intérieur de votre Mini App, mais c'est la version qui est réellement expédiée aujourd'hui sans demander aux utilisateurs de donner une autorisation permanente à un contrat intelligent.
L'offre de Volet.com pour les paiements dans Telegram
L'acquisition de crypto via Volet.com ne nécessite aucun chiffre d'affaires minimum pour commencer, sans frais d'installation pour l'API ou le Checkout Hébergé, et sans coût d'abonnement mensuel.
Modèle
Frais du commerçant
Frais de retrait
Custodial (API ou Checkout Hébergé)
À partir de 0.25%
À partir de 0.5 $ fixe (plus si conversion — voir ci-dessous)
Non-custodial (contrat intelligent)
0.25%
Aucun — les fonds arrivent directement dans votre portefeuille
Le taux ci-dessus est le niveau de base pour accepter des paiements sans conversion. La conversion optionnelle au règlement est tarifée séparément — et le cas le plus courant, les stablecoins en USD, ne coûte rien de plus. Voici ce que coûte réellement la conversion au règlement :
Exemple : le rechargement unique de 9.99 $ du service VPN payé en USDT.
Custodial (API ou Checkout Hébergé) :
Le client vous envoie 9.99 USDT depuis son propre portefeuille.
Vous êtes crédité de 9.99 $ moins les frais d'acquisition de 0.25 % (environ 0.02 $), donc environ 9.97 $ arrive dans votre solde professionnel Volet.com.
Ce solde s'accumule avec chaque recharge de client, et ce qu'il en coûte pour le retirer dépend de ce que vous faites ensuite.
Option la moins chère : sauter le fiat et retirer, disons, 1 000 $ vers votre propre portefeuille crypto dans le même actif — juste les frais de réseau fixes (environ 0.5–3.5 selon le réseau), donc vous garderiez environ 996.50–999.50 $.
Si vous voulez du fiat, convertissez au moment où vous acceptez chaque paiement (règlement en USD au lieu de conserver USDT) plutôt que de convertir plus tard — cette conversion est gratuite, donc retirer le solde résultant de 1 000 $ USD vers votre banque ne coûte que les frais de retrait, à partir de 1 % selon la méthode, vous laissant avec environ 990 $.
Convertir un solde USDT déjà accumulé en USD après coup, à l'intérieur de votre compte, coûte 1 % en plus de cela — plus les mêmes frais de retrait — donc vous finiriez avec environ 980 $ à la place.
Non-custodial (contrat intelligent) :
Le client connecte son portefeuille et signe le même paiement de 9.99 USDT.
Le contrat intelligent achemine le paiement directement vers votre propre portefeuille, moins les mêmes frais de traitement de 0.25 % — vous recevez environ 9.97 $, déjà dans votre propre portefeuille.
Il n'y a pas d'étape de retrait séparée et pas de frais de retrait, car les fonds n'ont jamais été avec la passerelle pour commencer.
Élargissez cela à 1 000 $ de paiements clients au total utilisés dans l'exemple custodial ci-dessus, et la comparaison est simple : 997.50 $ arrive directement dans votre propre portefeuille.
Volet.com vous aide à construire vos paiements mondiaux
En monnaie fiduciaire, crypto et stablecoins. Via l'API, le paiement hébergé ou des plugins faciles à installer. Acceptez, envoyez et gérez des fonds — tout à partir du code.
Non. Le paiement hébergé ne nécessite aucun développement backend — la Mini App ouvre une vue web de paiement prête à l'emploi.
Mais une intégration API complète est également disponible si vous souhaitez plus de contrôle sur l'expérience de paiement.
Vous pouvez commencer en tant qu'individu.
L'acceptation des cryptomonnaies a une barrière à l'entrée nettement plus basse que les systèmes de paiement traditionnels aujourd'hui : aucune entité légale distincte, compte bancaire professionnel ou avocat dédié requis pour le connecter, et un développeur solo peut mettre en place une acceptation avec ou sans garde directement.
Oui, avec l'acceptation avec garde, les paiements en cryptomonnaies entrants peuvent être automatiquement convertis en USD ou EUR lors du règlement, de sorte que votre solde ne fluctue pas avec les prix des cryptomonnaies même si votre client a payé avec un actif volatil.
Les paiements sans garde se règlent directement dans la devise avec laquelle le client a payé, puisqu'il n'y a pas d'étape de conversion intermédiaire dans ce flux.
Les outils pour automatiser la comptabilité en cryptomonnaies et le reporting fiscal sont encore beaucoup moins matures que ce qui existe pour les revenus par carte ou bancaire — un véritable point de douleur si vous avez besoin de livres propres et prêts pour un audit.
Convertir les paiements entrants en stablecoin ou en fiat lors du règlement (disponible avec l'acceptation avec garde de Volet.com) élimine la complexité supplémentaire de suivre les mouvements de prix des cryptomonnaies en plus des transactions elles-mêmes.
