POST
/
bank-account
/
async
{
  "reference_id": 123,
  "user_id": "test",
  "account_status": "RECEIVED",
  "account_status_code": "VALIDATION_IN_PROGRESS"
}

Authorizations

x-client-id
string
header
required

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret
string
header
required

Client secret key. You can find your secret key in the Merchant Dashboard.

Body

application/json

Request Body for Async Bank account verification

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.

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.

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.

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.

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.

Response

200 - application/json

Find the response parameter for Bank Account Verification Async V2

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.

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.

reference_id
integer

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

user_id
string

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