Tutoriel : intégrer l'API Flooz et T-Money sur votre site web

Au Togo, encaisser un paiement en ligne ne passe presque jamais par une carte bancaire. La quasi-totalité de vos clients paie avec leur téléphone, via Flooz (Moov Africa) ou T-Money (Togocel). Si votre site web oblige encore vos clients à vous appeler, à vous envoyer un message WhatsApp pour confirmer un transfert, ou à venir payer en personne, vous perdez chaque jour des ventes. L'intégration d'une API Flooz et T-Money transforme votre site en véritable caisse enregistreuse automatique, ouverte 24h/24. Dans ce tutoriel complet, l'équipe de TPG TECHNOLOGIES vous explique, étape par étape, comment fonctionne cette intégration, combien elle coûte réellement en FCFA, et comment éviter les pièges les plus courants.

Pourquoi intégrer le Mobile Money sur votre site est devenu indispensable au Togo

Le commerce en ligne togolais est profondément différent du modèle occidental. Ici, le portefeuille mobile a remplacé la carte de crédit. D'après notre expérience auprès des commerçants et entreprises de Lomé, Kara ou Sokodé, la grande majorité des acheteurs finalisent leur transaction depuis un smartphone, et leur réflexe naturel est de payer avec Flooz ou T-Money. Imposer un autre moyen de paiement, c'est volontairement réduire votre marché. Cette réalité explique pourquoi un projet de site e-commerce avec paiement Mobile Money à Lomé ne ressemble en rien à un site pensé pour l'Europe.

Voici concrètement ce que l'intégration automatique vous apporte :

• Encaissement instantané et automatique : le client paie, votre système confirme la transaction en quelques secondes, sans aucune intervention manuelle de votre part.
• Disponibilité permanente : votre boutique encaisse même la nuit, le week-end et les jours fériés, sans que vous soyez devant votre téléphone.
• Réduction des litiges : fini les fausses captures d'écran de paiement. La confirmation vient directement de l'opérateur, pas du client.
• Confiance accrue : un site qui affiche un vrai bouton de paiement Flooz et T-Money inspire bien plus de sérieux qu'un simple numéro à appeler.

Que vous vendiez des vêtements, des formations en ligne, des billets d'événements ou des services, le paiement automatique change l'échelle de ce que vous pouvez gérer. C'est d'ailleurs l'un des leviers décisifs pour réussir : beaucoup d'entrepreneurs sous-estiment ce point, comme le montrent les erreurs fréquentes au lancement d'un e-commerce au Togo.

Comprendre les deux approches d'intégration

Avant de plonger dans la technique, il faut comprendre qu'il existe deux grandes façons de connecter le Mobile Money à votre site. Le choix dépend de votre volume de transactions, de vos compétences techniques et de votre budget.

1. Passer par un agrégateur de paiement (recommandé pour la plupart des PME)

Un agrégateur est une plateforme intermédiaire qui regroupe Flooz, T-Money, Wave et parfois les cartes bancaires derrière une seule et même API. Au lieu de négocier séparément avec Moov Africa et Togocel, vous signez un seul contrat. Des acteurs comme PayGate Global, CinetPay, Semoa ou PayDunya sont bien implantés en Afrique de l'Ouest et couvrent le Togo.

Les avantages : mise en place rapide, une seule documentation à maîtriser, et une réconciliation des paiements simplifiée. C'est l'option que TPG TECHNOLOGIES recommande dans la grande majorité des projets, car elle offre le meilleur rapport rapidité/fiabilité. Pour un commerçant qui débute, c'est aussi le moyen le plus sûr d'éviter les blocages techniques tout en gardant un parcours de paiement fluide.

2. L'intégration directe avec les opérateurs

Il est possible de contractualiser directement avec Moov Africa pour Flooz et avec Togocel pour T-Money. Cette voie réduit les commissions à long terme et peut convenir aux entreprises à très fort volume. Mais elle demande des démarches administratives plus longues, des validations KYC poussées, et un développement technique plus exigeant car chaque opérateur a sa propre logique d'API. Pour un commerçant ou une PME qui démarre, c'est rarement le bon premier choix. Mieux vaut commencer avec un agrégateur, valider votre modèle, puis migrer vers le direct seulement lorsque votre volume le justifie réellement.

Les prérequis avant de commencer

Quelle que soit l'approche, vous aurez besoin de réunir un certain nombre d'éléments. Préparez-les en amont pour accélérer la mise en service.

• Une entreprise enregistrée : carte d'opérateur économique, numéro d'identification fiscale (NIF) et registre de commerce. Les agrégateurs exigent ces documents pour vous verser l'argent.
• Un compte marchand ou un numéro Mobile Money professionnel sur lequel vos encaissements seront reversés.
• Un site web fonctionnel avec un certificat de sécurité HTTPS actif. Aucun paiement sérieux ne transite sur un site non sécurisé.
• Une adresse e-mail professionnelle et un compte sur la plateforme de l'agrégateur choisi.
• Des coordonnées bancaires ou un compte de versement pour récupérer vos fonds collectés.

