Uganda

Learn everything you need to know to make payouts in Uganda with dLocal.

Market specifications

Take a look of all the information you need to make a payout.

Country reference Mandatory paramenters

Payment methods

Find all the information about payment methods capabilities.

Bank transfers Wallet transfers

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 codecurrency codeamount decimalsdocument_type namedocument_id format
UGUGX2Ndaga Muntu- National ID number (NIC)Between 14 to 17 digits

Mandatory parameters

Bank transfers

Bank transfer parametersB2CB2BP2P
loginYesYesYes
passYesYesYes
external_idYesYesYes
beneficiary_nameYesYesYes
beneficiary_lastnameYesYesYes
countryYesYesYes
bank_branchYesYesYes
bank_accountYesYesYes
amountYesYesYes
currencyYesYesYes
purpose-YesYes
remitter_full_name--Yes
remitter_document_type--Yes
remitter_document--Yes
remitter_birth_date--Yes
remitter_address--Yes
remitter_city--Yes
remitter_country--Yes
remitter_nationality--Yes

Wallet transfers

Wallet transfer parametersB2CB2BP2P
loginYesYesYes
passYesYesYes
external_idYesYesYes
beneficiary_nameYesYesYes
beneficiary_lastnameYesYesYes
countryYesYesYes
amountYesYesYes
account_typeYesYesYes
phoneYesYesYes
currencyYesYesYes
purpose--Yes
remitter_full_name--Yes
remitter_document--Yes
remitter_document_type--Yes
remitter_birth_date--Yes
remitter_address--Yes
remitter_city--Yes
remitter_country--Yes
remitter_nationality--Yes

Payment methods

Uganda supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.

Bank transfers

Bank transfers in Uganda require detailed account information, including SWIFT code and account number. The format of these fields depends on the receiving bank, and strict validation rules apply.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Bank transfer parametersDescription
loginAPI authentication credentials. Maximum 32 characters.
passAPI authentication credentials. Maximum 32 characters.
external_idUnique transaction identifier. Maximum 100 characters.
beneficiary_nameFirst name of the beneficiary. Maximum 50 characters.
beneficiary_lastnameLast name of the beneficiary. Maximum 50 characters.
countryCountry code. For Uganda, use UG.
bank_branchSWIFT code (8 or 11 alphanumeric characters in upper case).
bank_accountBank account number. Maximum length 18 digits.
amountPayout amount. Use up to 2 decimal places.
currencyPayout currency. For Uganda, use UGX or USD.
purposeReason for the payout. EPREMT for Remittance (C2C), EPBTOB for Business to Business (B2B).
remitter_full_nameFull name of the sender. Maximum 200 characters. Mandatory only for remittance (C2C).
remitter_document_typeType of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (C2C).
remitter_documentDocument number of the sender. Maximum 45 characters. Mandatory only for remittance (C2C).
remitter_birth_dateSender’s birth date in YYYYMMDD format. Mandatory only for remittance (C2C).
remitter_addressFull address of the sender. Maximum 200 characters. Mandatory only for remittance (C2C).
remitter_cityCity of the sender. Maximum 40 characters. Mandatory only for remittance (C2C).
remitter_countryISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (C2C).
remitter_nationalityISO 3166-1 alpha-2 code of the sender's nationality. Mandatory only for remittance (C2C).

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "Jhon",
  "beneficiary_lastname": "Miles",
  "country": "UG",
  "amount": "100",
  "currency": "UGX",
  "bank_branch": "UGBAUGKA",
  "bank_account": "045264442334",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Wallet transfers

Wallet transfers enable real-time transfers using a mobile phone number linked to a wallet.

The account_type field must indicate the type of wallet being used (e.g., MTN, Airtel, Telcom, Africell). The phone field must be present and correctly formatted.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

Wallet transfer parametersDescription
loginAPI authentication credentials. Maximum 32 characters.
passAPI authentication credentials. Maximum 32 characters.
external_idUnique transaction identifier. Maximum 100 characters.
beneficiary_nameFirst name of the beneficiary. Maximum 50 characters.
beneficiary_lastnameLast name of the beneficiary. Maximum 50 characters.
countryCountry code. For Uganda, use UG.
amountPayout amount. Use up to 2 decimal places.
account_typeType of wallet being used: MTN, AIRTEL, TELCOM, AFRICELL.
phoneMobile phone number. Can be sent either with 9 digits (e.g. 123456789) or with the country code +256 plus 9 digits (e.g. +256123456789).
currencyPayout currency. For Uganda, use UGX.
purposeReason for the payout. EPREMT for Remittance (C2C). Mandatory only for remittance (C2C).
remitter_full_nameFull name of the sender. Maximum 200 characters. Mandatory only for remittance (C2C).
remitter_documentDocument number of the sender. Maximum 45 characters. Mandatory only for remittance (C2C).
remitter_document_typeType of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (C2C).
remitter_birth_dateSender’s birth date in YYYYMMDD format. Mandatory only for remittance (C2C).
remitter_addressFull address of the sender. Maximum 200 characters. Mandatory only for remittance (C2C).
remitter_cityCity of the sender. Maximum 40 characters. Mandatory only for remittance (C2C).
remitter_countryISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (C2C).
remitter_nationalityISO 3166-1 alpha-2 code of the sender's nationality. Mandatory only for remittance (C2C).

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "Jhon",
  "beneficiary_lastname": "Miles",
  "country": "UG",
  "amount": "100",
  "currency": "UGX",
  "account_type": "AIRTEL",
  "phone": "+256123456789",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}