IFSC Verification V2
Use this API to verify the provided IFSC information. You will receive the bank name, the branch that it belongs to, the supported transfer modes, and the respective MICR code in the response. 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.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | VALID | - |
| 200 | SUCCESS | NOT_FOUND | - |
| 400 | ERROR | verification_id is missing in the request | Enter a valid verification_id in the request. |
| 400 | ERROR | verification_id can include only alphanum, dot, hyphen, and underscores. | Enter a valid verification ID that includes only alphanumeric, period (.), hyphen (-), and underscore ( _ ). |
| 400 | ERROR | verification_id can include a maximum of 50 characters. | Ensure the verification ID does not exceed more than 50 characters. |
| 400 | ERROR | ifsc is missing in the request. | Enter a valid IFSC information in the request. |
| 400 | ERROR | ifsc should be valid. | Enter a valid IFSC information in the request. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 400 | ERROR | x-client-secret is missing in the request. | Enter all the header information in the API 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. |
| 409 | ERROR | verification id already exists | Enter a unique verification ID. |
| 422 | ERROR | Insufficient balance to process this request | Try again with sufficient balance. |
| 500 | ERROR | something went wrong | Try again after some time. |
| 502 | ERROR | verification attempt failed | 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.
Headers
Send the signature if IP is not whitelisted
Body
Find the request parameters for IFSC Verification V2
It is the unique ID you create to identify the verification request. The maximum character limit is 50. Only alphaumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.
It is the IFSC information of the bank account to be validated. It should be an alphanumeric value of 11 characters. The first 4 characters should be alphabets, the 5th character should be a 0, and the remaining 6 characters should be numerals.
Response
IFSC Verification V2 success response
It displays the unique ID you created to identify the verification ID.
It displays the unique ID created by Cashfree Payments for reference purposes.
It displays the status of the IFSC information.
It displays the name of the bank.
It displays the IFSC information.
It displays the status of NEFT.
It displays the status of IMPS.
It displays the status of RTGS.
It displays the status of UPI.
It displays the status of fund transfer.
It displays the status of card.
It displays the MICR code that can be used to identify the bank.
It displays the National Bank Identification Number (NBIN) information.
It displays the physical address information of the branch.
It displays the city name where the branch is located.
It displays the name of the state where the branch is located.
It displays the name of the branch.
It displays the subcode of the IFSC information.
It displays the category of the bank.
It displays the code that identifies banks and financial institutions worldwide. The code helps pinpoint the specific bank.
Was this page helpful?