Why a payment fails, and what to tell the customer
2 min readLast updated 16 September 2026 Read as plain text
Almost every failure is one of five things, and four of them are fixed by the customer trying again with better information.
A failed payment feels like a technical problem and usually is not. On mobile money, the most common outcome is not an error at all: it is a customer who did not finish.
The five real reasons
- 1The prompt was not answered. It arrived while they were on a call, or they dismissed it. Nothing was charged. This is the most common by a distance.
- 2Not enough balance. The network declines before anything reaches you.
- 3The wrong number. The prompt went to a stranger, who declined it, correctly.
- 4A transaction limit. Mobile money accounts have daily and per-transaction ceilings, often lower than people realise, and a large payment simply cannot go through.
- 5The network or gateway is having trouble. Genuinely rare, and the only one that is ours rather than theirs.
What to say
The instinct is to say "payment failed, please try again". That tells the customer nothing and makes them suspect you took their money. Say what happened and what to do:
- Not answered: "We did not see a response on your phone. Nothing was charged. Shall we send it again?"
- Insufficient balance: "Your wallet did not have enough at that moment. Top up and we will resend."
- Limit reached: "Your network caps single payments. You can pay in two parts, or use a card."
- Anything else: "Something went wrong on our side and nothing was charged. We are resending."
The one thing to always include
Say explicitly that nothing was charged, when nothing was charged. The fear behind almost every support message about a failed payment is that the money left and the order did not arrive.
When it is worth investigating
One customer failing is a customer. The same network failing repeatedly within an hour is worth looking at, and the request log will show the response the gateway actually gave rather than the summary the customer reports.