Un conseil issu de notre pratique : préparez des documents scannés nets et lisibles. La majorité des retards de validation de compte marchand vient de pièces justificatives floues ou expirées. Si votre site n'existe pas encore ou doit être refondu pour accueillir un tunnel d'achat, anticipez ce chantier en parallèle ; nos services de création de site web couvrent justement cette phase de préparation technique.

Tutoriel : les étapes concrètes de l'intégration

Voici le déroulé complet d'une intégration via agrégateur, qui est le scénario le plus fréquent. Chaque étape est expliquée pour que vous compreniez ce qui se passe, même si vous confiez la partie technique à un développeur.

1. Créer et faire valider votre compte marchand. Vous vous inscrivez sur la plateforme de l'agrégateur, vous soumettez vos documents d'entreprise, puis vous attendez la validation. Comptez en général de quelques jours à deux semaines selon la réactivité du fournisseur.
2. Récupérer vos clés API. Une fois le compte validé, la plateforme vous fournit des identifiants techniques : une clé publique (API Key) et une clé secrète. Ces clés sont la signature numérique de votre boutique. Elles ne doivent jamais être visibles dans le code public de votre site.
3. Configurer l'environnement de test. Tous les bons agrégateurs offrent un mode bac à sable (sandbox) avec de l'argent fictif. C'est là que votre développeur teste tout le parcours avant de toucher au moindre franc réel.
4. Intégrer le bouton de paiement. Sur la page de validation de commande, le client choisit Flooz, T-Money ou Wave. Votre site envoie alors une demande à l'API avec le montant et la référence de commande.
5. Déclencher la demande de paiement. Le client reçoit une notification USSD sur son téléphone, saisit son code secret Mobile Money, et confirme. L'opérateur débite son compte.
6. Gérer la confirmation via le webhook. C'est l'étape la plus importante. L'agrégateur envoie automatiquement un message (le webhook) à votre site pour confirmer si le paiement a réussi ou échoué. C'est cette confirmation, et elle seule, qui doit valider la commande dans votre système.
7. Passer en production. Après des tests concluants en sandbox, vous basculez sur les clés réelles et effectuez une première transaction de faible montant en conditions réelles pour tout vérifier.

Le point critique : ne jamais valider une commande sans le webhook

L'erreur la plus dangereuse, que nous corrigeons régulièrement sur des sites mal conçus, consiste à considérer une commande comme payée simplement parce que le client a cliqué sur « payer ». Un clic n'est pas un paiement. Seule la notification serveur de l'opérateur, vérifiée côté serveur, prouve que l'argent est bien arrivé. Un site bâclé sur ce point ouvre la porte à des fraudes et à des commandes fantômes. Ce genre de faille fait partie des risques que nous abordons dans notre guide sur la sécurité d'un site web face au piratage au Togo.

Combien coûte réellement une intégration Flooz et T-Money au Togo

La question du budget revient systématiquement. Il faut distinguer deux types de coûts : le coût de mise en place (one-shot) et les commissions permanentes prélevées sur chaque transaction.

Le coût de développement et d'intégration

Pour faire intégrer proprement le Mobile Money sur un site existant par une agence sérieuse, comptez en général :

• Entre 150 000 et 400 000 FCFA pour ajouter le paiement automatique à un site web déjà en place, selon la complexité du parcours de commande.
• Entre 400 000 et 1 200 000 FCFA pour un site e-commerce complet créé de zéro, paiement Mobile Money inclus, avec gestion des produits, des commandes et du tableau de bord.

Ces fourchettes varient selon vos besoins réels. Un site qui gère des abonnements récurrents ou des paiements échelonnés demandera plus de travail qu'une simple boutique de produits unitaires. Pour vous faire une idée plus précise, vous pouvez parcourir nos réalisations récentes et voir le type de plateformes que nous livrons.

Les commissions par transaction

Les agrégateurs et opérateurs prélèvent un pourcentage sur chaque encaissement. Dans la pratique au Togo et en Afrique de l'Ouest, ces frais se situent en général entre 1,5 % et 4 % par transaction selon le fournisseur, le volume et le moyen de paiement. À cela peuvent s'ajouter de petits frais fixes par opération. Avant de signer, demandez toujours la grille tarifaire complète et calculez l'impact sur votre marge, surtout si vous vendez des produits à faible prix.

Bien choisir entre Flooz, T-Money et Wave

La meilleure stratégie consiste rarement à se limiter à un seul moyen de paiement. Vos clients sont répartis entre les opérateurs, et chacun a ses préférences.

• Flooz (Moov Africa) : très répandu, particulièrement apprécié pour les paiements quotidiens. À proposer en priorité.
• T-Money (Togocel) : Togocel disposant d'un large parc d'abonnés, ignorer T-Money revient à se priver d'une part importante de la clientèle.
• Wave : en forte progression dans la région, souvent apprécié pour ses frais réduits côté utilisateur. De plus en plus attendu par les clients togolais.

