post https://api.instantpay.in/identity/mobile/vpaLookup
Fetch UPI VPA from mobile number.
Headers Parameter
Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
---|---|---|---|---|
X-Ipay-Auth-Code | String | Auth Code is "1" (Fixed) | M | Y |
X-Ipay-Client-Id | String | Unique Client Id Provided by Instantpay | M | Y |
X-Ipay-Client-Secret | String | Unique Client Secret Provided by Instantpay | M | Y |
X-Ipay-Endpoint-Ip | String | End customer IP Address | M | N |
Request Parameters
Parameter Name | Type | Requirement | Description |
---|---|---|---|
mobileNumber | String | Mandatory | UPI Linked Mobile Number |
externalRef | String | Mandatory | Unique Transaction Id |
consent | String | Mandatory(Y or N) | Consent should be accepted by customer |
latitude | String | Mandatory | End Customer Latitude. |
longitude | String | Mandatory | End Customer longitude. |
Sample Request
curl --location 'https://api.instantpay.in/identity/mobile/vpaLookup' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+xxxxxxxx' \
--header 'X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3xxxxxxxxxxxxxxxx' \
--header 'X-Ipay-Endpoint-Ip: 45.115.105.205' \
--data '{
"mobileNumber": "9876543210",
"consent": "Y",
"externalRef": "1757650497",
"latitude": 72.9999,
"longitude": 38.1223
}'
POST /identity/mobile/vpaLookup HTTP/1.1
Host: api.instantpay.in
Accept: application/json
Content-Type: application/json
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549XXXXXXXXXXX
X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208dXXXXXXXXX
X-Ipay-Endpoint-Ip: 45.115.105.205
Content-Length: 126
{
"mobileNumber": "9876543210",
"consent": "Y",
"externalRef": "1757650544",
"latitude": 72.9999,
"longitude": 38.1223
}
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"vpaData": {
"vpa": "md.shah1234@ybl",
"accountHolderName": "MD SHAHBAZ ALI",
},
"poolReferenceId": "1250919165418QCSDS",
"pool": {
"openingBal": "20.33",
"mode": "DR",
"amount": "3.54",
"closingBal": "16.79"
}
},
"timestamp": "2025-09-19 16:54:18",
"ipay_uuid": "h0009fea2bc7-6b7d-4991-897a-313272a52c58-IyW1rl3JmWwx",
"orderid": "1250919165418QCSDS",
"environment": "LIVE",
"internalCode": null
}
Response Parameter
Parameter 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:II:SS) |
ipay_uuid | String | Request reference number |
orderid | String | Transaction Id(if transaction otherwise it is null) |
environment | String | Live/Sandbox |
internalCode | String | It will be null |