Le verdict en trois phrases
Au Togo, encaisser sur deux opérateurs (Moov Money et T-Money) multiplie les sources de callback et donc les écarts de caisse si la réconciliation n'est pas centralisée. Chaque opérateur a son propre format de webhook et sa fenêtre de retry — jusqu'à 24 h chez T-Money — ce qui laisse environ 2 % de transactions en statut ambigu. Un rapprochement quotidien par requête de statut ramène l'écart sous 0,2 % : normalisez les webhooks, réconciliez chaque nuit, alertez au-delà de 0,5 %.
D'où viennent les écarts
Le problème n'est pas le taux de frais mais la fiabilité du signal de confirmation. Un webhook peut arriver en double, en retard, ou jamais. Voici les causes typiques et leur ordre de grandeur 2026.
| Cause d'écart | Fréquence estimée | Impact caisse |
|---|---|---|
| Webhook jamais reçu | ~ 1 % | transaction payée non enregistrée |
| Webhook en double | ~ 0,5 % | risque de double comptage |
| Retry tardif (jusqu'à 24 h) | ~ 0,5 % | statut ambigu temporaire |
| Format divergent Moov vs T-Money | permanent | erreurs de parsing |
| Timeout côté client | variable | commande orpheline |
Cumulés, ces aléas produisent environ 2 % de transactions au statut incertain — assez pour fausser une caisse quotidienne si rien n'est rapproché.
La méthode de réconciliation
La parade tient en trois principes : un modèle de transaction unique, un pull de statut nocturne, et un seuil d'alerte. Voici l'effet attendu.
| Pratique | Écart de caisse avant | Écart après |
|---|---|---|
| Webhooks bruts, pas de rapprochement | ~ 2 % | — |
| Normalisation format unique | ~ 1,2 % | — |
| Pull de statut quotidien | — | ~ 0,3 % |
| Pull + idempotence anti-doublon | — | ~ 0,2 % |
| Alerte automatique > 0,5 % | — | détection immédiate |
Le pull de statut nocturne est la pièce maîtresse : il rattrape les webhooks perdus et tranche les statuts ambigus en interrogeant directement l'opérateur.
Mini cas pratique
Kodjo gère une boutique en ligne à Lomé qui encaisse sur Moov Money et T-Money, environ 900 transactions par mois. Avant réconciliation, il constatait un écart de caisse mensuel d'environ 2 %, soit près de 18 transactions litigieuses — remboursements réclamés, commandes payées mais non honorées. En mettant en place la normalisation des webhooks, un pull de statut chaque nuit et une clé d'idempotence anti-doublon, son écart tombe à 0,2 %, soit moins de 2 transactions ambiguës par mois. Il économise plusieurs heures de rapprochement manuel et évite les litiges clients.
Besoin d'un site web professionnel ?
Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.
FAQ
Pourquoi ne pas se fier uniquement aux webhooks ?
Parce qu'un webhook peut se perdre, arriver en double ou avec 24 h de retard chez T-Money. Le webhook est un signal rapide mais non fiable à 100 % : il faut le confirmer par une requête de statut avant de considérer une transaction close.
Qu'est-ce qu'un pull de statut ?
C'est une interrogation programmée où votre système redemande à l'opérateur l'état réel de chaque transaction en attente. Fait chaque nuit, il rattrape les webhooks manquants et tranche les cas ambigus sans intervention humaine.
Comment éviter le double comptage ?
En attribuant une clé d'idempotence unique par transaction : si deux webhooks portent la même clé, seul le premier est traité. Cela neutralise les doublons, une des causes fréquentes d'écart positif de caisse.
Quel seuil d'alerte fixer ?
Un ordre de grandeur raisonnable est 0,5 % d'écart quotidien : en dessous, c'est du bruit normal ; au-dessus, une alerte automatique doit prévenir votre équipe pour investigation le jour même.
Faut-il un modèle de données commun aux deux opérateurs ?
Oui : normaliser Moov et T-Money dans un format unique (montant, référence, statut, horodatage) simplifie tout le reste — parsing, réconciliation, reporting — et supprime les erreurs liées aux formats divergents.
Discutons de votre projet. Nous centralisons Moov Money et T-Money dans une réconciliation unique avec pull de statut nocturne et alertes d'écart. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.
