post https://sandbox.cashfree.com/verification/bank-account/async
Use this API to verify bank account information. It is an aysnc request. View the test data and use the information to trigger the validations. You can use the test data only in test environments such as gamma and sandbox.
| We do not support Deutsche Bank and Fincare Small Finance Bank currently because they are not live on the IMPS rails. |
|---|
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | VALIDATION_IN_PROGRESS | Use Get BAV Status V2 API to check the status after some time. |
| 200 | SUCCESS | VALIDATION_IN_PROGRESS | Use Get BAV Status V2 API to check the status after some time. |
| 400 | ERROR | name can include a maximum of 100 characters. | Ensure the entered name does not exceed 100 characters. |
| 400 | ERROR | user_id should contain only alphanumeric and underscore characters. | The value for user ID can only contain alphanumeric and underscore ( _ ). |
| 400 | ERROR | name should not include special characters. | Only alphanumeric and white spaces are accepted. |
| 400 | ERROR | phone can include a maximum of 13 characters. | Ensure the value for phone is between 8 and 13 numeric digits. |
| 400 | ERROR | phone should include a minimum of 8 characters. | Ensure the value for phone is between 8 and 13 numeric digits. |
| 400 | ERROR | phone should be numeric. | The value for phone should only contain numeric digits. |
| 400 | ERROR | bank_account is missing in the request. | Ensure you enter a valid bank account information in the request. |
| 400 | ERROR | bank_account can include a maximum of 40 characters. | Ensure the entered bank account information is between 6 and 40 characters. |
| 400 | ERROR | bank_account should include a minimum of 6 characters. | Ensure the entered bank account information is between 6 and 40 characters. |
| 400 | ERROR | bank_account should be alphanumeric. | Ensure the bank account number does not contain any characters apart from alphabets and numerals. |
| 400 | ERROR | ifsc is missing in the request. | Enter a valid IFSC in the request. |
| 400 | ERROR | ifsc should be of 11 characters and 5th character should be 0. | Enter a valid IFSC in the request. |
| 400 | ERROR | user_id can include a maximum of 40 characters. | Ensure the entered value for user ID does not exceed 40 characters. |
| 400 | ERROR | user_id should contain only alphanumeric and underscore characters. | Only alphanumeric and underscore ( _ ) are accepted. |
| 400 | ERROR | user_id already exists. | Enter a unique value for the user ID. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 400 | ERROR | service not enabled for this account. | Contact your account manager or write to us at [email protected] |
| 400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Ensure you enter valid x-client-id and x-client-secret information in the API request. |
| 403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification | Whitelist the IP address. |
| 422 | ERROR | invalid ifsc provided. | Enter a valid IFSC. |
| 422 | ERROR | Fraud activity detected for this account. | - |
| 422 | ERROR | Insufficient balance to process this request. | Try again with sufficient balance. |
| 500 | ERROR | something went wrong | Try again after some time. |