UGX Mobile money

POST {{env_url}}/pay/aggregators/{{gateway}}/mobilemoney/v2

You can find more information on the Postman link as well as other APIs.

You would need to pass, as header the x-auth-token. This can be obtained from your merchant dashboard → Settings → Generate API keys → Merchant public key.

Headers

Name	Value
Content-Type	application/json
x-auth-token	Your merchant public key

Request Body (encrypted)

Encryption algorithm here

{
    "message": "encrypted-body"
}

Request Body (plain)

{
   "currency": "UGX",
   "amount":"100",
   "paymentType": "woo",
   "sourceCurrency": "UGX",
   "sourceAmount": 100,
   "rate": 100,
   "phone_number": "080344006699",
   "email":"[e-mail]",
   "fullname":"John Doe",
   "tx_ref":"test910-on2007u047e-291076"
}

Response

200

{
    "message": "success",
    "error": null,
    "data": {
        "status": "success",
        "message": "Charge initiated",
        "tx_ref": "test910-on2007u047e-iwmqimenrUMM",
        "data": {
            "amount": 100.0,
            "charged_amount": 100.0,
            "currency": "UGX",
            "status": "pending",
            "customer": {
                "id": 2433975.0,
                "phone_number": "080344006699",
                "name": "John Doe",
                "email": "[e-mail]",
                "created_at": "2024-06-21T13:19:30.000Z"
            }
        }
    }
}

400

{
    "tx_ref": "test910-on2007u047e-291076",
    "data": null,
    "message": "Invalid phone number format",
    "status": "error"
}