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
redirectionUrl	String	Mandatory	Redirection URL after Sign-up/ Sign-in
latitude	String	Mandatory	End Customer Latitude.
longitude	String	Mandatory	End Customer Longitude.

Sample Request

postman request POST 'https://api.instantpay.in/identity/digiLocker/document' \
  --header 'X-Ipay-Auth-Code: 1' \
  --header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
  --header 'X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1' \
  --header 'X-Ipay-Endpoint-Ip: 14.142.186.142' \
  --header 'Content-Type: application/json' \
  --body '{
    "referenceId": "69368e58ac0102180406d47c",
    "documentType": "PAN" 
}'

POST /identity/digiLocker HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 14.142.186.142
Content-Type: application/json
Content-Length: 120

{
   "referenceId": "69368e58ac0102180406d47c",
    "documentType": "PAN" 
}

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Success",
    "data": {
        "pan": "BRQPP5820B",
        "panType": "Individual",
        "nameOnPan": "PRADEEP",
        "gender": "MALE",
        "dob": "02-02-1990",
      "base64File": "JVBERi0xLjcKJeLjz9MKNyAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDEgMCBSIC9MYXN0TW9kaWZpZWQgKEQ6MjAyNTEyMDgxNDA5MzgrMDUnMzAnKSAvUmVzb3VyY2VzIDIgMCBSIC9NZWRpYUJveCBbMC4wMDAwMDAgMC4wMDAwMDAgNTk1LjAwMDAwMCA4NDIuMDAwMDAwXSAvQ3JvcEJveCBbMC4wMDAwMDAgMC4wMDAwMDAgNTk1LjAwMDAwMCA4NDIuMDAwMDAwXSAvQmxlZWRCb3ggWzAuMDAwMDAwIDAuMDAwMDAwIDU5NS4wMDAwMDAgODQyLjAwMDAwMF0gL1RyaW1Cb3ggWzAuMDAwMDAwIDAuMDAwMDAwIDU5NS4wMDAwMDAgODQyLjAwMDAwMF0gL0FydEJveCBbMC4wMDAwMDAgMC4wMDAwMDAgNTk1LjAwMDAwMCA4NDIuMDAwMDAwXSAvQ29udGVudHMgOCAwIFIgL1JvdGF0ZSAwIC9Hcm91cCA8PCAvVHlwZSAvR3JvdXAgL1MgL1RyYW5zcGFyZW5jeSAvQ1MgL0RldmljZVJHQiA+PiAvQW5ub3RzIFsgNiAwIFIgNCAwIFIgXSAvUFogMSA+PgplbmRvYmoKOCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlRGVjb2RlIC9MZW5ndGggMTY4Pj4gc3RyZWFtCnicnVDBCoMwDL37Fe+ol9pWZDtv6kB2UMhNvcxOQRhOGZT9/WKZg137wiMhvJeESJEeJAMWEiVzQtNxMswLcwxOhLhQUFpIB9CAnALpa1ycXjnftIuhnAhb7OVf6h+IqbpKZDPqYPkN9zgqAa3fsU6ZE7irxTFJt4YSWruCDJqwmu19vRvc3qBzlRVoQ2utePVPM4h5Hdso6kDltrz2/wnD2/sBZiphRgplbmwMDAwMCBuIAowMDAwMDc0MTAyIDAwMDAwIG4gCjAwMDAwNzQ0MTAgMDAwMDAgbiAKMDAwMDA3NDM1NCAwMDAwMCBuIAowMDAwMDgyMTY3IDAwMDAwIG4gCjAwMDAwODI3MjcgMDAwMDAgbiAKMDAwMDA4MjMyOSAwMDAwMCBuIAowMDAwMDgyOTQ0IDAwMDAwIG4gCjAwMDAwODMyNTkgMDAwMDAgbiAKMDAwMDA4MzIwOSAwMDAwMCBuIAowMDAwMDg0NTA0IDAwMDAwIG4gCjAwMDAwOTc1MjkgMDAwMDAgbiAKMDAwMDA5Nzc1MyAwMDAwMCBuIAowMDAwMTAyMDY1IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgNDMgL1Jvb3QgNDIgMCBSIC9JbmZvIDQwIDAgUiAvSUQgWyA8MThmMTY1NDEzZDYzZmFiOTg5YTY3ZTRhYzcwZDllYzY+IDwxOGYxNjU0MTNkNjNmYWI5ODlhNjdlNGFjNzBkOWVjNj4gXSA+PgpzdGFydHhyZWYKMTAyNDI0CiUlRU9G"
    },
    "timestamp": "2025-12-08 14:09:39",
    "ipay_uuid": "h000a08adf9f-0e33-4462-981a-a1b00f7510a7-6URq7LqTnJTi",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}