Les paiements Telegram permettent à un acheteur de payer un bot ou une Mini App sans quitter la conversation. Le bot envoie une facture, Telegram ouvre sa propre feuille de paiement, et l'argent parvient au vendeur via un prestataire de paiement (pour les biens physiques) ou sous forme de Telegram Stars (pour les biens numériques). Ce guide explique comment fonctionne le paiement Telegram, quelle option convient à ce que vous vendez, ce que coûte chacune et comment commencer à accepter des paiements étape par étape, avec ou sans code.
Vous cherchez la liste complète des moyens de paiement qu'une boutique peut connecter, y compris TON et les portefeuilles d'Asie du Sud-Est ? Elle se trouve dans Moyens de paiement Telegram. Cette page explique comment fonctionnent les paiements dans Telegram et comment les activer.
Comment fonctionnent les paiements Telegram#
L'API Bot Payments de Telegram est une plateforme ouverte et gratuite. Elle comporte deux voies :
- Les biens physiques et les services sont payés via des prestataires tiers. Telegram travaille avec plus de 20 d'entre eux, et les acheteurs peuvent payer depuis plus de 200 pays. Telegram ne prélève aucune commission sur ces paiements et ne conserve pas les données de carte ; c'est le prestataire qui gère la carte. Telegram prend en charge Apple Pay et Google Pay sur la feuille de paiement.
- Les biens et services numériques doivent être payés en Telegram Stars, code de devise
XTR. Telegram indique qu'il ne peut pas afficher votre bot ou votre Mini App aux utilisateurs mobiles si vous vendez des biens numériques dans d'autres devises ou via des prestataires tiers.
Un paiement suit toujours le même parcours :
- Facture. Le bot envoie une facture avec les articles et le total (
sendInvoice), ou une Mini App en ouvre une à partir d'un lien. - Livraison (facultatif). Si le coût de livraison dépend de l'adresse, Telegram demande d'abord au bot les options de livraison.
- Vérification avant paiement. Avant de débiter, Telegram demande au bot de confirmer la commande. Le bot dispose de 10 secondes pour répondre, sinon le paiement est annulé.
- Paiement. L'acheteur confirme sur la feuille : carte, Apple Pay, Google Pay ou Stars.
- Confirmation. Le bot reçoit un message
successful_paymentet livre la commande.
Quelle option convient à ce que vous vendez#
| Option | L'acheteur paie avec | Pour | Ce que prend Telegram | Configuration |
|---|---|---|---|---|
| Telegram Stars | Son solde de Stars | Biens numériques : fichiers, accès, abonnements | Le vendeur reçoit environ 0,013 $ par Star | Rien à connecter |
| Prestataire de carte via @BotFather (Stripe, Freedom Pay et autres) | Carte, Apple Pay, Google Pay sur la feuille de Telegram | Biens physiques et services hors ligne | Rien ; le prestataire facture ses propres frais | Un jeton de prestataire |
| Stripe Connect (Tiny Shops) | Carte sur la page de paiement sécurisée de Stripe | Biens physiques dans les pays couverts par Stripe | Rien ; les frais de Stripe s'appliquent | Inscription Stripe depuis le tableau de bord |
| TON | N'importe quel portefeuille TON | Acheteurs à l'aise avec la crypto, ventes internationales | Rien | Une adresse de portefeuille |
| Commande manuelle | Ce que vous convenez : espèces, virement | Livraison locale, paiement à la livraison | Rien | Rien |
Les frais des prestataires varient selon le pays et le contrat. Stripe publie ses tarifs sur stripe.com/pricing ; des prestataires comme Freedom Pay les fixent dans votre contrat. Vérifiez auprès de votre prestataire, et non dans un tableau de blog, le chiffre qui s'applique à vous.
Telegram Stars en bref#
Les acheteurs obtiennent des Stars via les achats intégrés d'Apple ou de Google ou via @PremiumBot, puis les dépensent dans les bots et les Mini Apps. Côté vendeur, les conditions pour les développeurs de bots de Telegram en fixent la valeur :
- Environ 0,013 $ par Star sous forme de récompense, versée via Fragment.
- 0,02 $ par Star si vous dépensez plutôt le solde en Telegram Ads.
- Jusqu'à 21 jours avant que les Stars reçues soient disponibles pour les récompenses ou la publicité.
Les Stars ne s'utilisent qu'en nombres entiers, les pourboires ne sont pas disponibles, et Telegram ne transmet ni le nom, ni le téléphone, ni l'adresse de l'acheteur avec un paiement en Stars. Les remboursements passent par la Bot API (refundStarPayment), et un bot qui vend contre des Stars doit répondre à la commande /paysupport. La comparaison complète avec les cartes, avec un tableau de conversion Stars-USD, se trouve dans Telegram Stars vs Stripe.
Comment accepter des paiements sur Telegram (la méthode générale)#
Si vous développez le bot vous-même, voici les étapes tirées de la documentation de Telegram :
- Créez un bot avec @BotFather. Notre guide sur les bots vous accompagne pas à pas.
- Obtenez un jeton de prestataire. Dans @BotFather :
/mybots→ votre bot → Bot Settings → Payments. Choisissez un prestataire, terminez l'inscription et copiez le jeton. Commencez par le jeton de test. Pour les Stars, sautez cette étape : le jeton est une chaîne vide. - Envoyez des factures depuis votre code avec
sendInvoiceoucreateInvoiceLink, dans une devise prise en charge par votre prestataire. - Répondez à la requête de pré-paiement (pre-checkout query) dans les 10 secondes, ainsi qu'à la requête de livraison si vous utilisez la livraison flexible.
- Traitez
successful_payment: marquez la commande comme payée et envoyez la marchandise. - Suivez la checklist de mise en production de Telegram : validation en deux étapes sur le compte propriétaire du bot, une commande
/termsque les acheteurs acceptent, une commande/support, et la capacité de gérer vous-même les litiges et les rétrofacturations. Remplacez ensuite le jeton de test par le jeton de production (il contient:LIVE:au milieu).
Un créateur de boutique se charge des étapes 3 à 5 à votre place, en plus du catalogue, du panier et des alertes de commande.
Comment accepter les paiements Telegram dans Tiny Shops#
Tiny Shops est un créateur de boutique Telegram Mini App sans code. Votre boutique s'ouvre dans votre propre bot, et le paiement se termine sur la feuille de paiement de Telegram.
Cartes via un prestataire Telegram#
- Obtenez un jeton de test dans @BotFather →
/mybots→ le bot de votre boutique → Bot Settings → Payments. Guides pas à pas pour deux prestataires : Stripe et Freedom Pay. - Ouvrez Storefront Settings → Orders & Payments. Sous Checkout Mode, choisissez Telegram Payments.
- Cliquez sur Add Provider. Renseignez Provider Name (n'importe quel libellé, par exemple « Stripe »), collez le jeton dans Provider Token, laissez Test Mode et Active activés, puis cliquez sur Save Provider.
- Vérifiez la devise de la boutique sous Store Currency. Elle doit être prise en charge par votre prestataire. Si un paiement échoue avec
PAYMENT_PROVIDER_INVALID, la devise en est généralement la cause. - Ouvrez Checkout → Payment methods et vérifiez que Telegram Invoice figure dans la liste. Sinon, cliquez sur Add method et ajoutez-le. Il affiche Connected dès qu'un prestataire actif existe.
- Choisissez les champs de la facture. Dans Invoice Field Configuration, activez Request Name, Request Phone Number, Request Email ou Request Shipping Address selon vos besoins. Flexible Shipping Pricing permet de faire dépendre le prix de livraison de l'adresse. Enable Tips ajoute jusqu'à 4 montants de pourboire suggérés et un Maximum Tip Amount.
- Passez une commande test depuis votre téléphone. Avec un jeton de test Stripe, utilisez la carte de test de Telegram
4242 4242 4242 4242, n'importe quelle date future et n'importe quel CVC. - Passez en production. Récupérez le jeton de production dans @BotFather, cliquez sur Edit Provider, collez-le, désactivez Test Mode et enregistrez.
Telegram Stars#
- Dans Storefront Settings → Orders & Payments, choisissez Telegram Payments, puis réglez Store Currency sur Telegram Stars (XTR). La page affiche Telegram Stars Enabled : aucun jeton ni réglage n'est nécessaire.
- Dans Checkout → Payment methods, ajoutez Telegram Stars.
- Fixez le prix de vos produits en Stars entières.
Une boutique n'a qu'une seule devise : elle accepte donc soit les Stars, soit un prestataire de carte. Si vous vendez à la fois des colis et des biens numériques, gérez-les comme deux boutiques sur un seul compte.
Autres options#
Stripe Connect (cartes sur la page de paiement de Stripe, versements sur votre propre compte Stripe), TON, Xendit pour l'Indonésie, les Philippines et la Malaisie, ainsi que la commande manuelle se configurent tous depuis Checkout → Payment methods. Les étapes pour chacun figurent dans Moyens de paiement Telegram.
Apple Pay et Google Pay sur Telegram#
Vous n'activez pas les portefeuilles séparément. La feuille de paiement de Telegram prend en charge Apple Pay et Google Pay, et ils apparaissent lorsque votre prestataire et l'appareil de l'acheteur les prennent en charge. Si un acheteur ne voit pas Apple Pay, vérifiez si votre prestataire le propose dans votre pays. Les paiements en Stars n'utilisent aucun portefeuille : l'acheteur paie avec son solde de Stars.
Combien ça coûte#
Telegram ne prélève rien sur les paiements via un prestataire ; votre prestataire facture ses propres frais. Tiny Shops coûte 0 $ avec Free, 9,99 $ avec Starter, 29 $ avec Pro et 79 $ avec Scale par mois, et chaque commande paie le pourcentage de son total prévu par l'offre : 5 %, 3 %, 1,5 % ou 0,7 %. Chaque compte bénéficie de ses 50 premières commandes gratuites, une seule fois, et non chaque mois. Les ventes en Stars paient le pourcentage dès la première vente. Pro paie au maximum 149 $ par mois en pourcentage, Scale au maximum 79 $. Détails sur la page tarifs.
Dépannage#
| Symptôme | Cause probable | Solution |
|---|---|---|
Le paiement échoue avec PAYMENT_PROVIDER_INVALID | Le prestataire ne prend pas en charge la devise de votre boutique | Changez Store Currency ou demandez au prestataire quelles devises il accepte |
| Telegram Invoice affiche Not connected | Aucun prestataire actif | Ajoutez-en un dans Orders & Payments et laissez Active activé |
| Les Stars ne sont pas proposées au paiement | La devise de la boutique n'est pas XTR | Réglez Store Currency sur Telegram Stars (XTR) |
| Les paiements test fonctionnent, pas les vrais | Toujours sur le jeton de test | Collez le jeton de production et désactivez Test Mode |
| Aucune alerte de commande | Aucune destination d'alerte | Configurez-la sous Order Notifications et appuyez sur Send test order alert |
FAQ#
Comment fonctionnent les paiements Telegram ? Le bot envoie une facture, Telegram affiche une feuille de paiement native, l'acheteur paie par carte, portefeuille ou Stars, puis le bot reçoit une confirmation et livre la commande. Les cartes passent par un prestataire tiers ; les Stars restent dans Telegram.
Telegram prélève-t-il des frais sur les paiements ? Pas sur les paiements via des prestataires tiers ; le prestataire facture ses propres frais. Avec les Stars, le vendeur reçoit environ 0,013 $ par Star sous forme de récompense, selon les conditions pour les développeurs de Telegram.
Puis-je accepter Apple Pay dans Telegram ? Oui, si votre prestataire le prend en charge. Apple Pay et Google Pay apparaissent sur la feuille de paiement de Telegram sans configuration supplémentaire dans la boutique.
Puis-je vendre des produits numériques par carte dans Telegram ? Pas dans le bot ni dans la Mini App. Telegram impose les Stars pour les biens et services numériques, et peut masquer aux utilisateurs mobiles un bot qui les vend dans d'autres devises.
Ai-je besoin d'un développeur ? Pas avec un créateur de boutique. Dans Tiny Shops, la configuration se résume à un jeton de @BotFather et à quelques réglages dans le tableau de bord.
Ouvrez votre boutique et encaissez votre premier paiement Telegram sur tiny-shops.com →
