Version 1

get
Bank verification sync

/payout/v1/validation/bankDetails
This API helps you to validate the given bank account number and IFSC. This is a sync verification request. The operation returns a success response in two cases: 1. The bank account or IFSC or both are invalid. 2. The bank account and IFSC combination are verified. Additionally, if a request is made again using the same bank account details while the previous request is already being processed you will get response stating that the request is in process along with the refId. To fetch the status of such request you can use the Get Verification Status API, by passing the refId as bvRefId.
Request
Response
Request
Headers
Authorization
required
string
Bearer auth token
Content-Type
required
string
Application/JSON
Query Parameters
name
required
string
Name of the account holder. (100 character limit)
phone
required
string
Phone number of the account holder
bankAccount
required
string
Bank account to be validated (6 to 40 character limit)
ifsc
required
string
IFSC of the bank account to be validated (standard IFSC format) - length 11, first four bank IFSC and 5th 0
Response
200: OK
{
"status": "SUCCESS",
"subCode": "200",
"message": "Amount Deposited Successfully",
"data": {
"nameAtBank": "John Doe",
"accountExists": "YES",
"amountDeposited": "1.28",
"refId": "123456"
}
}
{
"status": "SUCCESS",
"subCode": "200",
"message": "Invalid ifsc provided",
"data": {
"accountExists": "NO"
}
}
In case of validation being processed
{
"status": "SUCCESS",
"subCode": "202",
"message": "Validation in process check after some time"
"data": {
"refId": "123456"
}
}
422: Unprocessable Entity
{
"status": "ERROR",
"subCode": "422",
"message": "Please provide a valid IFSC code"
}

Response Codes

Status

Sub Code

Message

SUCCESS

200

Amount Deposited Successfully

ERROR

403

Token is not valid

ERROR

403

IP not whitelisted

ERROR

412

Token missing in the request

ERROR

422

Please provide a valid name

ERROR

422

Please provide a valid bank account

ERROR

422

Please provide a valid IFSC code

ERROR

422

Please provide a valid phone number

ERROR

412

Insufficient balance to process this request

ERROR

400

Service temporarily unavailable. Please try again later

ERROR

422

Invalid ifsc provided

ERROR

422

Invalid bank account number or ifsc provided

ERROR

520

Could not verify bank account details

ERROR

520

Something went wrong

ERROR

520

Unknown error occurred

ERROR

520

Validation attempt failed