BAV V2

Get Bulk BAV Status V2

Use this API to get the details of the bulk bank account verification request. You need to enter either the bulk reference ID or bulk validation ID. If you want to get the status of a single entry, enter the particular reference ID in the request.

Response Codes

Sub Code	Status	Message	Next Action
200	SUCCESS	VALID	-
400	SUCCESS	Please provide bulk_reference_id or bulk_verification_id	Enter the bulk reference ID or the bulk verification ID in the request.
400	ERROR	bulk_verification_id can include only alphanum, dot, hyphen and underscores.	The value for bulk verification ID can only contain alphaumeric, period (.), hyphen ( - ), and underscore ( _ ).
400	ERROR	bulk_verification_id can include a maximum of 50 characters.	Ensure the bulk verification ID does not exceed 50 characters.
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	bulk_reference_id does not exist.	Enter a valid bulk reference ID in the request.
404	ERROR	bulk_verification_id does not exist.	Enter a valid bulk verification ID in the request.
404	ERROR	reference_id does not exist.	Enter a valid bulk reference ID in the request.
500	ERROR	something went wrong	Try again after some time.

GET

bank-account

bulk

{
  "bulk_verification_id": "test-bulk-123",
  "bulk_reference_id": 1234,
  "entries": [
    {
      "bank_account": 11020001772,
      "ifsc": "HDFC0000001",
      "name": "John Doe",
      "phone": 7709736537,
      "reference_id": 1097293,
      "name_at_bank": "John Doe",
      "account_status": "VALID",
      "account_status_code": "ACCOUNT_IS_VALID",
      "utr": "404223241811",
      "name_match_score": "100",
      "name_match_result": "DIRECT_MATCH"
    }
  ]
}

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.

Query Parameters

bulk_reference_id

integer

default: 1234

It is unique ID you receive in the response of Bulk Bank Account Verification API.

bulk_verification_id

string

default: test-bulk-123

It is the unique ID created to identify the bulk bank validation request.

reference_id

integer

default: 1234

It is unique ID for a single entry you receive in the response of Get status of Bulk Bank Account Verification API.

Response

200 - application/json

Find the description for each response parameter

bulk_reference_id

integer

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

bulk_verification_id

string

It displays the unique ID you created to identify the API request.

entries

object[]

It displays the verified bank account information

Was this page helpful?

Bank Account Verification Async V2 Bulk Bank Account Verification V2

{
  "bulk_verification_id": "test-bulk-123",
  "bulk_reference_id": 1234,
  "entries": [
    {
      "bank_account": 11020001772,
      "ifsc": "HDFC0000001",
      "name": "John Doe",
      "phone": 7709736537,
      "reference_id": 1097293,
      "name_at_bank": "John Doe",
      "account_status": "VALID",
      "account_status_code": "ACCOUNT_IS_VALID",
      "utr": "404223241811",
      "name_match_score": "100",
      "name_match_result": "DIRECT_MATCH"
    }
  ]
}

Secure ID APIs

V2

V1

Get Bulk BAV Status V2

Response Codes

Authorizations

Query Parameters

Response