loading...
loading...

How to Pay Contractors and Freelancers in Uganda with Stablecoins

How to Pay Contractors and Freelancers in Uganda with Stablecoins

Finance teams that pay contractors uganda based staff and freelancers need a repeatable way to send money on time. The Bank of Uganda reports that remittance inflows reached US$2.5 billion in 2025, about 3.8% of GDP. Money already moves into Uganda at scale.

Most of that money does not land in a bank account. The same Bank of Uganda data shows mobile money accounts for nearly 61% of remittance receipts, making it the most used digital channel. A payout process that assumes a bank account only ignores how most recipients actually get paid.

This guide is for product, engineering and treasury teams who already pay or plan to pay Ugandan contractors. It covers how payouts to Ugandan contractors work, where cross-border payments usually break, and how a stablecoin-funded float settles to local rails through Yativo.

Why Companies Work with Contractors and Freelancers in Uganda

Uganda’s payment data shows heavy digital usage. The Bank of Uganda’s annual report shows e-money transactions worth UGX 326.3 trillion in the year to June 2025, up 28.6%, across 8.4 billion transactions. Activity on that system reached UGX 1,025.7 trillion in 2025.

MTN’s fintech ecosystem processed 5.0 billion transactions worth UGX 195.5 trillion in 2025, served by 241,100 agents. That agent network is one reason wallet payments reach people far beyond the branch network.

Contractors give you flexibility on scope and duration. They handle their own equipment and working hours.

What Contractors in Uganda Expect from a Payment

Contractors care about three things: the amount in shillings, the speed, and the channel. Get the channel wrong and everything else stops mattering.

Bank transfer in UGX

Bank payout credits the contractor’s bank account in UGX. The money arrives as a normal local credit in shillings. The recipient reconciles it the same way they handle any domestic payment.

Mobile money

Mobile money is the most used digital channel for remittance receipts. MTN Uganda alone reported 14.7 million active MoMo users in 2025. A wallet credit lands where many contractors already keep their day to day money.

Identifiers you need

Collect the recipient’s bank account and mobile money details at onboarding, not on payment day. Confirm them with the contractor in writing. Correct details captured early prevent failed payouts and manual follow up later.

For a deeper look at each channel, see our guide to Uganda bank and mobile money payouts.

The Challenges When You Pay Contractors in Uganda from Abroad

Cost eats small invoices. Sending small amounts across borders costs an average of 6.36% of the amount sent, according to the World Bank. The central bank’s data shows an average remittance of US$152, and over 93% of transfers were below US$499. Contractor invoices often sit in exactly that band, so percentage costs hit hard.

Timing is unpredictable. SWIFT (USD) on gateway 741 settles T+1, the next business day. A missed date damages trust faster than a slightly higher fee.

Channel mismatch. If you pay only to bank accounts, you push contractors into a channel they may not use daily. Offering both bank and mobile money is usually the right answer.

Reconciliation sprawl. When each payment runs through a different provider, your ledger fills with partial references and unclear FX. Treasury then spends month-end matching entries by hand instead of reviewing spend.

How to Pay Contractors in Uganda with Stablecoins on Yativo

Yativo uses stablecoins as a settlement layer, not as the thing your contractor receives. You fund a float balance with USDC or with fiat. Yativo quotes the conversion. A licensed local payout partner pays the contractor in shillings to their bank account or mobile money wallet.

The recipient never needs a crypto wallet and receives a normal local credit in shillings. Your team sees a quote, a status and a reference.

  1. Fund the float. Top up your Yativo balance with USDC or fiat. This is your working balance for contractor runs, so size it against your monthly payout schedule.
  2. Create the payout and get a quote. Enter the recipient, the amount and the destination rail. The quote shows the shilling amount and the rate before you commit anything.
  3. Confirm and send. Once confirmed, Yativo routes the payment to a licensed local payout partner for settlement on the selected rail.
  4. Track and reconcile. Each payout returns a status and reference you can store against the contractor invoice. Batch runs on a fixed date to keep the ledger clean.

