Kenya
Learn about the dLocal supported payment methods in Kenya.
Market specifications
Take a look of all the payment methods available.
Country reference Cards supported Alternative Payment Method supportedCards
Find all the information about the card supported capabilities.
Capabilities Process Card PaymentsMarket specifications
Do you want to know more information about Kenya's market? Go to the Middle East and Africa: leapfrog straight into local eCommerce article.
Country reference
country code | currency code | document name | document format | document required? |
---|---|---|---|---|
KE | KES | National ID Card | 8 digits | Yes |
Cards supported
payment_method_id | Brand ID | Name | payment_method_type | Details | Allowed Flows | Logo |
---|---|---|---|---|---|---|
CARD | VI | Visa | CARD | Credit Card | DIRECT REDIRECT | |
CARD | VD | Visa Debit | CARD | Debit Card | DIRECT REDIRECT | |
CARD | MC | Mastercard | CARD | Credit Card | DIRECT REDIRECT | |
CARD | MD | Mastercard Debit | CARD | Debit Card | DIRECT REDIRECT |
To offer all the card options that may be available in your integration, send the
payment_method_id
asCARD
.
Alternative Payment Method supported
payment_method_id | Name | payment_method_type | Allowed Flows | Logo |
---|---|---|---|---|
MW / All telecom companies AN / Airtel SF / Safaricom | Mobile Money | WALLET | DIRECT |
Cards
Capabilities
Visa Credit | Mastercard Credit | Visa Debit | Mastercard Debit | |
---|---|---|---|---|
Minimum amount | 51 KES | 51 KES | 51 KES | 51 KES |
Refunds | Yes | Yes | Yes | Yes |
Recurring | Yes | Yes | Yes | Yes |
Chargeback option | Yes | Yes | Yes | Yes |
Chargeback Dispute option | Yes | Yes | Yes | Yes |
Descriptor | Can be personalized, depending on provider. | Can be personalized, depending on provider. | Can be personalized, depending on provider. | Can be personalized, depending on provider. |
How to process Card Payments?
Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.
Alternative Payment Method
Mobile Money
Mobile Money is a widely used payment method in Africa that enables people to send and receive money through their mobile phones. Users need to register for an account, provide identification, and deposit money through authorized agents or channels.
Mobile Money platforms are operated mainly by telecommunications companies and they have enabled financial inclusion by providing banking services to unbanked or underbanked individuals.
Customize payment options
The payment method ID may vary based on the specific user experience you intend to provide.
- Offer all telecom companies. To offer all available telecommunications options, complete
"payment_method_id": "MW"
. - Provide a specific network. To specify a particular telecommunications company, input the corresponding ID. For example, if you intend to utilize the Airtel network, use
"payment_method_id": "AN"
.
Choosing the right network option
To use a specific network feature effectively, make sure to know the user's telecommunications company. If you're unsure, use the generic one to prevent any potential misunderstandings so that all companies are supported.
To find all the available payment options, refer to the Alternative Payment Method supported section.
Capabilities
Mobile Money | |
---|---|
Min. amount | 51 KES |
Max. expiration time supported | 5 minutes |
Notification delay | Immediate |
Refunds | Yes |
Flow | DIRECT |
Supported wallets | mPesa/Safaricom, Airtel. |
UX Flow
Flow might slightly differ depending on the provider.
Alternative flow
Request Parameters
Property | Type | Description | Mandatory? |
---|---|---|---|
amount | Number | Amount to be charged. | Yes |
currency | String | KES Transaction currency in ISO 4217. | Yes |
country | String | KE Transaction country in ISO 3166. | Yes |
payment_method_id | String | MW ID of the selected payment method | Yes |
payment_method_flow | String | DIRECT | Yes |
payer.name | String | Name of the payer. | Yes |
payer.email | String | Email of the payer. | Yes |
payer.phone | String | Phone number of the payer. | Yes |
payer.document | Number | Document of the payer. | Yes |
order_id | Number | ID of the capture given by the merchant in their system. Think of it as an external ID of the capture. | No |
notification_url | String | Notifications will be sent in every change of status of a payment to the notification_url specified by the merchant. | No |
Examples
{
"amount": 1000,
"currency": "KES",
"country": "KE",
"payment_method_id": "MW",
"payment_method_flow": "DIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"phone": "254746488970",
"document": "12345678",
"address": {
"country": "KE",
"state":"Mombasa",
"city": "Mombasa",
"zip_code": "8858",
"street": "Main St.",
"number": "540"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
{
"id": "D-4-a3e6938f-j76s-4855-b84a-e9d50a6d04a0",
"amount": 1000,
"currency": "KES",
"payment_method_id": "MW",
"payment_method_type": "BANK_TRANSFER",
"payment_method_flow": "DIRECT",
"country": "KE",
"bank_transfer": {},
"ticket": {},
"created_date": "2023-01-23T17:20:21.000+0000",
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
"order_id": "34545sk3483kqw0",
"notification_url": "http://merchant.com/notification/new"
}
Updated 9 months ago