Kenya
Learn everything you need to know to make payouts in Kenya with dLocal.
Mandatory parameters - Bank transfers
Mandatory parameter | Description | Flow type |
---|---|---|
login | 32 chars | ALL |
pass | 32 chars | ALL |
external_id | Max. 100 chars | ALL |
beneficiary_name | Max. 50 chars | ALL |
beneficiary_lastname | Max. 50 chars | ALL |
country | KE | ALL |
bank_branch | SWIFT code (we accept 8 or 11 alphanumeric characters in upper case) | ALL |
bank_account | Min. length 8 and Max. length 20 | ALL |
amount | Max. 2 decimal numbers | ALL |
currency | KES or USD | ALL |
purpose | EPREMT - Remittance (C2C) EPBTOB - Business to Business (B2B) | C2C, B2B |
remitter_full_name | Max. 200 chars Mandatory only for remittance (C2C) | C2C |
remitter_document | Max. 45 chars Mandatory only for remittance (C2C) | C2C |
remitter_document_type | 'ID' for national identification number 'PASS' for passport Mandatory only for remittance (C2C) | C2C |
remitter_birth_date | Format 'YYYYMMDD' Mandatory only for remittance (C2C) | C2C |
remitter_address | Max. 200 chars Mandatory only for remittance (C2C) | C2C |
remitter_city | Max. 40 chars Mandatory only for remittance (C2C) | C2C |
remitter_country | ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C) | C2C |
remitter_nationality | ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C) | C2C |
Example request
{
"login":"1n234n56",
"pass":"HolAc123o",
"external_id": "68907654",
"beneficiary_name": "Jhon",
"beneficiary_lastname": "Miles",
"country": "KE",
"amount": "100",
"currency": "KES",
"bank_branch": "BARCKENX",
"bank_account": "433212345678",
"notification_url": "https://thisisawebsite.net/payments",
"type": "json"
}
Mandatory parameters - Wallet transfers
Mandatory parameter | Description | Flow type |
---|---|---|
login | 32 chars | B2C, C2C |
pass | 32 chars | B2C, C2C |
external_id | Max. 100 chars | B2C, C2C |
beneficiary_name | Max. 50 chars | B2C, C2C |
beneficiary_lastname | Max. 50 chars | B2C, C2C |
country | KE | B2C, C2C |
amount | Max. 2 decimal numbers | B2C, C2C |
account_type | Possible options: MPESA, AIRTEL, EQUITEL | B2C, C2C |
phone | +254 + mobile phone number (9 digits) | B2C, C2C |
currency | KES | B2C, C2C |
purpose | EPREMT - Remittance (C2C) Mandatory only for remittance (C2C) | C2C |
remitter_full_name | Max. 200 chars Mandatory only for remittance (C2C) | C2C |
remitter_document_type | 'ID' for national identification number 'PASS' for passport Mandatory only for remittance (C2C) | C2C |
remitter_document | Max. 45 chars Mandatory only for remittance (C2C) | C2C |
remitter_birth_date | Format 'YYYYMMDD' Mandatory only for remittance (C2C) | C2C |
remitter_address | Max. 200 chars Mandatory only for remittance (C2C) | C2C |
remitter_city | Max. 40 chars Mandatory only for remittance (C2C) | C2C |
remitter_country | ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C) | C2C |
remitter_nationality | ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C) | C2C |
Example request
{
"login":"1n234n56",
"pass":"HolAc123o",
"external_id": "68907654",
"beneficiary_name": "Jhon",
"beneficiary_lastname": "Miles",
"country": "KE",
"amount": "1",
"currency": "KES",
"account_type": "MPESA",
"phone": "+294123456789",
"notification_url": "https://thisisawebsite.net/payments",
"type": "json"
}
Updated about 1 month ago