Yativo’s active gateways for Uganda cover Local Payout UGX (bank and mobile money), Mobile Money (UG), and SWIFT (USD).

GatewayIDSettlement
Local Payout UGX (bank and mobile money)1269Under 30 minutes
Mobile Money (UG)1326Under 30 minutes
SWIFT (USD)741T+1 (next business day)

These are the active gateways in Yativo’s catalog today. Always read the live list from the payout-methods endpoint before you route a payment.

Your recipient does not need a crypto wallet. They never see or touch stablecoins. On their side, the payment looks like a normal local transfer.

How to Send Stablecoin Payouts to Uganda with Yativo

Option 1: Dashboard (for manual payouts)

  1. Fund your Yativo float balance with either a fiat or a stablecoin deposit, such as USDC.
  2. Go to Transfer in your Yativo dashboard.
  3. Select the float wallet you are paying with, for example USD, EUR, MXN or whichever balance you funded.
  4. Choose the customer you are paying on behalf of. This step is necessary for fintechs that run payouts on behalf of their customers.
  5. Choose Uganda as the destination and Local Payout as the payout method.
  6. Enter the recipient details the payout form asks for, such as the holder’s name, ID, bank account or mobile money number and network.
  7. Enter the amount in USD or UGX.
  8. Review the quote: exchange rate, fees, delivery time and the exact UGX amount your recipient receives.
  9. Confirm with your PIN and 2FA.
  10. Track the payout in real time and download the receipt for your records.

Option 2: API (for automated and bulk payouts)

Every endpoint below is in the Yativo API documentation. Production calls go to https://api.yativo.com/api/v1, and the sandbox runs at https://smtp.yativo.com/api/v1.

Authenticate every request with the X-Api-Key and X-Api-Secret headers. Each key only works from the server IPs listed on it. These keys replaced bearer tokens, as covered in our October update. Every POST also needs a unique Idempotency-Key header.

Step 1. Generate a USDC deposit address on Solana to fund your balance:

POST https://api.yativo.com/api/v1/crypto/create-wallet
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 15f6363b-254c-582e-a8c5-86d068954d05
Content-Type: application/json

{
  "currency": "USDC_SOL"
}

Step 2. List the payout methods available for Uganda:

curl "https://api.yativo.com/api/v1/payment-methods/payout?country=UGA" \
  -H "X-Api-Key: $YATIVO_API_KEY" \
  -H "X-Api-Secret: $YATIVO_API_SECRET" \
  -H "Accept: application/json"

In this example, Local Payout carries gateway ID 1269. Always read the ID from the live response instead of hardcoding it.

Step 3. Fetch the required fields for that gateway:

GET https://api.yativo.com/api/v1/beneficiary/form/show/1269
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET

The response lists every required field and its accepted values. Build your payment_data object from it. For field details, see API documentation.

Step 4. Create the beneficiary. Replace the placeholder with the fields the form returned:

POST https://api.yativo.com/api/v1/beneficiaries/payment-methods/
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 19ee30d3-c773-537c-be81-a7b7068270c0
Content-Type: application/json

{
  "gateway_id": 1269,
  "nickname": "Kampala software team",
  "currency": "UGX",
  "customer_id": "e8caa491-57b6-4c39-9e3a-d2c97e47fbf0",
  "payment_data": {
    "{field_from_form}": "{value}"
  }
}

Step 5. Lock your UGX rate. Quotes hold for 5 minutes:

POST https://api.yativo.com/api/v1/exchange-rate
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: 6255d52f-0d4b-5eee-8709-0c49d81a69ff
Content-Type: application/json

{
  "from_currency": "USD",
  "to_currency": "UGX",
  "method_id": 1269,
  "method_type": "payout",
  "amount": 400
}

Step 6. Initiate the payout from your balance:

POST https://api.yativo.com/api/v1/wallet/payout
X-Api-Key: $YATIVO_API_KEY
X-Api-Secret: $YATIVO_API_SECRET
Idempotency-Key: de142546-7926-5b6b-8ecd-e2b239ac31be
Content-Type: application/json

