​
Overview

400 - Bad Request: This error occurs when the request payload for disbursements is missing required account details necessary for processing. 
{
    "success": false,
    "message": "Account details are missing."
}

​
Common Causes and How to Resolve

  1. Missing Payment Details: Missing the required payment details for a specific payment method may result in this error. For instance, in a KES till number disbursement, the request payload below would trigger an error because the till number value is missing, even though it is mandatory for this payment method.
{
        "client_id": "XXxxXX",
        "params": {
            "tillnumber": [
                {
                    "till_number": null
                }
            ],
            "amount": "10000",
            "city": "CustomerCity",
            "client_callback_url": "https://example.com",
            "country_id": "1",
            "currency": "KES",
            "email": "johndoe@example.com",
            "first_name": "JohnDoe",
            "last_name": "123",
            "line1": "CustomerStreet",
            "mobile": "2547xxxxxxx0",
            "payment_reference": "REF",
            "postal_code": "123"
        },
        "salt": "salt_value",
        "sender": "integration_name",
        "timestamp": XXxxXX,
        "signature": "XXxxXX"
    }
How To Resolve: Double-check the required fields for the specified payment method in the API reference for disbursements.

​
Best Practices

  • Always Include Required Fields:
    • Verify from the API documentation the list of required account or payment related details before sending a request.
  • Validate Input Fields:
    • Implement validation on the client side to ensure all necessary account details are included before submitting the request to avoid missing fields.
If the issue persists, please contact our team at support@niobi.co.

​
Additional Resources