Skip to navigation

Kenya Payouts

KES payouts to banks and mobile wallets

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"

Required fields by rail

Bank transfer

FieldRequiredNotes
accountNumberYesBank account number
bankCodeYesLocal bank code
accountHolderNameYesName on the account
countryYesKEN
phoneNumberNoInternational format

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)

FieldRequiredNotes
phoneNumberYesMSISDN in international format
countryYesKEN
operatorYesUse mpesa or airtel
nameDepends on providerRecipient name. See Sender Details.

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:

FieldTypeRequiredDescriptionExample
fullNamestringYesSender’s full name"Jane Smith"
identitystringYesDocument type: passport, nationalId, driversLicense, residencePermit, businessRegistrationNumber, or other"passport"
identityNumberstringYesIdentity document number"A12345678"
country or nationalitystringYesISO 3-letter country code. Not needed if your account has a home country configured."ZAF"

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.

FieldTypeDescriptionExample
phoneNumberstringSender’s phone number"27821234567"
dateOfBirthstringDate of birth (YYYY-MM-DD)"1990-01-15"
purposeOfFundsstringPurpose of the transfer"salary"
sourceOfFundsstringSource of funds"business income"
relationshipstringRelationship to recipient"employer"

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:

FieldRequiredNotes
supportingDocumentsYesArray of base64-encoded documents that evidence the transfer, such as an invoice or a contract. Standard base64 with no data: prefix. Each must be a PDF, PNG or JPEG of at most ~3MB decoded, up to 5 documents. Only the first is sent to the bank.
sender.senderAddressYesSender’s physical address
sender.purposeOfFundsYesPurpose of the transfer. Optional only if your account manager has set a default purpose for your account.

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.

{
"merchantId": "your-merchant-id",
"merchantReference": "INV 2026-0042",
"destinationValue": {
"minorAmount": 150000000,
"currency": "KES"
},
"paymentMethodId": "banktransfer",
"paymentLocation": "KEN",
"supportingDocuments": [
"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK..."
],
"recipient": {
"type": "bank_account",
"accountNumber": "0123456789",
"bankCode": "01",
"accountHolderName": "Wanjiku Njeri",
"country": "KEN"
},
"sender": {
"fullName": "Acme Corporation Ltd",
"phoneNumber": "27110001234",
"nationality": "ZAF",
"identity": "businessRegistrationNumber",
"identityNumber": "2020/123456/07",
"dateOfBirth": "2015-03-20",
"senderAddress": "10 Long Street, Cape Town, 8001, South Africa",
"purposeOfFunds": "invoice settlement",
"sourceOfFunds": "business revenue",
"relationship": "business"
}
}

Example requests

Bank transfer

{
"merchantId": "your-merchant-id",
"merchantReference": "PAYOUT-KE-001",
"destinationValue": {
"minorAmount": 200000,
"currency": "KES"
},
"paymentMethodId": "banktransfer",
"paymentLocation": "KEN",
"recipient": {
"type": "bank_account",
"accountNumber": "0123456789",
"bankCode": "01",
"accountHolderName": "Wanjiku Njeri",
"country": "KEN"
},
"sender": {
"fullName": "Jane Smith",
"phoneNumber": "27821234567",
"nationality": "ZAF",
"identity": "passport",
"identityNumber": "A12345678",
"dateOfBirth": "1990-01-15",
"purposeOfFunds": "salary",
"sourceOfFunds": "business income",
"relationship": "employer"
}
}

Mobile wallet (M-Pesa) — Individual sender

{
"merchantId": "your-merchant-id",
"merchantReference": "PAYOUT_550e8400-e29b-41d4-a716-446655440000",
"destinationValue": {
"minorAmount": 2000,
"currency": "KES"
},
"paymentMethodId": "mobilemoney",
"paymentLocation": "KEN",
"attributes": {},
"recipient": {
"type": "mobile_money",
"name": "John Doe",
"operator": "mpesa",
"country": "KEN",
"phoneNumber": "254723993187"
},
"sender": {
"fullName": "Jane Smith",
"phoneNumber": "27821234567",
"nationality": "ZAF",
"identity": "passport",
"identityNumber": "A12345678",
"dateOfBirth": "1990-01-15",
"purposeOfFunds": "salary",
"sourceOfFunds": "business income",
"relationship": "employer"
}
}

Mobile wallet (M-Pesa) — Company sender

When the sender is a company, use the company’s registered details:

{
"merchantId": "your-merchant-id",
"merchantReference": "PAYOUT_660e8400-e29b-41d4-a716-446655440001",
"destinationValue": {
"minorAmount": 50000,
"currency": "KES"
},
"paymentMethodId": "mobilemoney",
"paymentLocation": "KEN",
"attributes": {},
"recipient": {
"type": "mobile_money",
"name": "John Doe",
"operator": "mpesa",
"country": "KEN",
"phoneNumber": "254723993187"
},
"sender": {
"fullName": "Acme Corporation Ltd",
"phoneNumber": "27110001234",
"nationality": "ZAF",
"identity": "businessRegistrationNumber",
"identityNumber": "2020/123456/07",
"dateOfBirth": "2015-03-20",
"purposeOfFunds": "vendor payment",
"sourceOfFunds": "business revenue",
"relationship": "business"
}
}

Company sender mapping:

Sender fieldCompany value
fullNameCompany registered name
identity"businessRegistrationNumber"
identityNumberCompany registration number
dateOfBirthDate of incorporation (YYYY-MM-DD)

Important notes

  • Sender Details: The sender object is required for all payouts. Requests missing fullName, identity or identityNumber are 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 supportingDocuments and sender.senderAddress. See Bank transfers of KES 1,000,000 or more.