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
Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
---|---|---|---|---|
X-Ipay-Auth-Code | String | Auth Code -1 (Fixed) | M | Y |
X-Ipay-Client-Id | String | Unique Client ID | M | Y |
X-Ipay-Client-Secret | String | Unique secret key | M | Y |
X-Ipay-Endpoint-Ip | String | Unique secret key | M | N |
Request Parameters
Name | Type | Mandatory (M) , Optional (O) | Description |
---|---|---|---|
accountNumber | String | M | Account Number of End User |
bankIfsc | String | M | IFS Code of Bank |
externalRef | String | M | Your Unique Transaction Id |
consent | String | M | It will be Y always |
pennyDrop | String | M | It will be YES,NO or AUTO |
latitude | String | M | End Customer Latitude, Represented in degrees with 4 digits after decimal |
longitude | String | M | End 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
Name | Type | Description |
---|---|---|
statuscode | String | InstantPay Status Code |
actcode | String | Action Code |
status | String | Status message |
data | Array | Response Data (If Present) |
timestamp | String | Response time (YYYY-MM-DD HH:MM:SS) |
ipay_uuid | String | Request reference number |
orderid | String | Transaction Id ( If transaction otherwise it is null ) |
environment | String | Live/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.
Name | Value | Results |
---|---|---|
accountNumber | 1111111111 | Transaction Successful |
accountNumber | 0000000000 | Transaction Under Process |
accountNumber | Any Value | Transaction Failed |