Kenya Payouts
Use this guide when you want to send KES payouts to recipients in Kenya. Kenya supports bank transfers and mobile wallets (M-Pesa, Airtel).
Overview
- Currency: KES
- Payment location:
KEN - Supported rails: Bank transfer, Mobile wallet
- Payment methods:
- Bank transfer →
paymentMethodId: "banktransfer",recipient.type: "bank_account" - Mobile wallet →
paymentMethodId: "mobilemoney",recipient.type: "mobile_money"
- Bank transfer →
Required fields by rail
Bank transfer
Bank transfers of KES 1,000,000 or more also need a supporting document and a sender address. See Bank transfers of KES 1,000,000 or more.
Mobile wallet (M-Pesa, Airtel)
Top-level required fields for every payout: merchantId, merchantReference, destinationValue (with minorAmount and currency), paymentMethodId, paymentLocation, recipient, sender (see Sender Details).
Sender Details (Required)
Every payout requires a sender object. Which sender fields are required depends on the rail and on the provider that carries the payout for your account. Call Get Payout Field Requirements with country=KEN, the method, currency=KES and the amount for the exact list your account needs.
Every Kenya payout:
Mobile wallet payouts, depending on provider. Some Kenya mobile wallet providers also need the fields below, and the recipient’s name. Requests that reach those providers without them fail before any funds move.
Bank transfers of KES 1,000,000 or more also need supportingDocuments, sender.senderAddress and, unless a default purpose is set for your account, sender.purposeOfFunds. See Bank transfers of KES 1,000,000 or more.
Bank transfers of KES 1,000,000 or more
Bank transfers of KES 1,000,000 (100000000 minor units) or more settle over RTGS. You send the same Initiate Payout request, with these additions:
Request validation does not check for supportingDocuments or sender.senderAddress. A payout without them fails before any funds move.
RTGS payouts are enabled per merchant. Contact your account manager before sending bank transfers of KES 1,000,000 or more.
Mobile wallet payouts do not settle over RTGS and do not need supportingDocuments or sender.senderAddress, whatever the amount.
Example requests
Bank transfer
Mobile wallet (M-Pesa) — Individual sender
Mobile wallet (M-Pesa) — Company sender
When the sender is a company, use the company’s registered details:
Company sender mapping:
Important notes
- Sender Details: The
senderobject is required for all payouts. Requests missingfullName,identityoridentityNumberare rejected with a validation error. Fields a provider requires are checked when the payout reaches that provider. - High-value bank transfers: Bank transfers of KES 1,000,000 or more need
supportingDocumentsandsender.senderAddress. See Bank transfers of KES 1,000,000 or more.