Le verdict en trois phrases
Moov Money est l'opérateur secondaire clé au Bénin, Togo et Niger, avec un frais de collecte d'environ 1,2 % (ordre de grandeur 2026). Son intégration API repose sur quatre piliers : authentification, callback asynchrone, gestion du timeout et idempotence. Bien câblé, il atteint un taux de succès cible de 98,5 % ; mal câblé, il génère doubles débits et remboursements en cascade.
Les paramètres API à maîtriser
| Paramètre | Valeur / plage | Rôle |
|---|---|---|
| Frais de collecte | ~1,2 % | Coût marchand |
| Latence de callback | 3 à 8 s | Confirmation asynchrone |
| Fenêtre de retry timeout | 90 s | Rejouer la requête |
| Mise en place sandbox | ~2 jours | Tests avant prod |
| Clé d'idempotence | UUID par commande | Éviter doubles débits |
| Taux de succès cible | 98,5 % | KPI d'intégration |
La règle d'or : une clé d'idempotence par commande. Si le callback tarde et que le client réessaie, la même clé empêche un second débit.
Moov vs Airtel : deux opérateurs secondaires comparés
| Critère | Moov Money (Bénin/Togo/Niger) | Airtel Money (Ouganda) |
|---|---|---|
| Frais de collecte | ~1,2 % | 1 % + palier UGX 0 |
| Latence callback | 3 à 8 s | 2 à 6 s |
| Sandbox | ~2 jours | ~1 à 2 jours |
| Idempotence | Recommandée | Recommandée |
| Couverture | 3 pays UEMOA | Afrique de l'Est |
Les deux imposent la même discipline : ne jamais valider une commande sur la réponse HTTP immédiate, mais uniquement sur le callback signé.
Mini cas pratique
Kossi, gérant d'une boutique de recharges à Lomé, traite 900 paiements Moov/mois. Sans idempotence, un callback lent provoquait 1,5 % de doubles débits, soit environ 14 remboursements/mois à traiter manuellement (30 min chacun = 7 h). Après ajout d'une clé d'idempotence et d'une fenêtre de retry de 90 s, les doubles débits sont tombés à 0,1 %, libérant près de 7 heures/mois et fiabilisant la trésorerie à 98,6 % de succès.
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 valider sur la réponse HTTP immédiate ?
Parce que Moov confirme le paiement de façon asynchrone via un callback de 3 à 8 secondes. Valider sur la réponse initiale expose à des commandes marquées payées puis rejetées.
À quoi sert la clé d'idempotence ?
Elle garantit qu'une même commande rejouée (client qui réessaie, réseau instable) ne génère qu'un seul débit. C'est la protection numéro un contre les doubles paiements.
Combien de temps pour un sandbox opérationnel ?
Comptez environ 2 jours pour Moov : obtention des clés, test du callback et simulation d'un timeout. Ne passez jamais en production sans avoir testé le scénario timeout.
Que faire si le callback n'arrive jamais ?
Déclenchez une vérification de statut active (polling) dans la fenêtre de 90 s, puis marquez la commande « à vérifier » plutôt que « échouée » pour éviter d'annuler un paiement réellement passé.
Discutons de votre projet. Nous intégrons Moov Money et Airtel Money avec idempotence et retry pour un checkout à 98,5 % de succès. 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.
