> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.crisscross.money/payout-market-uganda/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.crisscross.money/_mcp/server.

# Uganda Payouts

Use this guide when you want to send UGX payouts to recipients in Uganda. Uganda supports **bank transfers** and **mobile wallets (MTN)**.

## Overview

* **Currency:** UGX
* **Payment location:** `UGA`
* **Supported rails:** Bank transfer, Mobile wallet
* **Payment methods:**
  * Bank transfer → `paymentMethodId: "banktransfer"`, `recipient.type: "bank_account"`
  * Mobile wallet → `paymentMethodId: "mobilemoney"`, `recipient.type: "mobile_money"`

## Required fields by rail

### Bank transfer

| Field               | Required | Notes                |
| ------------------- | -------- | -------------------- |
| `accountNumber`     | Yes      | Bank account number  |
| `bankCode`          | Yes      | Local bank code      |
| `accountHolderName` | Yes      | Name on the account  |
| `country`           | Yes      | `UGA`                |
| `phoneNumber`       | No       | International format |

### Mobile wallet (MTN)

| Field         | Required | Notes                          |
| ------------- | -------- | ------------------------------ |
| `phoneNumber` | Yes      | MSISDN in international format |
| `country`     | Yes      | `UGA`                          |
| `operator`    | Yes      | Use `mtn`                      |
| `name`        | No       | Recipient name                 |

Top-level required fields for every payout: `merchantId`, `merchantReference`, `destinationValue` (with `minorAmount` and `currency`), `paymentMethodId`, `paymentLocation`, `recipient`, `sender` (see [Sender details](#sender-details-required)).

## Sender details (required)

Every payout requires a `sender` object for KYT/KYC screening. `fullName`, `identity`, and `identityNumber` are required; the remaining sender fields are optional but may be required by certain destinations.

| Field            | Required | Notes                                                                                                                           |
| ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `fullName`       | Yes      | Sender's full name                                                                                                              |
| `identity`       | Yes      | Identity document type: `passport`, `nationalId`, `driversLicense`, `residencePermit`, `businessRegistrationNumber`, or `other` |
| `identityNumber` | Yes      | Identity document number                                                                                                        |

See [Create Payout](/api-reference/payouts/payouts/create-payout) for the full sender schema.

## Example requests

### Bank transfer

```json
{
  "merchantId": "your-merchant-id",
  "merchantReference": "PAYOUT-UG-001",
  "destinationValue": {
    "minorAmount": 900000,
    "currency": "UGX"
  },
  "paymentMethodId": "banktransfer",
  "paymentLocation": "UGA",
  "recipient": {
    "type": "bank_account",
    "accountNumber": "0123456789",
    "bankCode": "001",
    "accountHolderName": "Joseph Kato",
    "country": "UGA"
  },
  "sender": {
    "fullName": "Jane Smith",
    "identity": "passport",
    "identityNumber": "A12345678"
  }
}
```

### Mobile wallet (MTN)

```json
{
  "merchantId": "your-merchant-id",
  "merchantReference": "PAYOUT-UG-002",
  "destinationValue": {
    "minorAmount": 400000,
    "currency": "UGX"
  },
  "paymentMethodId": "mobilemoney",
  "paymentLocation": "UGA",
  "recipient": {
    "type": "mobile_money",
    "phoneNumber": "256712345678",
    "country": "UGA",
    "operator": "mtn",
    "name": "Grace Namusoke"
  },
  "sender": {
    "fullName": "Jane Smith",
    "identity": "passport",
    "identityNumber": "A12345678"
  }
}
```

**Note:** UGX has no minor unit — `minorAmount` is the whole-shilling amount (`minorAmount: 900000` = UGX 900,000; no multiplication).

## Related guides

* [Bank Transfers](/payout-bank-transfers)
* [Mobile Wallet](/payout-mobile-wallet)
* [Supported Destinations](/payout-supported-destinations)

> UGX payouts to banks and mobile wallets