Le verdict en trois phrases
La réconciliation mobile money à Bamako consiste à rapprocher trois sources — webhook, relevé opérateur et commandes internes — chaque jour. Le vrai travail porte sur les 3 à 7 % de transactions 'pending' fantômes, les doublons et un écart de settlement moyen de 0,3 à 1,2 %. Avec une clé d'idempotence et une fenêtre de retry webhook de 24 h, un script quotidien élimine 95 % des erreurs manuelles.
Tableau des écarts types et leurs causes
| Type d'écart | Fréquence estimée | Cause principale | Action |
|---|---|---|---|
| Pending fantôme | 3-7 % | Callback jamais reçu | Query statut à J+1 |
| Doublon | 0,5-2 % | Retry sans idempotence | Dédupliquer par référence |
| Montant divergent | 0,3-1,2 % | Frais déduits au settlement | Réconcilier net vs brut |
| Paiement orphelin | 0,5-1,5 % | Commande annulée côté site | Rembourser ou créditer |
| Retard settlement | 5-10 % | Payout T+2 opérateur | Attendre relevé J+2 |
| Statut incohérent | 1-3 % | Webhook et query divergent | Prioriser la query serveur |
Règle d'or : le relevé opérateur fait foi pour l'argent réellement versé. Le webhook signale l'intention, la query confirme le statut, mais seul le relevé de settlement prouve l'encaissement net après frais.
Méthode de réconciliation en 5 étapes
| Étape | Opération | Fréquence |
|---|---|---|
| 1 | Exporter les webhooks reçus (24 h) | Quotidienne |
| 2 | Télécharger le relevé Orange Money | Quotidienne |
| 3 | Joindre par externalId / référence | Automatique |
| 4 | Isoler pending, doublons, orphelins | Automatique |
| 5 | Re-query les pending > 24 h | Quotidienne |
Automatisez les étapes 1 à 4 par un script nocturne. Point critique : imposez une clé d'idempotence à l'initiation du paiement — c'est elle qui rend la déduplication fiable et bloque les doubles débits lors des retries.
Mini cas pratique
Modibo gère une boutique d'électroménager à Bamako : 400 transactions/mois via Orange Money, chiffre encaissé 12 000 000 FCFA. Sans réconciliation, 5 % de pending fantômes (20 transactions) restent non confirmés, soit 600 000 FCFA de statut incertain. Son script quotidien re-query ces pending à J+1 et en confirme 17 (les 3 restants étant de vrais échecs). Résultat : 510 000 FCFA correctement encaissés et comptabilisés, et une clôture comptable mensuelle qui tombe juste au premier essai.
FAQ
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.
Pourquoi ai-je des transactions 'pending' qui ne se résolvent jamais ?
Souvent parce que le callback webhook n'est jamais arrivé (endpoint down, timeout réseau). La parade : re-query le statut de chaque pending à J+1 directement auprès de l'opérateur.
À quoi sert la clé d'idempotence exactement ?
Elle identifie de façon unique chaque tentative de paiement. En cas de retry, l'opérateur reconnaît la même clé et ne débite pas deux fois, ce qui élimine les doublons à la source.
Pourquoi le montant versé diffère du montant commandé ?
Parce que les frais marchands (1 à 3,5 %) sont déduits au settlement. Réconciliez toujours le montant net reçu contre le montant brut commandé, pas l'inverse.
Quelle est la fenêtre de retry d'un webhook ?
La plupart des opérateurs retentent l'envoi pendant environ 24 h. Prévoyez un endpoint idempotent capable de recevoir plusieurs fois le même événement sans créer de doublon.
Puis-je réconcilier manuellement au début ?
Oui, en dessous de 100 transactions/mois. Au-delà, un script automatisé devient indispensable pour tenir le rythme et éviter les erreurs de saisie.
Discutons de votre projet. Nous mettons en place vos scripts de réconciliation quotidienne avec idempotence et re-query automatique des pending. 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.