Market specifications

Do you want to know more information about Uganda's market? Go to the Expand Your Reach in Africa’s eCommerce Market article.

Country reference

`country` code	`currency` code	`amount` decimals	`document` name	`document` format	`document` required?
`UG`	`UGX`	2	Ndaga Muntu- National ID number (NIC)	Between 14 to 17 digits	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`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 as CARD.

Capabilities

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit
Minimum amount	1 UGX	1 UGX	1 UGX	1 UGX
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 supported

`payment_method_id`	Name	`payment_method_type`	Allowed Flows	Logo
`MW` / All telecom companies `AN` / Airtel `MT` / MTN	Mobile Money	`BANK_TRANSFER`	`DIRECT`

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.

Capabilities

	Mobile Money
Max. expiration time supported	Depending on provider
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` and `REDIRECT`
Supported wallets	MTN, Airtel, Africell, M-cash, Payway, Eazy Money and Uganda Telecom.

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	`UGX` Transaction currency in ISO 4217.	Yes
`country`	String	`UG` 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`	String	Document of the payer.	Yes
`order_id`	String	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": "UGX",
    "country": "UG",
    "payment_method_id": "MW",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "phone": "254746488970",
        "document": "123456789012345",
        "address": {
            "country": "UG",
            "state": "Central",
            "city": "Kampala",
            "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-74fb9f36-eced-dd32-4e32-2a77e90de8c6",
    "amount": 1000,
    "currency": "TZS",
    "payment_method_id": "MW",
    "payment_method_type": "BANK_TRANSFER",
    "payment_method_flow": "DIRECT",
    "country": "TZ",
    "bank_transfer": {},
    "ticket": {},
    "created_date": "2023-01-23T19:21:58.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "notification_url": "http://merchant.com/notification/new"
}