Get BAV Status V2
Use this API to get the details of the bank account verification request. You need to enter either the reference ID or user ID.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | VALID | - |
| 200 | SUCCESS | INVALID_ACCOUNT_FAIL | - |
| 200 | SUCCESS | NRE_ACCOUNT_FAIL | - |
| 200 | SUCCESS | ACCOUNT_BLOCKED | - |
| 200 | SUCCESS | INVALID_IFSC_FAIL | - |
| 200 | SUCCESS | INSUFFICIENT_BALANCE | - |
| 200 | SUCCESS | FRAUD_ACCOUNT | - |
| 200 | SUCCESS | BAV_BLOCKED | - |
| 200 | SUCCESS | VERIFICATION_ALREADY_UNDER_PROCESS | - |
| 200 | SUCCESS | FAILED_AT_BANK | - |
| 200 | SUCCESS | IMPS_MODE_FAIL | - |
| 200 | SUCCESS | BENE_BANK_DECLINED | - |
| 200 | SUCCESS | CONNECTION_TIMEOUT | - |
| 200 | SUCCESS | NPCI_UNAVAILABLE | - |
| 200 | SUCCESS | SOURCE_BANK_DECLINED | - |
| 200 | SUCCESS | BENEFICIARY_BANK_OFFLINE | - |
| 400 | ERROR | Please provide reference_id or user_id | Enter a valid reference ID or user ID in the request. |
| 400 | ERROR | user_id should contain only alphanumeric and underscore characters. | Only alphanumeric and underscore ( _ ) are accepted. |
| 400 | ERROR | user_id can include a maximum of 40 characters. | Create a user ID that does not exceed 40 characters. |
| 400 | ERROR | reference_id should be a number. | Enter a valid reference ID in the request. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 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. |
| 404 | ERROR | reference_id does not exist. | Enter a valid reference ID in the request. |
| 404 | ERROR | user_id does not exist. | Enter a valid user ID in the request. |
| 500 | ERROR | something went wrong | Try again after some time. |
Authorizations
Client ID. You can find your ID in the Merchant Dashboard.
Client secret key. You can find your secret key in the Merchant Dashboard.
Query Parameters
It is unique ID you receive in the response of Bank Account Verification Sync and Async APIs.
It is the unique ID created by you to identify the verification request for async.
Response
Find the description for each response parameter
It displays the unique ID created by Cashfree Payments for reference purposes.
It displays the name of the account holder as per the bank records.
It displays the name of the bank.
It displays the unique transaction reference (UTR) number created by the bank to identify the transaction.
It displays the name of the city where the bank is located.
It displays the name of the branch where the bank account is registered.
It represents the code used to identify banks and branches participating in the Electronic Clearing System (ECS).
It displays the score of the name match verification.
It displays the result of the name match verification.
It displays the status of the bank account.
It displays the status code of the bank account.
Was this page helpful?