Skip to main content
GET
/
payout
/
v1
/
asyncValidation
/
bankDetails
Bank Verification Async
curl --request GET \
  --url https://payout-api.cashfree.com/payout/v1/asyncValidation/bankDetails \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'
{
  "status": "SUCCESSS",
  "subCode": 200,
  "message": "Validation request accepted successfully",
  "data": {
    "bvRefId": 1097292
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

This API will be retired soon. Please plan to migrate to the latest version, Bank Account Verification Async V2.

Headers

​
Authorization
string
required

Bearer Auth Token

​
Content-Type
string
required

application/json

Query Parameters

​
name
string

It is the name of the account holder to be validated. Only alphanumeric and white spaces are accepted. A maximum of 100 characters are allowed.

Example:

"Harshit"

​
phone
string

It is the phone number of the bank account holder.

Example:

"026291800001191"

​
bankAccount
string
required

It is the bank account number to be validated (6 to 40 character limit).

Example:

"YESB0000262"

​
ifsc
string
required

The IFSC information of the bank account to be validated. It should be an 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 numerals.

Example:

"8349102770"

​
remarks
string

You can add custom remarks in the API request. These remarks will be visible in the customer's bank statement corresponding to the penny drop transaction. A maximum of 25 characters are allowed.

Example:

""

​
userId
string

It it the unique ID to identify the bank verification user. Only alphanumeric and underscore (_) are accepted. A maximum of 40 characters are allowed.

Example:

"A1011"

Response

Accepted

​
status
string

It represents the status of the API request.

Example:

"SUCCESSS"

​
subCode
string

It represents the sub code of the API request.

Example:

200

​
message
string

It represents the message of the API request.

Example:

"Validation request accepted successfully"

​
data
object

It contains the bank verification reference ID.