Comment accepter les paiements en Telegram Stars dans votre bot (Guide 2026)

Ce que sont les Telegram Stars

Les Telegram Stars sont la monnaie intégrée de Telegram. Les utilisateurs achètent des Stars par packs et les dépensent pour des choses numériques dans Telegram : contenu payant de bots et de mini-apps, cadeaux, réactions et publications payantes dans les chaînes, et ainsi de suite. Pour un propriétaire de bot, les Stars sont le moyen officiel de faire payer des biens et services numériques. L'API Bot de Telegram traite les Stars comme une devise portant le code XTR, et ses conditions exigent que tous les paiements de biens et services numériques dans les applications Telegram passent par les Stars, ce qui maintient les bots en conformité avec les règles de l'App Store et de Google Play.

L'endroit où un utilisateur achète ses Stars influe sur ce qu'il paie. Dans les applications iOS et Android, l'achat passe par Apple ou Google, et en septembre 2026 une Star y coûte environ deux cents américains. Acheter sur les applications web et de bureau de Telegram ou sur Fragment, la place de marché propre à Telegram, est nettement moins cher, car la commission de la boutique d'applications n'est pas incluse. Les prix varient selon la région, Telegram peut ajouter des taxes locales, et les packs changent : considérez donc ces chiffres comme des ordres de grandeur et vérifiez le prix actuel dans votre propre application.

De votre côté de la transaction, les conditions de Telegram pour les développeurs de bots précisent ce qu'une Star vaut pour vous : vous pouvez dépenser les Stars dans Telegram Ads au taux de 0,02 USD de crédit publicitaire par Star, ou demander une récompense, que Telegram traite via Fragment et verse en Toncoin à l'équivalent de 0,013 USD par Star. Les mêmes conditions indiquent que les Stars de votre solde peuvent mettre jusqu'à 21 jours après réception pour devenir disponibles. Cet écart entre ce que paie l'utilisateur et ce que vous recevez est le coût de l'ensemble du système : commission de la boutique d'applications, part de Telegram et versement en crypto. Cela reste moins cher et bien moins de travail que la plupart des prestataires de paiement par carte à petit volume, mais planifiez vos prix avec le chiffre de 0,013, pas avec le prix de vente au détail.

Ce que ressent l'utilisateur lors d'un paiement en Stars

C'est ce qui fait que les Stars fonctionnent pour les petits vendeurs. Il n'y a pas de page de paiement ni de saisie de carte. Tout le parcours se déroule dans la discussion :

1. L'utilisateur envoie une commande ou appuie sur un bouton, et votre bot répond par un court aperçu : ce qu'il va obtenir et le prix en Stars.
2. Il appuie sur Acheter. Telegram affiche un message de facture avec une fenêtre de confirmation native. Si son solde de Stars est insuffisant, Telegram lui propose de le recharger sur place.
3. Une pression pour confirmer. Telegram demande à votre bot d'approuver l'achat (c'est l'étape de pré-paiement, et le bot dispose de 10 secondes pour répondre), puis débite les Stars.
4. Votre bot reçoit une notification de paiement réussi et livre le contenu, ou indique à l'acheteur que vous allez le contacter.

Pour l'acheteur, c'est comme acheter un pack de stickers ou un cadeau Premium. Cette faible friction explique pourquoi les pourboires et les petits déblocages convertissent tellement mieux en Stars que via un lien externe vers un formulaire de carte.

Ce que vous pouvez vendre avec des Stars

Tout ce qui est numérique et qu'un bot peut remettre, ou que vous pouvez livrer en ligne. Les schémas qui reviennent le plus souvent :

• Commandes payantes et contenu verrouillé. Une commande qui ne répond en entier qu'après paiement : une check-list en PDF, un pack de modèles, un lien d'invitation privé, un enregistrement, une série d'images, un code de réduction. L'utilisateur voit un teaser, paie, et la réponse complète est livrée.
• Dons et pourboires. Une commande /donate avec quelques montants prédéfinis et une option de montant libre. Idéal pour les créateurs, les projets open source, les administrateurs de communautés et les podcasteurs qui veulent surtout dire "soutenez ce que je fais".
• Produits numériques. E-books, presets, packs de leçons, fiches d'exercices, mini-cours, fonds d'écran, audio. Si vous les vendez déjà ailleurs, une version en Stars dans Telegram est un second rayon presque sans configuration.
• Services fournis en ligne. Un créneau de consultation, une revue de portfolio, un plan de repas personnalisé. Le bot encaisse le paiement et vous livrez à la main.
• Abonnements. Telegram prend en charge les abonnements récurrents en Stars pour les bots et les chaînes, facturés périodiquement. TeleMinute vend actuellement des déblocages uniques et des dons plutôt que des abonnements récurrents ; si vous avez besoin d'adhésions à renouvellement automatique, il vous faudra du code sur mesure ou un autre outil pour cette partie.

