📘
Header Parameters
For Header reference Click here

Request Parameters

Parameter Key	Requirement	Descriptions
mobile	Mandatory	Mobile Number of the merchant (Mobile Number should be same as registered with Aadhaar)
pan	Mandatory	PAN of outlet owner (only individual PAN is allowed)
email	Mandatory	Email Address of the merchant (recommended as in Aadhaar)
aadhaar	Mandatory	Encrypted Aadhar Number with algorithm aes-256-cbc combined with your Encryption Key
latitude	Mandatory	Latitude of the merchant
longitude	Mandatory	Longitude of the merchant
consent	Enum (Y/N)	Consent should be accepted by customer

Sample Request

curl --location --request POST 'https://api.instantpay.in/user/outlet/signup/initiate' \
--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 '{
    "mobile" : "7428585742",
    "email" : "help@instantpay.in",
    "aadhaar": "iVaOiRqmQ15/rnIY+dQbUWihrb7SbJhl+kEIRSb7Q=",
    "pan" : "AAOCS6028B",
    "latitude" : "8.8973",
    "longitude" : "68.0880",
    "consent" : "Y"
}'

POST /user/outlet/signup/initiate 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

{
    "mobile" : "7428585742",
    "email" : "help@instantpay.in",
    "aadhaar": "iVaOiRqmQ15/rnIY+dQbUWihrb7SbJhl+kEIRSb7Q=",
    "pan" : "AAOCS6028B",
    "latitude" : "8.897394",
    "longitude" : "68.088013",
    "consent" : "Y"
}'

📘
Note :
Latitude and Longitude must be represented in degrees with 4 digits after decimal.
Ensure that the accurate latitude and longitude of the merchant's location are provided during onboarding.
For AePS or DMT transactions, the merchant must initiate transactions within a 5 KM radius of the onboarding location. If the transaction is initiated outside this area, it will be declined, or the merchant may be blocked.

📘
Consent Text ;
I hereby give my consent and submit voluntarily at my own discretion, my Aadhaar Number or VID for the
purpose of establishing my identity on the portal. The Aadhaar submitted herewith shall not be used for
any purpose other than mentioned, or as per the requirements of the law.

Response Parameters

Parameter Key	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:MM:SS))
ipay_uuid	String	Request reference number
orderid	String	Transaction Id ( If transaction otherwise it is null )
environment	String	Live/Sandbox

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "aadhaar": "xxxxxxxx9744",
        "otpReferenceID": "ZjA5YmZmOef982h3929hkN2VhNDEz",
        "hash": "5GuAqAiFN9xMs24fRNlUUnhJ0dFs9jd67a2osFsoiZo6JCEIVXnjZTp4l4"
    },
    "timestamp": "2022-05-12 17:35:30",
    "ipay_uuid": "h00596e3bd-4f83-a8bd-7e08dfddb672-e2c7b5b",
    "orderid": "1220424130343AXKFA",
    "environment": "LIVE",
    "internalCode": null

}

📘
Aadhaar Encryption (Sample)
For Aadhaar Encryption Details click here