​
Overview

200 - OK: This status code indicates that the request was successfully received, understood, and processed by the server. A response is returned confirming that the process was initiated correctly.

Here is an example of a response after a successful disbursement request:

{
  "success": true,
  "message": "Payment process initiated successfully.",
  "data": {},
  "res": {}
}

​
Next Steps

No further action is required from your side at this stage. Below are the expected next steps based on the type of API request:

​
For Deposits

  • The user should input their token to authorize the transaction.
  • Once the transaction is authorized, you will receive a callback response.
  • Alternatively, you can query the transaction status using the Transaction Status API.

​
For Payouts

  • Await the callback response, which will include the transaction status.
  • Alternatively, you can run the Transaction Status API to check the transaction status.

​
For Authentication

  • The response provided will contain the request body for your api request within the data object.
{
    "success":true,
    "message":"Signature was generated successfully.",
    "data":
        {
            "client_id":"XXxxXX",
            "params":
                {
                    "Airtel":
                        [
                            {"phone_number":"2567xxxxxxxx"}
                        ],
                    "amount":"10000",
                    "city":"CustomerCity",
                    "client_callback_url":"https:\/\/example.com\/callback",
                    "country_id":"7",
                    "currency":"MWK",
                    "email":"johndoe@example.com",
                    "first_name":"JohnDoe",
                    "last_name":"123",
                    "line1":"CustomerStreet",
                    "mobile":"2567xxxxxxxx",
                    "payment_reference":"REF1",
                    "postal_code":"123",
                    "third_party_reference_1":"REF1"
                },
            "salt":"salt_value",
            "sender":"Integration name",
            "timestamp":XXxxXX,
            "signature":"XXxxXX"
        }
}

​
For Account Balance and Transaction Status

  • The response body will contain the transaction details for the transaction status api and the account balance details for the account balance api.

​
Additional Resources