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
userFlow	String	Mandatory	SIGNUP/ SIGNIN
latitude	String	Mandatory	End Customer Latitude.
longitude	String	Mandatory	End Customer Longitude.

Sample Request

postman request POST 'https://api.instantpay.in/identity/digiLocker' \
  --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 '{
    "externalRef": "Eugenia",
    "userFlow": "SIGNUP", 
    "redirectionUrl": "https://www.instantpay.in",
    "latitude": "-2.6971",
    "longitude": "-168.6495"
}'

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Success",
    "data": {
        "referenceId": "692d11fa5c461321af0c2b24",
        "url": "https://digilocker.meripehchaan.gov.in/public/oauth2/1/authorize?response_type=code&client_id=CG588133FF&state=6ZNRGW02YVLRZZQ8189590&code_challenge=iT3YRzzReBvRltA5X-wPufW_wsF21VdxG0z_W60a5ss&code_challenge_method=S256&redirect_uri=https%3A%2F%2Fapi.instantpay.in%2Fwebhook%2F1d482482-c9ee-11f0-884b-0a6bb253fa0b&dl_flow=signup&scope=files.issueddocs+userdetails+email+careof+address+picture",
        "status": "PENDING"
    },
    "timestamp": "2025-12-01 09:26:42",
    "ipay_uuid": "h000a07c658e-fd48-4732-8a3a-f46485e52380-VCjknIK9YgFD",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}