Payouts via MTN
To make account credits using MTN in Uganda, a request to the Tranzzo API must contain the following parameters:
| Parameter | Type | Required | Description | 
|---|---|---|---|
| pos_id | UUID | ✅ | Merchant's identifier ( POS_ID) | 
| mode | MODE | ✅ | direct | 
| method | METHOD | ✅ | Payment method ( credit) | 
| amount | Number | ✅ | Transaction amount. Must be a positive number. The number of decimal digits must be less than or equal to 2 (e.g., 100.00, 250, 50.50) | 
| currency | CURRENCY | ✅ | UGX | 
| order_3ds_bypass | String | ✅ | 3-D Secure flow option | 
| order_id | String | ✅ | Unique identifier of order | 
| description | String | ✅ | Payment description | 
| payway | String | ✅ | mobile | 
| server_url | URL | Webhook notification will be sent to this URL | |
| result_url | URL | Customer will be redirected to this URL after payment. | |
| customer_fname | String | ✅ | Payer’s first name | 
| customer_lname | String | ✅ | Payer’s last name | 
| customer_phone | String | ✅ | Payer’s phone number | 
| customer_email | String | ✅ | Payer’s email address | 
| properties.instrument_type | String | ✅ | mobile | 
| properties.instrument_method | String | ✅ | MOBILE_MTN | 
Request example:
{
    "pos_id":           "00000000-0000-0000-0000-000000000000",
    "mode":             "direct",
    "amount":           400,
    "method":           "credit",
    "currency":         "UGX",
    "payway":           "mobile",
    "customer_email":   "[email protected]",
    "customer_phone":   "01012345678",
    "customer_fname":   "John",
    "customer_lname":   "Dou",
    "properties":{
        "instrument_type":  "mobile",
        "instrument_method":"MOBILE_MTN"
    },
    "order_3ds_bypass": "supported",
    "description":      "Description",
    "order_id":         "123456789",
    "server_url":       "http://callback-stub:9000/consume",
    "result_url":       "https://google.com"
}