Invalid Payment Details
Overview
400 - Bad Request: This error occurs when one or more payment details provided in the request are invalid in the case of disbursmeents. It is essential to verify and correct the payment details to proceed with the transaction.
Common Causes and How to Resolve
-
Invalid Phone Number: For KES send money payments, passing an incorrect phone number could result in this error.
How to Resolve: You need to ensure the number is in the correct format, with the valid phone length and that it is a valid amd registered number e.g. 2547xx-xxx-xxx.
-
Invalid Account Number or Paybill Number: For KES paybill number payments, passing an incorrect or invalid account number or paybill number could result in this error.
How to Resolve: You need to ensure the paybill and account numbers passed in the request payload are correct and valid. e.g.
account_number: XXXXXX,paybill_number: 1234567890 etc. -
Invalid Till Number: For KES till number payments, passing an incorrect or invalid till number could result in this error.
How to Resolve: Ensure the till number passed in the request payload is correct and valid. e.g.
till_number: 000000. -
Invalid Bank Account Details: For KES pesalink payments, this could occur due to passing incorrect or invalid bank details -
bank_name,bank_code,branch_name,account_name,account_number.How to Resolve: Validate and verify the bank account details provided in the payload and retry once confirmed.
Best Practices
- Validate Payment Details Before Submission:
- Check the payment details for accuracy and verify that they are valid. check the account balance before initiating a transaction to ensure sufficient funds are available. You can use the account balance api here.
- Implement Input Validations:
- You can also add some vlaidation checks for some fields e.g. phone number to ensure your users input the correct and valid details which are pssed in the api request.
If the issue persists, please contact our team at support@niobi.co.