Cashfree Payments Developer Documentation

Bulk Bank Account Verification V2

curl --request POST \
  --url https://sandbox.cashfree.com/verification/bank-account/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "bulk_verification_id": "test001",
  "entries": [
    {
      "name": "John Doe",
      "bank_account": "11020001772",
      "ifsc": "HDFC0000001",
      "phone": "9999999999"
    }
  ]
}
'

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

POST

bank-account

bulk

Bulk Bank Account Verification V2

curl --request POST \
  --url https://sandbox.cashfree.com/verification/bank-account/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "bulk_verification_id": "test001",
  "entries": [
    {
      "name": "John Doe",
      "bank_account": "11020001772",
      "ifsc": "HDFC0000001",
      "phone": "9999999999"
    }
  ]
}
'

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

Cashfree does not support the verification of Deutsche Bank and Paytm Payments Bank accounts.
For further queries, please refer to the Bank Account Verification FAQs.

Authorizations

x-client-id

string

header

required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

x-client-secret

string

header

required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

x-cf-signature

string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request parameters to verify bank account information in bulk

bulk_verification_id

string

default:test001

required

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.

Example:

"test001"

entries

object[]

required

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

Show child attributes

entries.bank_account

string

default:test001

required

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

Example:

"test001"

entries.ifsc

string

default:YESB0000001

required

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.

Example:

"YESB0000001"

entries.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.

Example:

"John Doe"

entries.phone

string

default:9999999999

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

Example:

"9999999999"

Example:

[
  {
    "name": "John Doe",
    "bank_account": "11020001772",
    "ifsc": "HDFC0000001",
    "phone": "9999999999"
  }
]

Response

Success response for Bulk Bank Account Verification V2

bulk_reference_id

integer

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

Example:

23

bulk_verification_id

string

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

Example:

"bulk-test-123"

status

string

It displays the status of the verification. Possible values are:

RECEIVED

Example:

"RECEIVED"

Get BAV Status V2 Get Bulk BAV Status V2

⌘I

Secure ID APIs

V2

V1 (Depricated API's)

Bulk Bank Account Verification V2

Authorizations

Headers

Body

Response