GET
/
bank-account
{
  "reference_id": 34,
  "name_at_bank": "BHARATHTEST GKUMARUT",
  "bank_name": "YES BANK",
  "city": "MUMBAI",
  "branch": "SANTACRUZ, MUMBAI",
  "micr": 400532038,
  "name_match_score": "90.00",
  "name_match_result": "GOOD_PARTIAL_MATCH",
  "account_status": "VALID",
  "account_status_code": "ACCOUNT_IS_VALID",
  "utr": "404223241811"
}

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.

Query Parameters

reference_id
string

It is unique ID you receive in the response of Bank Account Verification Sync and Async APIs.

user_id
string

It is the unique ID created by you to identify the verification request for async.

Response

200 - application/json

Find the description for each response parameter

account_status
string

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

  • VALID
  • INVALID
  • RECEIVED
  • FAILED
  • REJECTED
  • APPROVAL_PENDING
  • PARTIALLY_APPROVED
  • IN_PROCESS
  • CANCELLED
  • PROCESSING
  • MANUALLY_REJECTED

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:

  • ACCOUNT_IS_VALID
  • FRAUD_ACCOUNT
  • FAILED_AT_BANK
  • NPCI_UNAVAILABLE
  • CONNECTION_TIMEOUT
  • SOURCE_BANK_DECLINED
  • BENE_BANK_DECLINED
  • IMPS_MODE_FAIL
  • BENEFICIARY_BANK_OFFLINE
  • VALIDATION_IN_PROGRESS
  • INVALID_ACCOUNT_FAIL
  • INVALID_IFSC_FAIL
  • VERIFICATION_ALREADY_UNDER_PROCESS
  • NRE_ACCOUNT_FAIL
  • ACCOUNT_BLOCKED
  • INSUFFICIENT_BALANCE

Click here to view the detailed descriptions of each value.

bank_name
string

It displays the name of the bank.

branch
string

It displays the name of the branch where the bank account is registered.

city
string

It displays the name of the city where the bank is located.

micr
integer

It represents the code used to identify banks and branches participating in the Electronic Clearing System (ECS).

name_at_bank
string

It displays the name of the account holder as per the bank records.

name_match_result
string

It displays the result of the name match verification. Possible values are:

  • DIRECT_MATCH
  • GOOD_PARTIAL_MATCH
  • MODERATE_PARTIAL_MATCH
  • POOR_PARTIAL_MATCH
  • NO_MATCH

Click here to view the detailed descriptions of each value.

name_match_score
string

It displays the score of the name match verification.

reference_id
integer

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

utr
string

It displays the unique transaction reference (UTR) number created by the bank to identify the transaction.