Kenya payout

Payment Account Types

The supported payment account types in Kenya are:

MOBILE_MONEY
BANK_ACCOUNT

Mobile Money

The supported mobile money operators in Kenya are:

SAFARICOM (aka M-PESA)
AIRTEL

Bank Account

We support payouts to various banks in Kenya. To retrieve the most current list of supported banks, use the List Banks endpoint.

Decimal Requirements

Payment Account Type	Decimals Allowed
MOBILE_MONEY (SAFARICOM)	2
MOBILE_MONEY (AIRTEL)	2
BANK_ACCOUNT	2

Transaction Limits

Payment Account Type	Minimum Amount (KES)	Maximum Amount (KES)
MOBILE_MONEY (SAFARICOM)	10	250,000
MOBILE_MONEY (AIRTEL)	10	250,000
BANK_ACCOUNT	100	950,000

Compliance requirements

Field	Requirements
sender.type	Required
sender.name	Required
sender.address.line1	Required
sender.address.city	Required
sender.address.postal_code	Required
sender.address.country	Required
sender.individual.dob	Required (with type `INDIVIDUAL`)

Sample Payload

The samples below are specific to Kenya and based on the local regulations.

For a more comprehensive list of fields, see the Create Payout resource.

{
  "amount": {
    "currency": "KES",
    "value": "1250.50"
  },
  "payment_account": {
    "type": "MOBILE_MONEY",
    "country": "KE",
    "holder": {
      "type": "INDIVIDUAL",
      "name": "John Mwangi"
    },
    "mobile_money": {
      "operator": "SAFARICOM",
      "number": "+254712345678"
    }
  },
  "sender": {
    "type": "INDIVIDUAL",
    "name": "Mario Rossi",
    "address": {
      "line_1": "Piazza del Colosseo",
      "line_2": "1",
      "line_3": "",
      "city": "Roma",
      "postal_code": "00184",
      "country": "IT"
    },
    "individual": {
      "dob": "1985-06-15"
    }
  }
}