Verify Bank Account

Bank account number verification service which returns the name of the bank account holder by inputting bank account number and IFSC. Works for all IMPS & UPI enabled banks.

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code -1 (Fixed)MY
X-Ipay-Client-IdStringUnique Client IDMY
X-Ipay-Client-SecretStringUnique secret keyMY
X-Ipay-Endpoint-IpStringUnique secret keyMN

Request Parameters

NameTypeMandatory (M) , Optional (O)Description
accountNumberStringMAccount Number of End User
bankIfscStringMIFS Code of Bank
externalRefStringMYour Unique Transaction Id
consentStringMIt will be Y always
pennyDropStringMIt will be YES,NO or AUTO
latitudeStringMEnd Customer Latitude, Represented in
degrees with 4 digits after decimal
longitudeStringMEnd Customer Longitude, Represented in
degrees with 4 digits after decimal

Sample Request for Bank Account Verification

curl --location --request POST 'https://api.instantpay.in/identity/verifyBankAccount' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payee" : {
        "accountNumber" : "XXXXXXXXXXXX",
        "bankIfsc" : "XXXXXXXXX"
    },
    "externalRef" : "1123456789",
    "consent" : "Y",
    "pennyDrop": "YES",
    "latitude" : "20.5936",
    "longitude" : "78.9628"
}'	
POST /identity/verifyBankAccount HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json

{
    "payee" : {
        "accountNumber" : "XXXXXXXXXXXX",
        "bankIfsc" : "XXXXXXXXX"
    },
    "externalRef" : "PPT2",
    "consent" : "Y",
    "pennyDrop": "YES",
    "latitude" : "20.5936",
    "longitude" : "78.9628"
}

📘

Note :

If you have passed pennyDrop YES, It will be verified from Bank(Rs 1 Will be Credited)

If you have passed pennyDrop NO,It will be verified from Bank(Rs 1 will not be Credited)

If you have passed pennyDrop AUTO, It will be verified at Instantpay server and If not found then it will be initiated on penny less i.e Rs 1 will not be Credited

If a Account number is verified again with pennyDrop YES within 24 hours then from the second instance Rs 1 will not be credited to the Bank Account.

In the response If isPennyDrop is true then transaction is initiated on Penny drop if it is false then transaction initiated on penny less.

Response Parameters

NameTypeDescription
statuscodeStringInstantPay Status Code
actcodeStringAction Code
statusStringStatus message
dataArrayResponse Data (If Present)
timestampStringResponse time (YYYY-MM-DD HH:MM:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id ( If transaction otherwise it is null )
environmentStringLive/Sandbox

Sample Response for Bank Account Verification

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "externalRef": "1710478762",
        "poolReferenceId": "1240315102923AFEFN",
        "txnValue": "0.00",
        "txnReferenceId": "407510310584",
        "pool": {
            "account": "9835*****7",
            "openingBal": "20.10",
            "mode": "DR",
            "amount": "0.00",
            "closingBal": "20.10"
        },
        "payer": {
            "account": "9835799007",
            "name": "SHAHBAZ STORE"
        },
        "payee": {
            "name": "PA*** RAJN****",
            "account": "91605634982784",
            "ifsc": "UTIB0000248",
            "type": "",
            "mccCode": "",
            "merchantOnboardingType": "",
            "merchantGenre": "",
            "accountType": "",
            "iin": ""
        },
        "isCached": false,
        "isPennyDrop": false
    },
    "timestamp": "2024-03-15 10:29:24",
    "ipay_uuid": "h0059b912fe7-ac74-49f4-9f25-d9af53d89411-wOLLeQN8MiZ0",
    "orderid": "1240315102923AFEFN",
    "environment": "LIVE",
    "internalCode": null
}

Sandbox Values for Bank Account Verification

You can make test payments using the credentials mentioned below. The deducted amount from the Instantpay wallet will be refunded in T+1 working days as this is a testing transaction. Make sure you entered the correct keys in the request.

Note: For Sandbox, bankIfsc can be any IFS Code.

NameValueResults
accountNumber1111111111Transaction Successful
accountNumber0000000000Transaction Under Process
accountNumberAny ValueTransaction Failed
Language
Click Try It! to start a request and see the response here!