BAV V2

Bulk Bank Account Verification V2

Use this API to verify bank account information in bulk. 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	SUCCESS	-
400	ERROR	bulk_verification_id is missing in the request.	Enter a valid bulk verification ID in the request.
400	ERROR	bulk_verification_id can include a maximum of 50 characters.	The value for bulk verification ID cannot exceed a maximum of 50 characters.
400	ERROR	bulk_verification_id can include only alphanum, dot, hyphen and underscores.	Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are accepted.
400	ERROR	name can include a maximum of 100 characters for entry at sequence 10.	Ensure the value for name does not exceed 100 characters.
400	ERROR	name should not include special characters for entry at sequence 10.	The value for name can only include alphanumeric, whitespace ( ), period (.), hyphen (-), slash (/), and ampersand (&) are allowed.
400	ERROR	The maximum number of entries allowed per request is 1000	Ensure the maximum number of entries for this API request does not exceed 100.
400	ERROR	Please provide at least one bank account entry	Ensure you enter at least one bank account entry in the request.
400	ERROR	phone can include a maximum of 13 characters for entry at sequence 10.	Ensure the value for phone is between 8 and 13 numeric digits.
400	ERROR	phone should include a minimum of 8 characters for entry at sequence 10.	Ensure the value for phone is between 8 and 13 numeric digits.
400	ERROR	phone should be numeric for entry at sequence 10.	The value for phone should only contain numeric digits.
400	ERROR	bank_account is missing in the request for entry at sequence 10.	Enter bank account information in the entry.
400	ERROR	bank_account can include a maximum of 40 characters for entry at sequence 10.	Ensure the entered bank account information is between 6 and 40 characters.
400	ERROR	bank_account should include a minimum of 6 characters for entry at sequence 10.	Ensure the entered bank account information is between 6 and 40 characters.
400	ERROR	bank_account should be alphanumeric for entry at sequence 10.	Ensure the bank account number does not contain any characters apart from alphabets and numerals.
400	ERROR	ifsc is missing in the request for entry at sequence 10.	Enter a valid IFSC in the request.
400	ERROR	ifsc should be of 11 characters and 5th character should be 0 for entry at sequence 10.	Enter a valid IFSC in the request.
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.
409	ERROR	bulk_verification_id already exists	Enter a unique bulk verification ID.
500	ERROR	something went wrong	Try again after some time.

POST

bank-account

bulk

{
  "bulk_reference_id": 123,
  "bulk_verification_id": "bulk-test-123",
  "status": "RECEIVED"
}

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 Bulk Bank account verification

bulk_verification_id

string

default: test001required

It is the unique ID you create to identify the API request. The maximum character limit is 50. Alphanumeric, period (.), hyphen (-). and underscore ( _ ) are allowed.

entries

object[]

required

It is the array of bank account information, which needed to be verified

Response

200 - application/json

Find the response parameters for Bulk Bank Account Verification V2

bulk_reference_id

integer

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

bulk_verification_id

string

It displays the unique ID you created to identify the Bulk Bank Account Verification API request.

status

string

It displays the status of the verification.

Was this page helpful?

Get Bulk BAV Status V2 Bank Account Verification Sync V2

{
  "bulk_reference_id": 123,
  "bulk_verification_id": "bulk-test-123",
  "status": "RECEIVED"
}

Secure ID APIs

V2

V1

Bulk Bank Account Verification V2

Response Codes

Authorizations

Body

Response