Le verdict en trois phrases
Airtel Money est incontournable là où il domine (Gabon, Tchad, RDC, Malawi, Zambie), mais son API Collections varie par pays, donc prévoyez une couche d'abstraction. Le flow standard est un push STK : vous appelez l'API, le client valide sur son téléphone, vous recevez un callback de confirmation. Comptez 5 à 8 jours de dev pour une intégration propre avec webhooks, retries et réconciliation.
Le flow de collection Airtel Money
Le parcours technique est le même partout, seuls les endpoints et plafonds changent. Voici les étapes et les points de vigilance.
| Étape | Action | Point de vigilance |
|---|---|---|
| 1. Auth | OAuth2 client_credentials | Token à cacher (~1h) |
| 2. Initier | POST /collection avec MSISDN + montant | Format MSISDN par pays |
| 3. Push STK | Le client reçoit un prompt PIN | Timeout ~60-90 s |
| 4. Callback | Webhook succès/échec | Vérifier la signature |
| 5. Statut | GET /transaction/{id} | Polling si callback manqué |
| 6. Réconciliation | Rapprocher settlement | Frais déduits à la source |
Le piège classique : traiter la réponse d'initiation comme une confirmation de paiement. Seul le callback (ou un GET de statut) confirme l'encaissement. Sans idempotence, un retry peut double-compter une commande.
Pays supportés, frais et plafonds 2026
Les plafonds transactionnels et les frais marchand diffèrent sensiblement d'un marché à l'autre. Ordres de grandeur 2026.
| Pays | Frais marchand | Plafond / transaction | Settlement |
|---|---|---|---|
| Cameroun | 1,8 % | 500 000 XAF | J+2 |
| Gabon | 1,5 % | 1 000 000 XAF | J+1 |
| Tchad | 2,0 % | 400 000 XAF | J+2 |
| RDC | 1,7 % | ~1 000 USD éq. | J+2 |
| Zambie | 1,5 % | 20 000 ZMW | J+1 |
| Malawi | 1,8 % | 1 500 000 MWK | J+2 |
Budgétez large sur le settlement : plusieurs marchés Airtel versent en J+2, ce qui immobilise votre trésorerie. Négociez le J+1 dès que votre volume le justifie.
Mini cas pratique
Serge, gérant d'un service de livraison à Yaoundé, veut encaisser en ligne. Volume : 250 courses/mois à 4 000 XAF, soit 1 000 000 XAF/mois. Frais Airtel à 1,8 % : 18 000 XAF/mois. Intégration : 6 jours dev facturés une fois. Avant, 30 % de ses clients payaient cash à la livraison avec 12 % d'échecs de recouvrement ; en poussant le prépaiement Airtel Money, il supprime ~36 000 XAF/mois de pertes. L'intégration est amortie en moins de deux mois.
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
Combien de temps pour intégrer Airtel Money ?
Entre 5 et 8 jours de développement pour une intégration production avec webhooks, retries et réconciliation. Le sandbox permet de tester sans argent réel.
Le sandbox Airtel est-il fiable ?
Oui pour valider le flow (auth, push, callback), mais certains comportements de plafond et de timeout ne se voient qu'en production. Prévoyez une phase de test réel avec petits montants.
Que faire si le callback n'arrive pas ?
Mettre en place un polling GET /transaction/{id} toutes les 10-15 s pendant 2 minutes. Ne jamais valider une commande sur la seule réponse d'initiation.
Les frais sont-ils déduits à la source ?
Oui, généralement le settlement arrive net de commission. Votre réconciliation doit rapprocher montant brut, frais et montant versé.
Peut-on couvrir plusieurs pays avec un seul code ?
Avec une couche d'abstraction oui : mêmes étapes, endpoints et formats MSISDN paramétrés par pays. C'est ce qu'on construit pour éviter de réécrire l'intégration à chaque marché.
Discutons de votre projet. On intègre Airtel Money multi-pays à votre checkout, avec idempotence, retries et réconciliation propre. 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.