{
  "debit_wallet": "USD",
  "amount": 400,
  "payment_method_id": 48346,
  "customer_id": "e8caa491-57b6-4c39-9e3a-d2c97e47fbf0",
  "quote_id": "4a72ecf8-6c8a-4e38-9971-8aabe9f785ed"
}

Use the id from the beneficiary response as payment_method_id. For bulk runs, repeat the call per beneficiary, as described on our payouts page.

For the full country picture, read stablecoin payouts to Uganda. For wallet payouts, the Uganda mobile money payouts guide covers that route in detail.

Comparing Ways to Pay Contractors in Uganda

MethodSpeedRecipient experienceCurrencyBest fit
Yativo local payoutUnder 30 minutes on local railsNormal local credit to bank or mobile moneyUGX quoted up frontRecurring contractor runs and mixed bank or wallet recipients
International wireT+1 on SWIFT (USD) gateway 741Local credit after settlementConverted per providerCross-border payments where SWIFT is required
Exchange withdrawalVaries by exchangeRecipient manages conversionRecipient choosesContractors already active on an exchange
Global payroll platformVaries by providerVaries by providerPlatform decidesMixed workforces

Best Practices for Paying Contractors in Uganda

Collect identifiers at onboarding. Capture the bank account or wallet number, the exact registered name and the preferred channel before the first invoice. Reconfirm details whenever a contractor changes them.

Agree the payout currency in the contract. State that payment is made in UGX at the quoted rate, and say who bears the conversion. A clear contract term avoids disputes when a rate moves between invoice and payment.

Batch on a fixed schedule. Run contractor payments on set dates, such as twice a month. Batching keeps your float easier to size and gives contractors a predictable date.

Quote before confirming. Always pull a quote before you commit a run. A quote gives you a number for the ledger before you confirm.

Keep reconciliation records. Store the payout reference, the quote, the rail used and the recipient identifier with each invoice. A stored reference makes month-end matching faster.

Keep classification and tax with your advisors. Contractor classification and tax duties stay with your company and its advisors. Yativo moves money, and those decisions stay with your advisors.

Frequently Asked Questions

How fast do local payouts to Uganda settle?

Local Payout UGX (gateway 1269) and Mobile Money (UG) (gateway 1326) both settle in under 30 minutes. SWIFT (USD) on gateway 741 settles T+1, the next business day.

What are the payout limits for Uganda?

Local Payout UGX (gateway 1269) pays up to UGX 50,000,000 per payout. Mobile Money (UG) (gateway 1326) pays from UGX 5,500 to 5,000,000 per payout.

Which payment channel do Ugandan recipients use most?

The Bank of Uganda found that mobile money accounts for nearly 61% of remittance receipts, making it the most used digital channel. MTN Uganda alone reported 14.7 million active MoMo users in 2025.

How large are most remittances into Uganda?

The central bank’s data shows an average remittance of US$152. Over 93% of transfers were below US$499.

Does my recipient need a crypto wallet?

No. Your recipient gets a normal local credit in their usual account or wallet. They never touch stablecoins, and the payment looks like any other domestic transfer.

Is paying out this way legal and compliant?

Yes, when it runs through regulated infrastructure. Yativo is registered with FinCEN as a Money Services Business, registration number 31000270723339. A licensed local payout partner handles the local leg. Your own tax and reporting duties still apply, so confirm them with your advisor.

How long does a quote last?

Quotes from the exchange-rate endpoint hold for 5 minutes. You see the rate, the fees and the exact amount your recipient gets before you confirm.

Start Paying Contractors in Uganda with Yativo

Paying Ugandan contractors can be simple and predictable. Fund a float with USDC or fiat, quote in shillings, and let a licensed local payout partner settle to bank or mobile money. Contractors receive a normal local credit in shillings. Book a demo to set up your first payout, or contact sales if you already know your monthly volume.

Sources