Skip to main content
POST
/
bank-account
/
async
Bank Account Verification Async V2
curl --request POST \
  --url https://sandbox.cashfree.com/verification/bank-account/async \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "bank_account": "026291800001191",
  "ifsc": "YESB0000262",
  "name": "John Doe",
  "user_id": "test",
  "phone": "9999999999"
}'
{
  "reference_id": 123,
  "user_id": "test",
  "account_status": "RECEIVED",
  "account_status_code": "VALIDATION_IN_PROGRESS"
}
  • 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 using the async method

ā€‹
bank_account
string
default:026291800001191
required

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

Example:

"026291800001191"

ā€‹
ifsc
string
default:YESB0000262
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:

"YESB0000262"

ā€‹
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"

ā€‹
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.

Example:

"test"

ā€‹
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.

Example:

"9999999999"

Response

Success response for Bank Account Verification Async V2

ā€‹
reference_id
integer

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

Example:

23

ā€‹
user_id
string

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

Example:

"23"

ā€‹
account_status
string

It displays the status of the bank account. Possible values are:

  • RECEIVED

Click here to view the detailed descriptions of each value.

Example:

"RECEIVED"

ā€‹
account_status_code
string

It displays the status code of the bank account. Possible values are:

  • VALIDATION_IN_PROGRESS

Click here to view the detailed descriptions of each value.

Example:

"VALIDATION_IN_PROGRESS"

āŒ˜I