BAV V2

Bank Account Verification Async V2

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.

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 care@cashfree.com
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.

POST

bank-account

async

{
  "reference_id": 123,
  "user_id": "test",
  "account_status": "RECEIVED",
  "account_status_code": "VALIDATION_IN_PROGRESS"
}

Authorizations

x-client-id

string

headerrequired

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret

string

headerrequired

Client secret key. You can find your secret key in the Merchant Dashboard.

Body

application/json

Request Body for Async Bank account verification

bank_account

string

default: 026291800001191required

It is the bank account number for verification. It can be an alphanumeric value between 6 and 40 characters.

ifsc

string

default: YESB0000262required

It is the IFSC information of the bank where the bank account is registered. It should be ann 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 numeric digits.

name

string

default: John Doe

It is the name of the bank account holder. When provided, a name match verification is done. Only alphanumeric, whitespace ( ), period (.), hyphen ( - ), slash (/), and ampersand ( & ) are allowed.

user_id

string

default: test

It is the unique ID you create to identify the verification request. You can use this ID to get the status of the verification request in the Get Details API. Only alphanumeric and underscore ( _ ) are allowed.

phone

string

default: 9999999999

It is the phone number of the account holder that is associated with the entered bank account. Only numeric digits betweem 8 and 13 characters are allowed.

Response

200 - application/json

Find the response parameter for Bank Account Verification Async V2

reference_id

integer

It displays the unique ID created by Cashfree Payments for reference purpose.

user_id

string

It displays the user ID created by Cashfree Payments for reference purposes.

account_status

string

It displays the status of the bank account.

account_status_code

string

It displays the status code of the bank account.

Was this page helpful?

Get BAV Status V2 Get Bulk BAV Status V2

{
  "reference_id": 123,
  "user_id": "test",
  "account_status": "RECEIVED",
  "account_status_code": "VALIDATION_IN_PROGRESS"
}

Secure ID APIs

V2

V1

Bank Account Verification Async V2

Response Codes

Authorizations

Body

Response