🇰🇪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

Bank Account Validations

Bank name	Bank code	Format	Example
All	See Bank Codes	Numeric	123456789, 9283749293

Document Validations

Click here to check document types and validations.

Example Request

Bank Transfer

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

Mobile Money

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

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

Bank Codes

Bank	Code
Kenya Commercial Bank KCB	001
Standard Chartered Bank Kenya	002
Absa Bank Kenya	003
Bank Of Baroda	006
Commercial Bank of Africa CBA	007
Central Bank of Kenya	009
Prime Bank Kenya	010
National Bank of Kenya	012
M Oriental Bank Kenya	014
Citi Bank Kenya	016
Habib Bank AG Zurich Kenya	017
Middle East Bank Kenya	018
Bank of Africa Kenya	019
Consolidated Bank of Kenya	023
Credit Bank Kenya	025
Chase Bank Kenya	030
CFC Stanbic Bank Kenya	031
NIC Bank Kenya	041
Bank Of India Kenya	042
Ecobank Kenya	043
Paramount Universal Bank Kenya	050
Jamii Bora Bank	051
Guaranty Trust GT Bank Kenya	053
Victoria Commercial Bank Kenya	054
Guardian Bank Kenya	055
Development Bank of Kenya	059
Housing Finance Company of Kenya	061
Diamond Trust Bank DTB Kenya	063
Equity Bank Kenya	068
Family Bank Kenya	070
Gulf African Bank Kenya	072
First Community Bank Kenya	074
Mobile Money	10001

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