The verdict in three sentences
A failed payment is not a lost sale: it's a sale waiting to be recovered. On mobile money, 18% of attempts fail on the first try, but a clear message and a well-built retry recover 55% of those cases. The key is translating technical codes into concrete actions for the customer, instead of a cold "transaction failed."
Decoding common failure codes
Every operator returns different codes, but the causes cluster into a handful of families. The checkout's job is to map those codes to a human message and an action.
| Cause | Share of failures | Recommended customer message | Recovery action |
|---|---|---|---|
| Insufficient funds | 42% | "Not enough balance, top up then retry" | Retry after top-up |
| Wrong PIN | 21% | "Incorrect PIN, check and try again" | Immediate retry |
| Timeout (8s) | 18% | "Confirmation took too long, retrying" | Auto retry once |
| Limit exceeded | 11% | "Amount above your daily limit" | Offer split |
| PIN locked (3 tries) | 5% | "Account locked, contact your operator" | Switch operator |
| Other / network | 3% | "Temporary network issue" | Delayed retry |
A PIN locks after 3 wrong tries; the timeout typically fires at 8 seconds without confirmation.
The retry mechanics that save the sale
| Metric | No failure handling | With retry + messages | Gap |
|---|---|---|---|
| First-try failure | 18% | 18% | — |
| Sales recovered after failure | 12% | 55% | +43 pts |
| Daily wallet limit | 200,000 FCFA | 200,000 FCFA | constraint |
| Confirmation timeout | 8s | 8s | retry threshold |
| PIN lock | 3 tries | 3 tries | switch threshold |
| Explicit error message | no | yes | UX key |
These are 2026 order-of-magnitude figures for a West African checkout. The gain comes mostly from clarity: a customer who reads "top up then retry" acts, while an anonymous "failure" drives them away.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
Mini case study
Ibrahim, a restaurateur in Abidjan, takes 600 online orders a month with an average basket of 9,500 FCFA. 18% fail on the first try, i.e. 108 attempts. Without recovery he saved only 12%, i.e. 13 orders. With clear messages and a retry he recovers 55%, i.e. 59 orders. The net gain is 46 orders a month, roughly 437,000 FCFA of recovered revenue, purely from better error handling.
FAQ
Why are 42% of failures due to insufficient funds? Because many customers pay without checking their balance. A "top up then retry" message points them straight to the action that unlocks the sale.
Should you auto-retry after a timeout? Yes, once. The 8-second timeout is often caused by a slow confirmation; a single auto retry avoids double-charging while recovering the transaction.
What to do when the PIN is locked? Don't push: after 3 tries the account is locked on the operator side. Offer another wallet or the QR code so you don't lose the sale.
How do you handle an exceeded limit? Offer a split payment or another method. The base daily cap is 200,000 FCFA on many wallets.
Does a good message really change the outcome? Yes: moving from a generic "failure" to an actionable message boosts recovery from 12% to 55%.
Let's talk about your project. We can map your error codes and wire a retry that saves the sale. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionate about digital and entrepreneurship in Africa, Mohamed has been helping Sénégalese businesses with their digital transformation since 2020. Founder of Kolonell, he believes every SME deserves a professional and accessible online présence.
