Reconciliation des paiements mobile money par webhook en Afrique francophone 2026

Le verdict en trois phrases

Sans reconciliation, 2 a 5 % des commandes restent en attente faute de webhook recu sur reseau instable, ce qui brouille votre comptabilite et frustre vos clients. La solution : un journal des transactions avec statut, montant et reference operateur, double d'un cron de rattrapage qui interroge l'API toutes les 15 minutes. Ce guide detaille l'architecture d'un rapprochement fiable pour Wave, Orange Money et MTN MoMo, avec un comparatif des identifiants de transaction.

Pourquoi la reconciliation est indispensable

Un webhook n'est jamais garanti a 100 %. Sur la 3G d'Afrique de l'Ouest et Centrale, une notification peut se perdre, arriver en double ou en retard. Si vous vous fiez au seul webhook, une fraction de vos commandes payees restera bloquee en "en attente" alors que le client a bel et bien debite son compte. La reconciliation croise trois sources : votre journal interne, le retour webhook et l'interrogation directe de l'API operateur.

Sur une boutique a 300 commandes et un panier moyen de 25 000 FCFA, 3 % de commandes bloquees represente 9 commandes soit 225 000 FCFA de tresorerie en suspens chaque mois.

Architecture du journal et du cron

Le coeur du systeme est une table transactions qui stocke, pour chaque commande : la reference interne, la reference operateur, le montant attendu, le montant recu, le statut (pending, success, failed, mismatch) et l'horodatage. Un cron interroge toutes les 15 minutes les transactions restees pending au-dela de 3 minutes et met a jour leur statut via l'API. Chaque operateur expose un identifiant de transaction different qu'il faut mapper.

La regle : ne jamais livrer sur pending, ne livrer que sur success confirme par au moins deux sources concordantes (webhook + API), et lever une alerte sur tout mismatch de montant.

Mini cas pratique

Aminata gere une boutique de cosmetiques a Dakar avec 400 commandes par mois reparties entre Wave (60 %) et Orange Money (40 %). Avant reconciliation, 4 % des commandes restaient en attente, soit 16 commandes, pour un panier moyen de 20 000 FCFA, soit 320 000 FCFA de tresorerie floue mensuelle. Apres mise en place du journal + cron a 15 minutes, le taux tombe a 0,4 %, soit moins de 2 commandes. Elle recupere donc environ 14 x 20 000 = 280 000 FCFA de visibilite comptable par mois, et son rapprochement bancaire passe de 3 heures a 20 minutes.

FAQ

Un webhook ne suffit-il vraiment pas ? Non. Sur reseau instable, 2 a 5 % des webhooks se perdent ou arrivent en double. La reconciliation par API est le seul moyen d'atteindre une fiabilite proche de 100 %.

A quelle frequence lancer le cron de rattrapage ? Toutes les 15 minutes est un bon compromis entre fraicheur et charge API. Pour les commandes urgentes, un premier polling a 30 secondes complete le dispositif.

Comment gerer un ecart de montant (mismatch) ? Marquez la transaction mismatch, bloquez la livraison et alertez un operateur humain. C'est souvent un paiement partiel ou une erreur de saisie a arbitrer manuellement.

Quel identifiant sert de cle de rapprochement ? La reference operateur (id de session Wave, UUID MoMo, MpesaReceiptNumber, etc.) couplee a votre reference interne. Conservez toujours les deux en base.

Devenez apporteur d'affaires Kolonell. Vous connaissez des commercants qui perdent des paiements faute de reconciliation ? Recommandez-les et touchez une commission : 12 % sur un projet e-commerce, 15 % + 5 % recurrent sur une vitrine, 10 % sur une marketplace et 8 % sur l'institutionnel.

Discutons de votre projet. Nous construisons des systemes de reconciliation multi-operateurs fiables a plus de 99 %. WhatsApp +221 77 596 93 33.