The verdict in three sentences
Airtel Money is unavoidable where it dominates (Gabon, Chad, DRC, Malawi, Zambia), but its Collections API varies by country, so plan an abstraction layer. The standard flow is an STK push: you call the API, the customer approves on their phone, you receive a confirmation callback. Allow 5 to 8 dev days for a clean integration with webhooks, retries and reconciliation.
The Airtel Money collection flow
The technical journey is the same everywhere; only endpoints and limits change. Here are the steps and watch-points.
| Step | Action | Watch-point |
|---|---|---|
| 1. Auth | OAuth2 client_credentials | Cache the token (~1h) |
| 2. Initiate | POST /collection with MSISDN + amount | MSISDN format per country |
| 3. STK push | Customer gets a PIN prompt | Timeout ~60-90 s |
| 4. Callback | Success/failure webhook | Verify the signature |
| 5. Status | GET /transaction/{id} | Poll if callback missed |
| 6. Reconciliation | Match settlement | Fees deducted at source |
The classic trap: treating the initiation response as a payment confirmation. Only the callback (or a status GET) confirms collection. Without idempotency, a retry can double-count an order.
Supported countries, fees and 2026 limits
Transaction limits and merchant fees differ noticeably from market to market. 2026 orders of magnitude.
| Country | Merchant fee | Limit / transaction | Settlement |
|---|---|---|---|
| Cameroon | 1.8 % | 500,000 XAF | T+2 |
| Gabon | 1.5 % | 1,000,000 XAF | T+1 |
| Chad | 2.0 % | 400,000 XAF | T+2 |
| DRC | 1.7 % | ~1,000 USD eq. | T+2 |
| Zambia | 1.5 % | 20,000 ZMW | T+1 |
| Malawi | 1.8 % | 1,500,000 MWK | T+2 |
Budget generously on settlement: several Airtel markets pay out at T+2, tying up your cash flow. Negotiate T+1 as soon as your volume justifies it.
Mini case study
Tunde, who runs a delivery service in Lagos, wants to collect online. Volume: 250 rides/month at 4,000, i.e. 1,000,000/month. Airtel fees at 1.8 %: 18,000/month. Integration: 6 dev days billed once. Previously, 30 % of his customers paid cash on delivery with 12 % collection failures; by pushing Airtel Money prepayment, he removes ~36,000/month of losses. The integration pays for itself in under two 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 to integrate Airtel Money?
Between 5 and 8 dev days for a production integration with webhooks, retries and reconciliation. The sandbox lets you test without real money.
Is the Airtel sandbox reliable?
Yes for validating the flow (auth, push, callback), but some limit and timeout behaviours only appear in production. Plan a real-money test phase with small amounts.
What if the callback never arrives?
Set up polling GET /transaction/{id} every 10-15 s for 2 minutes. Never confirm an order on the initiation response alone.
Are fees deducted at source?
Yes, settlement usually arrives net of commission. Your reconciliation must match gross amount, fees and paid amount.
Can one codebase cover several countries?
With an abstraction layer, yes: same steps, endpoints and MSISDN formats parameterised per country. That is what we build to avoid rewriting the integration per market.
Let's talk about your project. We integrate multi-country Airtel Money into your checkout, with idempotency, retries and clean reconciliation. 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.