Si vous animez une formation en ligne, notre guide des bots Telegram pour les cours en ligne explique comment structurer leçons et cohortes ; les Stars sont le moyen naturel de les faire payer. Pour une vue plus large des modèles de revenus des bots, consultez comment gagner de l'argent avec des bots Telegram.

Les règles : numérique uniquement, et les remboursements sont à votre charge

Deux règles comptent plus que toutes les autres. Premièrement, les Stars sont réservées aux biens et services numériques. Les conditions de Telegram relatives aux Stars les décrivent comme un moyen d'acheter des biens et services numériques auprès de bots et de mini-apps, et les conditions pour les développeurs exigent que les ventes numériques utilisent exclusivement les Stars. Un t-shirt, une livraison de repas ou un service en personne n'est pas un produit Stars. Pour les biens physiques, vous connectez toujours un prestataire de paiement classique via l'API Bot ou renvoyez vers votre propre page de paiement, et les fonctionnalités payantes de TeleMinute ne vous y aideront pas.

Deuxièmement, les remboursements relèvent de la responsabilité du vendeur. Telegram précise que les ventes de Stars aux utilisateurs sont définitives, mais un développeur est censé rembourser un acheteur qui n'a pas reçu ce qui était annoncé dans le délai convenu, et Telegram n'arbitre pas les litiges. L'API Bot dispose d'une méthode de remboursement dédiée aux paiements en Stars, donc un remboursement est une simple action plutôt qu'un ticket de support, mais veillez à ce que vos aperçus soient honnêtes sur ce que l'acheteur obtient et quand.

Quelques points plus mineurs à connaître : les Stars du solde d'un bot ne sont pas votre propriété au sens juridique, c'est un solde que vous pouvez convertir ; si le compte du propriétaire du bot est supprimé, le solde est perdu ; et Fragment peut être dans l'impossibilité de verser des récompenses aux utilisateurs de certains pays. Lisez une fois les conditions actuelles avant d'y bâtir une activité.

Conseils de tarification en Stars

• Utilisez des nombres ronds de Stars. 25, 50, 100, 250, 500. Les utilisateurs raisonnent en packs, et un prix comme 73 Stars ressemble à une conversion depuis une autre devise.
• Faites vos calculs avec 0,013, pas 0,02. Un produit à 100 Stars vous rapporte environ 1,30 USD en valeur de récompense, pas 2 USD. Tarifez votre travail en conséquence.
• Pensez à l'endroit où votre audience achète. Une audience surtout mobile paie le prix de la boutique d'applications ; une audience sur ordinateur peut acheter moins cher sur le web ou sur Fragment. Dire aux utilisateurs que les Stars sont moins chères sur le web est honnête et souvent apprécié.
• Respectez le pouvoir d'achat régional. Les Stars sont tarifées en dollars en coulisses. 500 Stars est un pourboire facile sur un marché et un achat sérieux sur un autre. Si votre audience est mondiale, gardez un palier bas (25 ou 50 Stars) à côté du prix principal.
• Proposez un palier pourboire même si vous vendez des produits. Certains utilisateurs n'achèteront pas de produit mais enverront volontiers 50 Stars après une réponse utile.
• Anticipez le délai de blocage. Avec jusqu'à 21 jours avant que les Stars deviennent disponibles, l'argent n'est pas du cash de la semaine. Traitez-le comme un versement mensuel.

Comment accepter des Stars avec TeleMinute, sans code

TeleMinute est un créateur de bots Telegram sans code : commandes, réponses par mots-clés, boutons, formulaires de prospects, diffusions, statistiques, un rapport quotidien et la publication automatique RSS, sur le web et dans des applications natives iOS et Android, avec une interface en 10 langues. Les paiements en Stars sont intégrés à l'éditeur et disponibles avec l'abonnement Premium ($3.99 par semaine, $9.99 par mois ou $49.99 à vie, avec des remises régionales appliquées automatiquement). Voici toute la configuration.

