Header Parameters

Name	Type	Description	Mandatory/ Optional	Provided by Instantpay (Y/N)
X-Ipay-Auth-Code	String	Auth Code:"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
externalRef	String	Mandatory	Your Unique Transaction id
mobile	String	Optional(Enter either aadhaar or mobile )	User's mobile number
aadhaarNumber	String	Optional(Enter either aadhaar or mobile )	User's aadhaar nummber (encrypted in aes-256 format)
latitude	String	Mandatory	End Customer Latitude.
longitude	String	Mandatory	End Customer Longitude.

Sample Request

postman request POST 'https://api.instantpay.in/identity/digiLocker/verifyAccount' \
  --header 'X-Ipay-Auth-Code: 1' \
  --header 'X-Ipay-Client-Id: {{clientId}}' \
  --header 'X-Ipay-Client-Secret: {{clientSecret}}' \
  --header 'X-Ipay-Endpoint-Ip: 14.142.186.142' \
  --header 'Content-Type: application/json' \
  --body '{
    "externalRef" : "Ida",
    "latitude" : "23.1117",
    "longitude" : "-75.9203",
    "mobile" : "7845682533",
    "aadhaarNumber" : "" // enter either aadhaar or PAN parameter

}'

POST /identity/digiLocker/verifyAccount HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: 14.142.186.142
Content-Type: application/json
Content-Length: 120

{
    "externalRef" : "{{$randomFirstName}}",
    "latitude" : "{{$randomLatitude}}",
    "longitude" : "{{$randomLongitude}}",
    "mobile" : "7845682533",
    "aadhaarNumber" : ""

}

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Success",
    "data": {
        "status": "ACCOUNT_EXISTS",
        "digilockerId": "8326bb95-0f01-55c0-b669-a2d69636caa2"
    },
    "timestamp": "2025-12-08 14:10:56",
    "ipay_uuid": "h000a08ae018-2b60-4188-8654-a4172a5b023d-6UZDNJ1NhluK",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}