Bank Verification Sync V1.2

Use this API to validate the given bank account number and IFSC. This is a sync verification request.

❗️

Fraud Alert

There have been cases of fraudulent activity where malicious users abuse merchants’ websites/apps by attempting penny-drop verification to the same bank account. We have implemented the necessary checks to prevent these activities in the future and block merchant accounts involved in suspicious activities. You will receive the following message if we detect any fraudulent activity:

Users attempt multiple bank account verification to the same bank account

"subCode": 200,
"accountStatus": "VALID",
"accountStatusCode": "ACCOUNT_IS_VALID",
"message": "High # transactions detected for Account Number '099878736870'"
Users use multiple virtual accounts linked to the same underlying account

"subCode": 422,
"accountStatus": "UNABLE_TO_VALIDATE",
"accountStatusCode": "INVALID_ACCOUNT",
"message": "Fraud activity detected for this account"
Users append leading zeros to bank account number

"subCode": 200,
"accountStatus": "VALID",
"accountStatusCode": "ACCOUNT_IS_VALID",
"message": "High # transactions detected for Account Number '099878736870'"
Users append leading zeros to multiple virtual accounts linked to the same underlying account

"subCode": 422,
"accountStatus": "UNABLE_TO_VALIDATE",
"accountStatusCode": "INVALID_ACCOUNT",
"message": "Fraud activity detected for this account"

Test Data

View the test data and use this information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.


The API returns a response in two cases:

  1. The bank account or IFSC or both are invalid.
  2. The bank account and IFSC combination are verified.
    Additionally, if a request is made again using the same bank account details while the previous request is being processed you will get a response stating that the request is in the process along with the refId.

To fetch the status of such a request you can use the Get Verification Status API, by passing the refId as bvRefId.

👍

Verify Bank Account Details for Free!

You can verify your beneficiary bank account details for free using Free Credits. With this limited-time offer, experience and test the feature without paying any verification charges.

A banner displays the offer for you on the Verification Suite - Bank Account page (Verification Suite Dashboard > Verification Suite - Bank Account). Click Claim Free Credits and instantly redeem the credits to your account.

Bank account verification uses the IMPS network. Verification will return the account status as "VALID" for any valid IFSC of the bank where the account exists. The API also returns city, branch and MICR in the response. However, these are returned on the basis of the IFSC provided. It is possible that the bank account may be linked to a different IFSC in the same bank.

👍

Note:

In a few scenarios, the nameAtBank parameter in the Bank Account Verification API did not return the exact customer name registered with the Bank. We have now fixed this issue, and you will see the exact name registered with the bank.

In some cases, for valid bank accounts if the name at the bank is not available then you will a custom message Bank Account is valid but Name at Bank is unavailable.

Sample Response:

{
“refId”: “250948",
“nameAtBank”: “”,
“bankName”: “JANATA SAHAKARI BANK LIMITED”,
“utr”: “21451863XXXX”,
“city”: “TALEGAON DABHADE”,
“branch”: “TALEGAON DABHADE”,
“micr”: 0,
“nameMatchScore”: “100”,
“accountStatus”: “VALID”,
“accountStatusCode”: “ACCOUNT_IS_VALID”,
“message”: “Bank Account is valid but Name at Bank is unavailable”
}

Click here to view the response codes.

Response Codes

Status - Success

Sub CodeAccount StatusAccount Status CodeMessageBank AccountIFSC
200VALIDACCOUNT_IS_VALIDBank Account details verified successfully026291800001191YESB0000262
200INVALIDINVALID_BANK_ACCOUNTInvalid account number or IFSC provided7766666585146YESB0000001
200INVALIDINVALID_IFSCIFSC is invalid7766667287515ICIC0000001
200INVALIDACCOUNT_BLOCKEDAccount is blocked7766667989884RATN0000070
200INVALIDNRE_ACCOUNTGiven account is an NRE account7766667755761ICIC0000001
200VALIDACCOUNT_IS_VALIDBank Account is valid but Name at Bank is unavailable

Status - Error

Sub CodeAccount StatusAccount Status CodeMessageBank AccountIFSCNamePhone
412UNABLE_TO_VALIDATEINSUFFICIENT_BALANCEInsufficient balance to process this request50101329442375HDFC0000001Any nameAny phone number
422UNABLE_TO_VALIDATEINVALID_ACCOUNTPlease provide a valid bank accountAccount number greater than 30 charactersAny IFSCAny nameAny phone number
422UNABLE_TO_VALIDATEINVALID_IFSCPlease provide a valid IFSC341234218090YESB00000010 (IFSC > 11 characters)Any nameAny phone number
424UNABLE_TO_VALIDATESOURCE_BANK_DECLINEDSource bank declined7766674831270SBIN0000003Any nameAny phone number
424UNABLE_TO_VALIDATEBENEFICIARY_BANK_OFFLINEBeneficiary Bank Offline7766668692253INDB0000018Any nameAny phone number
424UNABLE_TO_VALIDATENPCI_UNAVAILABLENPCI Unavailable7766668458130INDB0000018Any nameAny phone number
424UNABLE_TO_VALIDATEIMPS_MODE_FAILIMPS Mode fail7766667521638ICIC0000001Any nameAny phone number
424UNABLE_TO_VALIDATEFAILED_AT_BANKFailed at bank7766671735852SBIN0000004Any nameAny phone number
520UNABLE_TO_VALIDATEVERIFICATION_FAILEDVerification attempt7766667053392ICIC0000001Any nameAny phone number
422UNABLE_TO_VALIDATEINVALID_NAMEPlease provide a valid NameAny account numberAny IFSCName with special symbolsAny phone number
422UNABLE_TO_VALIDATEINVALID_PHONEPlease provide a valid Phone numberAny account numberAny IFSCAny namePhone with length greater than 12 characters.

📘

Name Match Feature

To manually check if the provided customer name and the name registered at the bank are the same, consumes a lot of time and effort. Cashfree Payments has introduced a new feature that will help you to verify if the names are the same and provide the result accordingly.

Two new parameters, nameMatchResult and nameMatchScore will be available in the response, which will help you make faster validations and process payments successfully. Click here to know more.

Contact your Account Manager or write to [email protected] to activate the name match score feature for your account.

Language
Click Try It! to start a request and see the response here!

Experience the all-new Cashfree Payments Docs! Faster, smarter, and easier to navigate. Check it out here!🎉