Invalid Payment Details

​

Overview

{
    "success": false,
    "message": "One of the payment details entered is invalid. Please confirm again."
}

​

Common Causes and How to Resolve

1. 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.
2. 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.
3. 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.
4. 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.

​

Additional Resources

• Disbursements.