Uganda

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

Mandatory parameters - Bank transfers

Mandatory parameterDescriptionFlow type
login32 charsALL
pass32 charsALL
external_idMax. 100 charsALL
beneficiary_nameMax. 50 charsALL
beneficiary_lastnameMax. 50 charsALL
countryUGALL
bank_branchSWIFT code (we accept 8 or 11 alphanumeric characters in upper case)ALL
bank_accountMax. length 18 digitsALL
amountMax. 2 decimal numbersALL
currencyUGX or USDALL
purposeEPREMT - Remittance (C2C)
EPBTOB - Business to Business (B2B)
C2C, B2B
remitter_full_nameMax. 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_documentMax. 45 chars
Mandatory only for remittance (C2C)
C2C
remitter_birth_dateFormat 'YYYYMMDD'
Mandatory only for remittance (C2C)
C2C
remitter_addressMax. 200 chars
Mandatory only for remittance (C2C)
C2C
remitter_cityMax. 40 chars
Mandatory only for remittance (C2C)
C2C
remitter_countryISO 3166-1 alpha-2 code
Mandatory only for remittance (C2C)
C2C
remitter_nationalityISO 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": "UG",
  "amount": "100",
  "currency": "UGX",
  "bank_branch": "UGBAUGKA",
  "bank_account": "045264442334",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Mandatory parameters - Wallet transfers

Mandatory parameterDescriptionFlow type
login32 charsB2C, C2C
pass32 charsB2C, C2C
external_idMax. 100 charsB2C, C2C
beneficiary_nameMax. 50 charsB2C, C2C
beneficiary_lastnameMax. 50 charsB2C, C2C
countryUGB2C, C2C
amountMax. 2 decimal numbersB2C, C2C
account_typePossible options: MTN, AIRTEL, TELCOM, AFRICELLB2C, C2C
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)B2C, C2C
currencyUGXB2C, C2C
purposeEPREMT - Remittance (C2C)
Mandatory only for remittance (C2C)
C2C
remitter_full_nameMax. 200 chars
Mandatory only for remittance (C2C)
C2C
remitter_documentMax. 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_dateFormat 'YYYYMMDD'
Mandatory only for remittance (C2C)
C2C
remitter_addressMax. 200 chars
Mandatory only for remittance (C2C)
C2C
remitter_cityMax. 40 chars
Mandatory only for remittance (C2C)
C2C
remitter_countryISO 3166-1 alpha-2 code
Mandatory only for remittance (C2C)
C2C
remitter_nationalityISO 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": "UG",
  "amount": "100",
  "currency": "UGX",
  "account_type": "AIRTEL",
  "phone": "+256123456789",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}