Request Successfully Initiated

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":"[e-mail]",
                    "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

• Transaction Status API
• Callback Responses
• API Reference