Notre recommandation : activez au minimum Flooz et T-Money dès le départ, et ajoutez Wave si votre clientèle le demande. Plus vous offrez de choix, moins vous perdez de ventes au moment fatidique du paiement.

Cas d'usage concrets : qui a besoin de cette intégration ?

Le paiement automatique n'est pas réservé aux grandes boutiques en ligne. Au quotidien, nous l'implémentons pour des profils très variés, chacun avec ses contraintes propres :

• Les boutiques de produits physiques (mode, cosmétiques, électronique) qui veulent encaisser avant la livraison et éviter les commandes non honorées.
• Les formateurs et écoles en ligne qui vendent des cours à l'unité ou par abonnement, souvent via une plateforme e-learning au Togo où chaque accès doit être débloqué automatiquement après paiement.
• Les organisateurs d'événements qui vendent des billets et ont besoin d'une confirmation immédiate pour générer un ticket valide.
• Les prestataires de services qui encaissent des acomptes ou facturent en ligne, parfois couplés à un système d'automatisation des rendez-vous en ligne pour réserver et payer en une seule étape.

Dans chacun de ces cas, la logique reste la même : seule la confirmation de l'opérateur déclenche l'action (livraison, accès, billet, réservation). C'est cette automatisation de bout en bout qui fait gagner un temps considérable et limite les erreurs humaines.

Sécurité et bonnes pratiques à ne pas négliger

Manipuler de l'argent en ligne impose une rigueur particulière. Voici les règles que TPG TECHNOLOGIES applique systématiquement sur chaque projet de paiement.

• Protégez vos clés secrètes. Elles doivent rester côté serveur, jamais dans le code visible du navigateur. Une clé exposée peut être détournée.
• Vérifiez la signature des webhooks. Assurez-vous que la confirmation de paiement provient bien de l'agrégateur et non d'un fraudeur qui imiterait son message.
• Activez le HTTPS partout. Toutes les pages, et pas seulement celle de paiement, doivent être chiffrées.
• Conservez un journal des transactions. Chaque paiement, réussi ou échoué, doit être enregistré pour faciliter la réconciliation comptable et le service client.
• Prévoyez les cas d'échec. Réseau coupé, solde insuffisant, client qui annule : votre site doit gérer ces situations avec un message clair, et ne jamais débiter deux fois.

Un parcours de paiement bien conçu rassure le client à chaque étape. Un client qui doute au moment de saisir son code Mobile Money est un client qui abandonne son panier. La fluidité sur mobile est ici déterminante, et c'est pourquoi nos projets de développement mobile et nos sites partagent les mêmes exigences d'ergonomie et de rapidité.

Les erreurs fréquentes que nous voyons sur le terrain

Au fil des projets, certains pièges reviennent souvent chez les commerçants qui ont tenté l'intégration seuls ou avec un prestataire peu expérimenté :

• Considérer une commande comme payée avant la confirmation de l'opérateur.
• Oublier de configurer le webhook, ce qui laisse les commandes bloquées « en attente » indéfiniment.
• Tester directement en production avec de vrais paiements au lieu d'utiliser le mode sandbox.
• Ne proposer qu'un seul opérateur et perdre la moitié des clients.
• Négliger l'expérience mobile, alors que la quasi-totalité des paiements se fait sur smartphone.

Chacune de ces erreurs a un coût direct : des ventes perdues, des clients mécontents, ou pire, des écarts de caisse difficiles à expliquer. Beaucoup de ces problèmes ne sont pas seulement techniques : ils traduisent un manque de méthode au lancement, un sujet que nous détaillons dans notre guide sur les niches e-commerce rentables au Togo où le choix du modèle conditionne aussi la stratégie d'encaissement.

Conclusion : confiez votre intégration à des experts du paiement togolais

Intégrer l'API Flooz et T-Money sur votre site n'est pas qu'une formalité technique : c'est une décision stratégique qui détermine combien de ventes vous réussissez réellement à encaisser. Bien fait, le paiement automatique vous fait gagner du temps, sécurise vos recettes et renforce la confiance de vos clients. Mal fait, il devient une source de litiges et de pertes. Entre le choix du bon agrégateur, la configuration des webhooks, la gestion des cas d'échec et la sécurisation des clés, mieux vaut s'appuyer sur une équipe qui maîtrise les spécificités du marché togolais.

Chez TPG TECHNOLOGIES, agence web et mobile basée à Lomé, nous intégrons Flooz, T-Money et Wave sur des sites e-commerce et des plateformes de services pour des entrepreneurs partout au Togo et en Afrique de l'Ouest. Nous vous accompagnons de la création du compte marchand jusqu'à la première vente réelle, en passant par tous les tests nécessaires. Discutons de votre projet et obtenez un devis gratuit dès aujourd'hui : contactez-nous ou écrivez-nous directement sur WhatsApp au +228 96 87 03 60. Transformons votre site en une véritable caisse automatique qui encaisse pendant que vous dormez.