Disbursement — Tricsoft Pay Documentation

Overview

Disbursements are asynchronous transactions. Store your reference and wait for a confirmed final status.

Mobile Money disbursements

Use POST {{base_url}}/payments/disburse to send a Mobile Money disbursement through mtn_ug or airtel_ug.

The request body is the same for Personal and Business accounts. Only the Authorization header changes according to the client configured on the Integrations page.

Request fields

Field	Type	Description
provider_code	string	The Mobile Money provider. Use mtn_ug or airtel_ug.
amount	integer	The disbursement amount in whole UGX. For example, 50000 represents UGX 50,000.
customer_phone	string	The recipient's phone number using digits only. It must start with country code 256.
external_id	string	A unique ID generated for this request. Webhooks return it so your application can identify the related disbursement.

Personal account disbursement

Use the Bearer-authenticated paymentGateway configured with the Personal account access token.

const t = await paymentGateway.post("{{base_url}}/payments/disburse", {
  provider_code: "mtn_ug",
  amount: 50000,
  customer_phone: "256700000000",
  external_id: "txn_20260717_003",
});

if (t.status !== 201) throw new Error("Disbursement request failed");

payload, _ := json.Marshal(map[string]any{
    "provider_code": "mtn_ug",
    "amount": 50000,
    "customer_phone": "256700000000",
    "external_id": "txn_20260717_003",
})
req, _ := http.NewRequest(http.MethodPost, "{{base_url}}/payments/disburse", bytes.NewReader(payload))
req.Header.Set("Authorization", "Bearer "+accessToken)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err == nil && resp.StatusCode != http.StatusCreated {
    return fmt.Errorf("unexpected status: %d", resp.StatusCode)
}

let response = reqwest::Client::new()
    .post("{{base_url}}/payments/disburse")
    .bearer_auth(&access_token)
    .json(&serde_json::json!({
        "provider_code": "mtn_ug",
        "amount": 50000,
        "customer_phone": "256700000000",
        "external_id": "txn_20260717_003"
    }))
    .send()
    .await?;

assert_eq!(response.status(), reqwest::StatusCode::CREATED);

String body = """
    {
      "provider_code":"mtn_ug",
      "amount":50000,
      "customer_phone":"256700000000",
      "external_id":"txn_20260717_003"
    }
    """;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("{{base_url}}/payments/disburse"))
    .header("Authorization", "Bearer " + accessToken)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = paymentGateway.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 201) throw new RuntimeException("Disbursement request failed");

using System.Net;
using System.Net.Http.Headers;
using System.Net.Http.Json;

paymentGateway.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", accessToken);
var response = await paymentGateway.PostAsJsonAsync("{{base_url}}/payments/disburse", new
{
    provider_code = "mtn_ug",
    amount = 50000,
    customer_phone = "256700000000",
    external_id = "txn_20260717_003",
});
if (response.StatusCode != HttpStatusCode.Created)
    throw new HttpRequestException("Disbursement request failed");

Business account disbursement

Use the API-key-authenticated paymentGateway configured with the Business account API key ID and secret.

const t = await paymentGateway.post("{{base_url}}/payments/disburse", {
  provider_code: "airtel_ug",
  amount: 50000,
  customer_phone: "256700000000",
  external_id: "txn_20260717_004",
});

if (t.status !== 201) throw new Error("Disbursement request failed");

payload, _ := json.Marshal(map[string]any{
    "provider_code": "airtel_ug",
    "amount": 50000,
    "customer_phone": "256700000000",
    "external_id": "txn_20260717_004",
})
req, _ := http.NewRequest(http.MethodPost, "{{base_url}}/payments/disburse", bytes.NewReader(payload))
req.Header.Set("Authorization", "ApiKey "+apiKeyID+":"+apiSecret)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err == nil && resp.StatusCode != http.StatusCreated {
    return fmt.Errorf("unexpected status: %d", resp.StatusCode)
}

let response = reqwest::Client::new()
    .post("{{base_url}}/payments/disburse")
    .header("Authorization", format!("ApiKey {}:{}", api_key_id, api_secret))
    .json(&serde_json::json!({
        "provider_code": "airtel_ug",
        "amount": 50000,
        "customer_phone": "256700000000",
        "external_id": "txn_20260717_004"
    }))
    .send()
    .await?;

assert_eq!(response.status(), reqwest::StatusCode::CREATED);

String body = """
    {
      "provider_code":"airtel_ug",
      "amount":50000,
      "customer_phone":"256700000000",
      "external_id":"txn_20260717_004"
    }
    """;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("{{base_url}}/payments/disburse"))
    .header("Authorization", "ApiKey " + apiKeyId + ":" + apiSecret)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = paymentGateway.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 201) throw new RuntimeException("Disbursement request failed");

using System.Net;
using System.Net.Http.Json;

paymentGateway.DefaultRequestHeaders.TryAddWithoutValidation(
    "Authorization",
    $"ApiKey {apiKeyId}:{apiSecret}"
);
var response = await paymentGateway.PostAsJsonAsync("{{base_url}}/payments/disburse", new
{
    provider_code = "airtel_ug",
    amount = 50000,
    customer_phone = "256700000000",
    external_id = "txn_20260717_004",
});
if (response.StatusCode != HttpStatusCode.Created)
    throw new HttpRequestException("Disbursement request failed");

Successful request

A successful disbursement request returns HTTP 201 Created. The response includes payment_id; store it so you can retrieve the payment and check its latest status.