post https://api.instantpay.in/identity/verifyBankAccount
UPI VPA verification service which returns the name of the bank account holder by inputting VPA. Works for all IMPS & UPI enabled banks.
Request Parameters
Parameters | Type | Mandatory (M) , Optional(O) | Description |
---|---|---|---|
payee | Array | M | Payee details |
payee.accountNumber | String | M | UPI id of the payee |
bankIfsc | String | M | Blank |
externalRef | String | M | Unique Reference number |
consent | String | M | Y - Yes N - No |
pennyDrop | String | M | YES |
latitude | String | M | Current location latitude |
longitude | String | M | Current location longitude |
Sample Request
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" : "ipay.109564@icici",
"bankIfsc" : "0"
},
"externalRef" : "PPT223",
"consent" : "Y",
"isCached": "0",
"latitude" : "21.3436",
"longitude" : "70.8738"
}'
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" : "ipay.109564@icici",
"bankIfsc" : "0"
},
"externalRef" : "PPT223",
"consent" : "Y",
"isCached": "0",
"latitude" : "21.3436",
"longitude" : "70.8738"
}
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 | Current time (YYYY-MM-DD HH:II:SS) |
ipay_uuid | String | Request reference number |
orderid | String | Transaction Id ( If transaction otherwise it is null ) |
environment | String | Live |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"externalRef": "1706608849",
"poolReferenceId": "1240130153049FALDK",
"txnValue": "0.00",
"txnReferenceId": "00",
"pool": {
"account": "7428585742",
"openingBal": "12.89",
"mode": "DR",
"amount": "1.18",
"closingBal": "11.71"
},
"payer": {
"account": "7428585742",
"name": "Instantpay India Limited"
},
"payee": {
"name": "Instantpay India Ltd",
"account": "ipay.105964@icici",
"ifsc": "ICIC0000001",
"type": "ENTITY",
"mccCode": "8931",
"merchantOnboardingType": "",
"merchantGenre": "",
"accountType": "SAVINGS",
"iin": ""
},
"isCached": false,
"isPennyDrop": false
},
"timestamp": "2024-01-30 15:30:50",
"ipay_uuid": "h0059b37156c-3076-4386-8124-80f8d2652282-LB99e7CXARug",
"orderid": "1240130153049FALDK",
"environment": "LIVE",
"internalCode": null
}