Le verdict en trois phrases
À Nairobi, encaisser en M-Pesa passe par l'API Daraja et son STK Push : le client reçoit une invite sur son téléphone, saisit son code PIN et valide. Le taux de succès se situe entre 85 et 93 % en 2026, avec une confirmation en 5 à 30 secondes via une callback URL. Tout le secret d'une intégration fiable est dans la gestion des ResultCode et la réconciliation serveur.
Le flux STK Push, étape par étape
Le STK Push (Lipa Na M-Pesa Online) déclenche une invite de paiement directement sur le mobile du client. Votre serveur initie la requête, M-Pesa pousse l'invite, le client valide, puis M-Pesa appelle votre callback.
| Étape | Ce qui se passe | Durée (estim.) |
|---|---|---|
| 1. Auth OAuth | Obtenir le token via clé/secret | < 1 s |
| 2. STK Push init | Envoyer montant, numéro, référence | 1-2 s |
| 3. Invité mobile | Le client voit l'invité et saisit son PIN | 5-25 s |
| 4. Callback | M-Pesa notifie votre CallBackURL | 1-3 s |
| 5. Réconciliation | Vérifier ResultCode, marquer payée | < 1 s |
Ne validez jamais la commande sur le retour immédiat de l'init : seule la callback signée confirme le paiement réel.
Gérer les ResultCode
Chaque tentative renvoie un ResultCode qui pilote votre logique. Voici les cas les plus fréquents et l'action à prévoir.
| ResultCode | Signification | Action |
|---|---|---|
| 0 | Paiement réussi | Marquer payée, envoyer reçu |
| 1 | Solde insuffisant | Proposer autre opérateur |
| 1032 | Annulé par l'utilisateur | Relancer ou proposer repli |
| 1037 | Timeout / pas de réponse | Réessayer STK Push une fois |
| 2001 | PIN incorrect | Inviter à réessayer |
| 1019 | Transaction expirée | Régénérer une invité |
Les codes 1032 et 1037 représentent l'essentiel des échecs : un repli proposé au bon moment récupère une bonne partie de ces paiements.
Frais Till vs Paybill
Le choix entre Till (Buy Goods) et Paybill influe sur les frais marchand et la réconciliation. Ordres de grandeur 2026 (estimation).
| Mode | Usage | Frais marchand (estim.) | Réconciliation |
|---|---|---|---|
| Till (Buy Goods) | Vente directe | ~0,5-1,5 % | par montant |
| Paybill | Factures, références | ~0,5-1,5 % | par référence client |
| B2C (payouts) | Reverser aux vendeurs | frais fixes par tranche | par lot |
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.
Mini cas pratique
Wanjiru gère une épicerie en ligne à Nairobi et traite 700 paiements STK Push par mois. Avec un taux de succès brut de 88 %, 84 paiements échouent. En ajoutant un repli automatique sur les codes 1032 et 1037, elle récupère environ 45 % de ces échecs, soit 38 commandes sauvées. À 900 KES de panier moyen, cela représente 34 200 KES de chiffre d'affaires récupéré chaque mois, sans acquisition supplémentaire.
FAQ
Combien de temps prend une confirmation STK Push ?
Entre 5 et 30 secondes selon la réactivité du client et du réseau. Prévoyez un écran d'attente côté client et une réconciliation serveur déclenchée par la callback, jamais par un simple timer.
Que faire des paiements en timeout (code 1037) ?
Réessayez une fois le STK Push, puis proposez un repli si l'échec persiste. Ces timeouts représentent une part importante des échecs et se récupèrent bien.
Till ou Paybill pour une boutique ?
Till (Buy Goods) suffit pour une vente directe simple ; Paybill est préférable si vous devez rapprocher chaque paiement d'une référence client ou d'une facture.
Le taux de succès de 85-93 % est-il améliorable ?
Oui, un bon design d'invite, des réessais cibles et un repli automatique le poussent vers le haut de la fourchette, en récupérant les annulations et timeouts.
Discutons de votre projet. On intègre Daraja, on gère proprement les ResultCode et on met en place la réconciliation par callback. 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.
