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
companyName	String	Mandatory	Name of the company

Sample Request

curl --location 'https://api.instantpay.in/identity/company/lookup/cin' \
--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 ' {
    "companyName" : "instan"
}

POST /identity/company/lookup/cin HTTP/1.1
Host: api.instantpay.in
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOQ8l80uxEOrgU6T3Oc4znVc=
X-Ipay-Client-Secret: 9e08574b440f1b4b13d19654cf31aa9b5d0b1effcc80785ded93ea87c5640fa7
X-Ipay-Auth-Code: 1
X-Ipay-Endpoint-Ip: 49.249.72.66
Content-Type: application/json
Content-Length: 49

 {
    "companyName" : "instan"
}

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": [
        {
            "companyID": "U64200DL2010PLC206587",
            "companyName": "INSTANTPAY INDIA LIMITED"
        },
        {
            "companyID": "U65999DL2020PTC360006",
            "companyName": "INSTANTPAY FOREX SERVICES PRIVATE LIMITED"
        }
    ],
    "timestamp": "2023-06-22 17:32:48",
    "ipay_uuid": "h0009978aa92-cbb9-4a31-aad1-a6280eb32c2b",
    "orderid": null,
    "environment": "SANDBOX",
    "internalCode": null
}

200200

400400