Le verdict en trois phrases
Au Kenya et en Tanzanie, M-Pesa n'est pas une option, c'est le rail par défaut : sans lui, votre application perd la majorité des paiements. L'intégration passe par l'API Daraja de Safaricom (STK Push pour le pull, C2B pour le push, B2C pour les versements), avec des frais marchand de l'ordre de 1,5 % par encaissement en 2026. Comptez 3 à 6 semaines entre l'accès sandbox et la mise en production validée, l'essentiel du temps étant la gestion des callbacks et des timeouts.
Les APIs Daraja et à quoi elles servent
Safaricom expose plusieurs endpoints via la plateforme Daraja. Chacun couvre un flux métier distinct : encaisser depuis un client, recevoir un paiement initié par le client, ou reverser des fonds.
| API Daraja | Usage | Sens du flux | Cas typique |
|---|---|---|---|
| STK Push (Lipa na M-Pesa Online) | Encaissement app | App → client (pull) | Paiement panier e-commerce |
| C2B | Client vers marchand | Client → app (push) | Paiement via Paybill/Till |
| B2C | Versement | App → client | Remboursement, salaire, payout |
| B2B | Marchand vers marchand | App → app | Règlement fournisseur |
| Account Balance | Solde compte | Lecture | Dashboard trésorerie |
| Transaction Status | Vérif statut | Lecture | Réconciliation |
En Tanzanie, M-Pesa est opéré par Vodacom avec sa propre plateforme (souvent via un agrégateur), mais la logique STK Push / C2B / B2C reste la même. Prévoyez des identifiants et un environnement distincts par pays.
Frais et plafonds : ordre de grandeur 2026
Les frais varient selon le type de compte marchand (Paybill vs Till) et sont négociables au volume. Les chiffres ci-dessous sont une estimation 2026 à valider avec votre gestionnaire Safaricom.
| Paramètre | Kenya (M-Pesa) | Tanzanie (M-Pesa TZ) |
|---|---|---|
| Frais encaissement marchand | ~1,5 % | ~1,8 % |
| Plafond par transaction | 250 000 KES | 5 000 000 TZS |
| Plafond solde compte client | 500 000 KES | — |
| Délai versement B2C | Instantané à 24 h | Instantané à 48 h |
| Accès sandbox | Gratuit | Gratuit |
| Frais setup Paybill | Variable | Variable |
Étapes et délais d'intégration
| Étape | Livrable | Délai estimé |
|---|---|---|
| Compte développeur Daraja | Clés sandbox | 1 jour |
| Enregistrement app + credentials | Consumer key/secret | 2-3 jours |
| STK Push en sandbox | Paiement test OK | 3-5 jours |
| Gestion callback + timeout | URL callback fiable | 5-7 jours |
| Go-live (Paybill/Till réel) | Validation Safaricom | 1-2 semaines |
| Tests C2B + B2C | Flux complets | 3-5 jours |
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.
Le point critique : le callback. Le STK Push renvoie le résultat de façon asynchrone. Sans URL de callback publique fiable (HTTPS) et sans réconciliation par Transaction Status en secours, vous laisserez des paiements en statut « inconnu ».
Mini cas pratique
Grace, fondatrice d'un SaaS de facturation à Nairobi, encaisse 1 200 abonnements à 900 KES/mois, soit 1 080 000 KES de revenus mensuels. À 1,5 % de frais M-Pesa, elle paie 16 200 KES/mois de commissions, soit ~194 400 KES/an. En automatisant les relances via STK Push sur les paiements échoués (timeouts inclus), elle récupère 8 % de transactions initialement perdues, soit ~86 000 KES/mois de revenus additionnels — bien plus que le coût des frais.
FAQ
Faut-il une société locale pour obtenir un compte Paybill ? Oui, au Kenya un compte marchand M-Pesa exige une entité enregistrée et un compte bancaire local. Comptez quelques jours à deux semaines selon les documents.
Le sandbox Daraja est-il gratuit ? Oui, l'accès développeur et le sandbox sont gratuits. Les frais n'apparaissent qu'en production, sur les transactions réelles (~1,5 %).
Peut-on utiliser la même intégration au Kenya et en Tanzanie ? La logique d'API est similaire mais les plateformes, credentials et devises diffèrent (KES vs TZS). Prévoyez deux configurations distinctes.
Combien de temps pour être en production ? En moyenne 3 à 6 semaines, la validation Safaricom pour le go-live Paybill étant souvent le goulot d'étranglement.
Comment éviter les paiements en statut inconnu ? Combinez le callback STK Push avec un appel Transaction Status planifié (ex. toutes les 5 minutes) pour rattraper les callbacks perdus.
Discutons de votre projet. Nous intégrons M-Pesa, Wave et Orange Money dans votre application avec callbacks fiables et réconciliation automatique. 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.
