Headers Parameters

Name	Type	Description	Mandatory (M) , Optional (O)	Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-Code	String	Auth Code- 1 (Fixed)	M	Y
X-Ipay-Client-Id	String	Unique Client ID	M	Y
X-Ipay-Client-Secret	String	Unique Client Secret	M	Y
X-Ipay-Outlet-Id	String	Merchant Unique ID	M	Y
X-Ipay-Endpoint-Ip	String	End Customer IP Address	M	N

Sample Request Parameters

Name	Type	Mandatory (M) , Optional (O)	Description
latitude	String	M	Current location latitude
longitude	String	M	Current location longitude
mobile	String	M	User Mobile no
amount	String	M	Amount to be withdrawn
externalRef	String	M	Unique Transaction Id

Sample Request

curl --location 'https://api.instantpay.in/fi/uatm/generateQr' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: 127.0.0.1' \
--header 'X-Ipay-Outlet-Id: {{outletId}}' \
--header 'Content-Type: application/json' \
--data '{
    "latitude": "28.50937",
    "longitude": "77.29727",
    "mobile" : "7845682531",
    "amount" : "100",
    "externalRef" : "177616676341"
}'

POST /fi/uatm/generateQr 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: 127.0.0.1
X-Ipay-Outlet-Id: {{outletId}}
Content-Type: application/json

{
    "latitude": "28.50937",
    "longitude": "77.29727",
    "mobile": "7845682531",
    "amount": "100",
    "externalRef": "177616676341"
}

Sample Response

Sample Response Parameters

Name	Type	Description
statuscode	String	InstantPay Status Code
actcode	String	Action Code
status	String	Message
data	Array	Response Data (If Present)
timestamp	String	Current 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

❗️
Please Note :
To avoid transaction failures and account suspension, for every merchant you need to pass the unique outlet Id in the headers.

200200

400400