Header Parameters

Name	Type	Description	Mandatory (M) , Optional (O)	Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-Code	String	Auth Code is "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	Y

Request Parameters

Parameter Name	Type	Requirement	Description
latitude	String	Mandatory	Location Latitude
longitude	String	Mandatory	Location Longitude
externalRef	String	Mandatory	Unique Transaction id

Sample Request

curl --location 'https://api.instantpay.in/identity/reverseGeocoding' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--data '{
    "latitude":28.5047896,
		"longitude":77.297967,
		"externalRef":"8e8"
 
}'

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

{
    "latitude":28.5047896,
		"longitude":77.297967,
		"externalRef":"8e8"
 
}

Response Parameters

Parameter Name	Type	Description
statuscode	String	Instantpay Status Code
actcode	String	Action Code
status	Array	Status message
data	String	Response Data(if Present)
timestamp	String	Response 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/Sandbox

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "poolReferenceId": "1230919170205EVNBT",
        "pool": {
            "account": "7428585742",
            "openingBal": "98386.66",
            "mode": "DR",
            "amount": "1.18",
            "closingBal": "98385.48"
        },
        "reverseGeocodingDetail": {
            "addressComponents": [
                {
                    "longName": "G73X+X4M",
                    "shortName": "G73X+X4M",
                    "types": [
                        "plus_code"
                    ]
                },
                {
                    "longName": "Block B-1",
                    "shortName": "Block B-1",
                    "types": [
                        "neighborhood",
                        "political"
                    ]
                },
                {
                    "longName": "Block E",
                    "shortName": "Block E",
                    "types": [
                        "political",
                        "sublocality",
                        "sublocality_level_3"
                    ]
                },
                {
                    "longName": "Mohan Cooperative Industrial Estate",
                    "shortName": "Mohan Cooperative Industrial Estate",
                    "types": [
                        "political",
                        "sublocality",
                        "sublocality_level_2"
                    ]
                },
                {
                    "longName": "Badarpur",
                    "shortName": "Badarpur",
                    "types": [
                        "political",
                        "sublocality",
                        "sublocality_level_1"
                    ]
                },
                {
                    "longName": "New Delhi",
                    "shortName": "New Delhi",
                    "types": [
                        "locality",
                        "political"
                    ]
                },
                {
                    "longName": "South East Delhi",
                    "shortName": "South East Delhi",
                    "types": [
                        "administrative_area_level_3",
                        "political"
                    ]
                },
                {
                    "longName": "Delhi Division",
                    "shortName": "Delhi Division",
                    "types": [
                        "administrative_area_level_2",
                        "political"
                    ]
                },
                {
                    "longName": "Delhi",
                    "shortName": "DL",
                    "types": [
                        "administrative_area_level_1",
                        "political"
                    ]
                },
                {
                    "longName": "India",
                    "shortName": "IN",
                    "types": [
                        "country",
                        "political"
                    ]
                },
                {
                    "longName": "110044",
                    "shortName": "110044",
                    "types": [
                        "postal_code"
                    ]
                }
            ],
            "formattedAddress": "G73X+X4M, Block B-1, Block E, Mohan Cooperative Industrial Estate, Badarpur, New Delhi, Delhi 110044, India",
            "geometry": {
                "location": {
                    "lat": 28.5049603,
                    "lng": 77.2978078
                },
                "locationType": "GEOMETRIC_CENTER",
                "viewport": {
                    "northeast": {
                        "lat": 28.50630928029151,
                        "lng": 77.29915678029151
                    },
                    "southwest": {
                        "lat": 28.5036113197085,
                        "lng": 77.29645881970849
                    }
                }
            },
            "placeId": "ChIJZ3CxYVLnDDkRDsf2vBruc24",
            "types": [
                "establishment",
                "food",
                "point_of_interest"
            ]
        }
    },
    "timestamp": "2023-09-19 17:02:05",
    "ipay_uuid": "h0009a2ba92b-13b3-4069-879a-d9ac7f7fdedc-4WDM6nWRP818",
    "orderid": "1230919170205EVNBT",
    "environment": "SANDBOX",
    "internalCode": null
}