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 supported

Cards

Find all the information about the card supported capabilities.

Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

Mobile Money


Market 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 codecurrency codedocument namedocument formatdocument required?
KEKESNational ID Card8 digitsYes

Cards supported

payment_method_idBrand IDNamepayment_method_typeDetailsAllowed FlowsLogo
CARDVIVisaCARDCredit Card ​DIRECT REDIRECT
CARDVDVisa Debit ​CARDDebit Card ​DIRECT REDIRECT
CARDMCMastercardCARDCredit Card ​DIRECT REDIRECT
CARDMDMastercard Debit ​CARDDebit Card ​DIRECT REDIRECT

ℹ️

To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

payment_method_idNamepayment_method_typeAllowed FlowsLogo
MW / All telecom companies
AN / Airtel
SF / Safaricom
Mobile MoneyWALLETDIRECT


Cards

Capabilities

Visa CreditMastercard CreditVisa DebitMastercard Debit
Minimum amount51 KES51 KES51 KES51 KES
RefundsYesYesYesYes
RecurringYesYesYesYes
Chargeback optionYesYesYesYes
Chargeback Dispute optionYesYesYesYes
DescriptorCan 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. amount51 KES
Max. expiration time supported5 minutes
Notification delayImmediate
RefundsYes
FlowDIRECT
Supported walletsmPesa/Safaricom, Airtel.

UX Flow

Flow might slightly differ depending on the provider.

Alternative flow

Request Parameters

PropertyTypeDescriptionMandatory?
amountNumberAmount to be charged.Yes
currencyStringKES

Transaction currency in ISO 4217.
Yes
countryStringKE

Transaction country in ISO 3166.
Yes
payment_method_idStringMW

ID of the selected payment method
Yes
payment_method_flowStringDIRECTYes
payer.nameStringName of the payer.Yes
payer.emailStringEmail of the payer.Yes
payer.phoneStringPhone number of the payer.Yes
payer.documentNumberDocument of the payer.Yes
order_idNumberID of the capture given by the merchant in their system. Think of it as an external ID of the capture.No
notification_urlStringNotifications 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"
}