🇰🇪Kenya

Check the requirements and validations made over the cashouts on Kenya

Required fields

Field	Format	Description
login	String	Cashouts login
pass	String	Cashouts pass
external_id	String (max length: 100)	Transaction's ID on your end
document_id	See document validations	Beneficiary's document ID
country	KE	See country codes
currency	KES / USD	See currency codes
amount	Number with up to 2 decimals	Cashout amount
bank_account	See validations below	Beneficiary's bank account.
bank_code	See bank codes	Code specifying the beneficiary's bank
beneficiary_name	String (max length: 100)	Beneficiary's name
beneficiary_lastname	String (max length: 100)	Beneficiary's last name
phone	Numeric	Beneficiary's Phone Number

Bank Account Validations

Bank name	Bank code	Format	Example
All	-	Numeric	123456789, 9283749293

Document Validations

Click here to check document types and validations.

Example Request

Mobile Money

Bank	Bank Code	Details
Mobile Money	10001	bank_account must be empty. The field document_id and phone must be sent

{
    "login": "xxxxxxx",
    "pass": "xxxxxxx",
    "external_id": "30000000001",
    "country": "KE",
    "amount": 100,
    "currency": "KES",
    "bank_account": "",
    "bank_code": "10001",
    "phone": "813462324",
    "document_id": "89237423",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

For the full and most up-to-date list of banks and its codes, please check the Cashout Bank Code endpoint.

Bank Codes

Bank	Code
MPesa Kenya	10000