The verdict in three sentences
Adding M-Pesa via the Safaricom Daraja API to a Kenyan store takes in practice 7 to 15 days once your Paybill or Till is approved, the real bottleneck being the API access approval from Safaricom. Merchant fees run around 0.5–1.5% depending on tariff band, but the technical challenge is the confirmation callbacks and STK Push timeout handling. A sloppy integration creates ghost orders: the customer pays but the order stays "unpaid" for lack of a reliable callback.
The technical integration steps
The path is similar for Paybill and Till Number, with API nuances. Here is the typical sequence.
| Step | Description | Estimated time |
|---|---|---|
| 1. Merchant account | Open and KYC-verify a Paybill or Till | 3–7 days |
| 2. API keys | Receive consumer key, secret, shortcode, passkey | 1–3 days |
| 3. Checkout | STK Push request generation and prompt | 2–4 days |
| 4. Callbacks | Receive and verify confirmation callbacks | 1–2 days |
| 5. Testing | Real small-amount transactions, failure handling | 2–3 days |
| 6. Go-live | Switch to production credentials, monitoring | 1 day |
The critical point is step 4. Without a verified callback URL you cannot confirm an order reliably, forcing you into costly status polling.
Costs and failure handling
Here are 2026 order-of-magnitude figures for a Kenyan SME. API access is often low-cost; the real spend is development.
| Item | Paybill | Till (Buy Goods) |
|---|---|---|
| Merchant fee | Banded, ~0.5–1.5% | Banded, ~0.5–1.5% |
| API access | Free to low | Free to low |
| Settlement | T+1 | Same day to T+1 |
| STK Push timeout | 60–120 s | 60–120 s |
| Reversal handling | Manual/portal | Manual/portal |
| Integration dev | KES 60,000–140,000 | included if combined |
For timeouts, the golden rule: show a "waiting for confirmation" status and never mark an order paid before the callback arrives. Build in automatic retry and a customer re-prompt if STK Push fails.
Mini case study
Brian runs an online hardware shop in Nairobi. He gets 120 orders/month at an average basket of KES 3,500, so KES 420,000 turnover. Before a clean integration, 8% of orders stayed stuck as "unpaid" although the customer had paid, causing disputes and manual refunds. After integrating verified callbacks and retry, that rate falls to 1.5%. On 120 orders he recovers about 8 orders/month previously lost, roughly KES 28,000/month of saved revenue, with the integration cost paid back in under 3 months.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
FAQ
How long does it take to integrate M-Pesa in Kenya?
Expect 7 to 15 days in total, of which 3 to 7 days are for Paybill/Till approval. The technical integration itself takes 4 to 8 days for an experienced team.
What does an M-Pesa integration cost?
Daraja API access is often free or low-cost, but development (STK Push, callbacks, reconciliation) usually costs between KES 60,000 and KES 140,000 depending on complexity.
Why do some orders stay "unpaid"?
It almost always comes from a misconfigured callback or a badly handled STK Push timeout. The customer pays but the notification never lands, leaving the order stuck. A verified callback and retry fix it.
Should I use a Paybill or a Till Number?
Paybill suits invoicing and account references; Till suits fast buy-goods checkout. Many stores start with a Till and add a Paybill later; the same integration can cover both.
How do I handle STK Push timeouts?
Show a "waiting" status for 60 to 120 seconds, never confirm before the callback, and offer a "retry" button. This prevents double payments and ghost orders.
Let's talk about your project. We integrate M-Pesa via Daraja with verified callbacks and timeout handling on your website. 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.