Le verdict en trois phrases
A Nairobi, encaisser en M-Pesa passe par l'API Daraja et son STK Push : le client recoit une invite sur son telephone, saisit son code PIN et valide. Le taux de succes se situe entre 85 et 93 % en 2026, avec une confirmation en 5 a 30 secondes via une callback URL. Tout le secret d'une integration fiable est dans la gestion des ResultCode et la reconciliation serveur.
Le flux STK Push, etape par etape
Le STK Push (Lipa Na M-Pesa Online) declenche une invite de paiement directement sur le mobile du client. Votre serveur initie la requete, M-Pesa pousse l'invite, le client valide, puis M-Pesa appelle votre callback.
| Etape | Ce qui se passe | Duree (estim.) |
|---|---|---|
| 1. Auth OAuth | Obtenir le token via cle/secret | < 1 s |
| 2. STK Push init | Envoyer montant, numero, reference | 1-2 s |
| 3. Invite mobile | Le client voit l'invite et saisit son PIN | 5-25 s |
| 4. Callback | M-Pesa notifie votre CallBackURL | 1-3 s |
| 5. Reconciliation | Verifier ResultCode, marquer payee | < 1 s |
Ne validez jamais la commande sur le retour immediat de l'init : seule la callback signee confirme le paiement reel.
Gerer les ResultCode
Chaque tentative renvoie un ResultCode qui pilote votre logique. Voici les cas les plus frequents et l'action a prevoir.
| ResultCode | Signification | Action |
|---|---|---|
| 0 | Paiement reussi | Marquer payee, envoyer recu |
| 1 | Solde insuffisant | Proposer autre operateur |
| 1032 | Annule par l'utilisateur | Relancer ou proposer repli |
| 1037 | Timeout / pas de reponse | Reessayer STK Push une fois |
| 2001 | PIN incorrect | Inviter a reessayer |
| 1019 | Transaction expiree | Regenerer une invite |
Les codes 1032 et 1037 representent l'essentiel des echecs : un repli propose au bon moment recupere 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 reconciliation. Ordres de grandeur 2026 (estimation).
| Mode | Usage | Frais marchand (estim.) | Reconciliation |
|---|---|---|---|
| Till (Buy Goods) | Vente directe | ~0,5-1,5 % | par montant |
| Paybill | Factures, references | ~0,5-1,5 % | par reference 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 gere une epicerie en ligne a Nairobi et traite 700 paiements STK Push par mois. Avec un taux de succes brut de 88 %, 84 paiements echouent. En ajoutant un repli automatique sur les codes 1032 et 1037, elle recupere environ 45 % de ces echecs, soit 38 commandes sauvees. A 900 KES de panier moyen, cela represente 34 200 KES de chiffre d'affaires recupere chaque mois, sans acquisition supplementaire.
FAQ
Combien de temps prend une confirmation STK Push ?
Entre 5 et 30 secondes selon la reactivite du client et du reseau. Prevoyez un ecran d'attente cote client et une reconciliation serveur declenchee par la callback, jamais par un simple timer.
Que faire des paiements en timeout (code 1037) ?
Reessayez une fois le STK Push, puis proposez un repli si l'echec persiste. Ces timeouts representent une part importante des echecs et se recuperent bien.
Till ou Paybill pour une boutique ?
Till (Buy Goods) suffit pour une vente directe simple ; Paybill est preferable si vous devez rapprocher chaque paiement d'une reference client ou d'une facture.
Le taux de succes de 85-93 % est-il ameliorable ?
Oui, un bon design d'invite, des reessais cibles et un repli automatique le poussent vers le haut de la fourchette, en recuperant les annulations et timeouts.
Discutons de votre projet. On integre Daraja, on gere proprement les ResultCode et on met en place la reconciliation 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.
