Kenya
Invoice and collect in Kenya
LivePayouts by bank wire
Yes, for collecting. Invoice and collect works in Kenya on M-Pesa (Safaricom), Airtel Money, T-Kash, settling in KES. Paying out to a Kenya wallet is not live yet, so money leaves by wire to a bank account instead, which works from any country.
What this looks like in Kenya
3
networks a payer can use
KES
2 decimal places
Mpesa
provider code for M-Pesa (Safaricom)
The call
Amounts in KES are in the minor unit, which is the thing most integrations get wrong here.
curl https://api.ultraner.com/v1/payments/express/mno \
-H "X-API-Key: $ULTRANER_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-d provider="Mpesa" \
-d account_number="254000000000" \
-d currency="KES" \
-d amount=25002,500 means 25 KES. The payer confirms on their handset, so the result arrives by webhook rather than in this response.
What this is built on
Invoices Live
Issue an invoice and collect against it.
Accept payments Live
Charge a mobile money wallet, card, bank account or PayPal.
Currency conversion Live
A payer pays in their currency, you are credited in yours.
Common questions
- How do I invoice a customer and get paid in local currency?
- Yes, for collecting. Invoice and collect works in Kenya on M-Pesa (Safaricom), Airtel Money, T-Kash, settling in KES. Paying out to a Kenya wallet is not live yet, so money leaves by wire to a bank account instead, which works from any country.
- Which networks can I charge in Kenya?
- M-Pesa (Safaricom), Airtel Money and T-Kash. All of them behind one integration; the provider code you send picks the rail.
- How do I write the amount for KES?
- KES has 2 decimal places. Amounts are sent in the minor unit, so 2500 means 25.00 KES.
- Can I pay out to a Kenya mobile money wallet?
- Not yet. Disbursement is live in Tanzania and the other markets are being brought up one verified rail at a time. Settling your balance to your own bank account by wire works from Kenya today, as it does everywhere.