1. Connectez votre bot. Créez un compte TeleMinute et collez le token de BotFather (notre guide BotFather montre comment), ou commencez avec un bot de démonstration de 15 minutes issu du parc de TeleMinute et ajoutez votre propre token plus tard. Les paiements nécessitent un bot qui vous appartient, alors ajoutez votre token avant de passer en production.
2. Créez ce que vous vendez sous forme de commande. Dans l'éditeur de bot, ajoutez une commande comme /checklist et placez le livrable dans sa réponse : du texte, jusqu'à 4 images, et des boutons pouvant ouvrir une URL, par exemple un téléchargement ou un lien d'invitation privé.
3. Activez Contenu payant. Sur la même commande, activez Contenu payant. Définissez le Prix (Stars), n'importe quel nombre entier de 1 à 100 000. Rédigez un Texte d'aperçu, le teaser que les utilisateurs voient avant de payer ; laissez-le vide et TeleMinute affiche une note par défaut de contenu verrouillé. Choisissez la Livraison : Automatique envoie le contenu de la commande juste après le paiement et l'acheteur conserve l'accès, donc renvoyer la commande retourne le contenu sans second débit ; Manuelle signifie que vous contactez l'acheteur et livrez vous-même, ce qui convient aux consultations et au travail sur mesure.
4. Ajoutez des dons et une boutique dans l'onglet Paiements. Sous Dons, activez la fonctionnalité, conservez ou renommez la commande de don (/donate par défaut), saisissez jusqu'à trois montants prédéfinis comme 50, 100 et 250 Stars, décidez d'autoriser ou non un montant libre, et rédigez un message de remerciement. Sous Boutique, activez une commande de boutique (/store par défaut) qui liste toutes les commandes payantes dans un seul menu, pour que les utilisateurs puissent parcourir ce que vous vendez.
5. Enregistrez et testez avec votre propre compte. Ouvrez votre bot dans Telegram, envoyez la commande payante, et vérifiez l'aperçu et le bouton Acheter. Payez une fois avec vos propres Stars pour voir la facture et la livraison exactement comme un client. Vous pourrez vous rembourser ensuite.
6. Annoncez-le. Mentionnez la commande payante dans votre message /start, ajoutez un bouton qui l'exécute, et utilisez une diffusion pour prévenir les utilisateurs existants. Les réponses par mots-clés peuvent orienter ceux qui tapent "prix" ou "acheter" vers la commande de boutique.
7. Suivez les ventes. La page Ventes de chaque bot affiche le total gagné, le total remboursé et le nombre de ventes, plus une ligne par paiement avec l'acheteur, l'article, le montant, la date et le statut. Les achats en livraison manuelle sont marqués "Livraison en attente" jusqu'à ce que vous les traitiez. Chaque ligne propose Répondre, qui envoie un message à l'acheteur via votre bot, et Rembourser, qui restitue les Stars à l'acheteur. Le rapport quotidien peut inclure les ventes en Stars, pour recevoir un récapitulatif dans Telegram chaque matin.
8. Retirez. Les Stars vont directement sur le solde Telegram de votre bot, pas chez TeleMinute ; TeleMinute ne prélève aucune part sur vos ventes. Quand les Stars deviennent disponibles, utilisez-les pour Telegram Ads ou demandez une récompense via Fragment, en suivant les conditions actuelles de Telegram.

En coulisses, TeleMinute envoie la facture en XTR, répond à la requête de pré-paiement, vérifie le montant, enregistre le paiement pour qu'une notification en double ne puisse pas livrer deux fois, et se souvient de qui a déjà débloqué quoi. Vous n'avez jamais à y toucher.

Questions fréquentes

Combien vaut une Telegram Star ?

Cela dépend du côté du paiement où vous vous trouvez. Les utilisateurs achètent des Stars par packs et, en septembre 2026, une Star coûte environ deux cents américains dans les applications iOS et Android, moins si elle est achetée via Telegram sur le web ou sur Fragment, car il n'y a pas de commission de boutique d'applications. Côté propriétaire du bot, les conditions de Telegram pour les développeurs de bots fixent la récompense à l'équivalent de 0,013 USD par Star, ou 0,02 USD de crédit publicitaire si vous dépensez les Stars dans Telegram Ads. Les prix varient selon la région et évoluent avec le temps, alors consultez les conditions actuelles de Telegram.

Puis-je vendre des produits physiques avec des Telegram Stars ?

Non. Les conditions de Telegram réservent les Stars aux biens et services numériques : contenu, accès, téléchargements, consultations, adhésions, avantages dans le bot. Les biens physiques et les services fournis hors ligne doivent être vendus via un prestataire de paiement classique connecté à l'API Bot de Telegram, ou via un lien vers votre propre page de paiement. Les commandes payantes, les dons et la boutique de TeleMinute fonctionnent uniquement avec des Stars, donc uniquement pour le numérique.

Comment retirer les Stars gagnées par mon bot ?

Les Stars payées à votre bot arrivent sur le solde de Stars du bot lui-même sur Telegram, pas dans TeleMinute. Les conditions de Telegram pour les développeurs indiquent que les Stars peuvent mettre jusqu'à 21 jours après réception pour devenir disponibles ; ensuite vous pouvez soit les dépenser dans Telegram Ads, soit demander une récompense via Fragment, qui verse des Toncoins à l'équivalent de 0,013 USD par Star. Fragment peut être indisponible dans certains pays et un montant minimum peut s'appliquer, alors consultez les conditions actuelles de Telegram avant de compter dessus.

Dois-je écrire du code pour accepter des Stars avec TeleMinute ?

Non. Dans l'éditeur TeleMinute, vous activez Contenu payant sur n'importe quelle commande, saisissez un prix en Stars, ajoutez éventuellement un texte d'aperçu et choisissez la livraison automatique ou manuelle. L'onglet Paiements ajoute une commande de don avec des montants prédéfinis et une commande de boutique qui liste toutes les commandes payantes. Les factures, la confirmation avant paiement, la livraison, une page Ventes avec remboursements et réponses aux acheteurs sont entièrement gérés pour vous. Les fonctionnalités payantes nécessitent un abonnement Premium.