Header 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 secret key	M	Y
X-Ipay-Endpoint-Ip	String	End Customer IP Address	M	N

Request Parameters

Name	Type	Mandatory (M) , Optional (O)	Description
latitude	String	M	Current location Latitude
longitude	String	M	Current location Longitude
externalRef	String	M	Your Unique Transaction Id

Sample Request

curl --location 'https://api.instantpay.in/identity/faceLiveness/createSession' \
--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: 49.111.0.1' \
--header 'Content-Type: application/json' \
--data '{
    "latitude": "-33.2442",
    "longitude": "-106.3922",
    "externalRef": "1720521988"
}'

POST /identity/faceLiveness/createSession HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1
X-Ipay-Endpoint-Ip: 49.111.0.1
Content-Type: application/json
Content-Length: 93

{
    "latitude": "-33.2442",
    "longitude": "-106.3922",
    "externalRef": "1720521988"
}

Response Parameters

Name	Type	Description
statuscode	String	InstantPay Status Code
actcode	String	Action Code
status	String	Status 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/Sandbox

📘
Note :
1- externalRef must be unique and in alpha numeric characters.

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Sucesses",
    "data": {
        "sessionId": "fdabfdc0-fba6-41d8-879c-30df24671f05",
        "accessToken": "SVFvSmIzSnBaMmx1WDJWakVHhOdmRYUUFpQlVMdk4xdkdoOW80QkJSak1YcWY0MFhsS21iVnlZK1kwQitEa3Y5UGZpR0FJZ1I5S0NjMnB6c2hZVzFTQWpPa1VOQ3Q0ZmpoM0ZVUE83T1JXeFRjNElsQWNxeUFVSUt4QUFHZ3cyTkRRNE56azJOVGM0T1RRaURKaEgvYTE3RFhITGNIZ05mU3FsQlI5VzJnbW8xQjhGbWdydDZmV2gybVQ1S2EzTmZLblo4Y29BeUJaOVJNaGhpeFBxVnFZOU5SNk1jYXJReDcvSlF1cWJVa1ludHdITlJqRFBPQzk5clNOMm1RSkZSV0d1aVNUUGRROUhQN3JPUDcvVldtMEV4dmVpcGc1Z3pFVVllSlhiN1dyWUtjRUpQckxnd1p5MjlwY255Sk5oRzJKcE5RMWtUUWZLdjJlWGZPb2ljSWNmZzBCdVk3NTVzTmswN3hNbnRRVGtva25RbEhLOFpVcTlFT3IxU0ZTVTEvbHprSVJxc2psR3c1a2JKeVY2eW0rWGQ0YjI3aXRQeFo3bUh0QUgwVkRPcXRoa1ZSb2MxVFhNNERacVZkQUlYeHhTdHVHMWxLZlpQOVM1UWJ6ampGNzhncjBDQTR5SkFMbGdxNkdxUEd3QWpjeUc3VFFwaFM2c3dtNVAxUHpLMHZMQS9aOXB5Nit1QVpENTd6bnMxKy91QSs2REdJSkZCMWZ3eUFCZXJSTWxOenNoc2F3Z25XWmFqSmNCc1FkTXBnQWh3VUw3RWUvMEgwd2ZLQjlPTm15ZUlCcmtiVUd6MG05dDFnS0ZKU05Kb0tvSjRCa25yT05pU1FqcTNLNG5LU0JndVRtZnpXR1FVdWJaajdQUVRqWUtCUDNsZmQyWUJEc1dCcU1ZQzMwaUI4WGxJRWpRSUpNc3dvaW1zTWtvR3k1ZmxsNkp5bTlqUVVKSEVOR3lPekxmRGl4UXRxY3VwQnQ1cExEZzliU2JjTGI1WWJsUStCaVEzREVVUXYreWhKRDFpcW1OQ3EvUUJibEk1bGpiazlybnM5STFhWmtaL0RuMkFjODQybGpWRk1ZempGTzlHK3BoOTNjVVhJcTBOZEVIeC9ieHFjUUhOUVpqVHNuT042L2xBODdhVmp5N21ZMGxrV05EMEV6ZGkyOWFFazBLT1Z4ZjZrdlE3RkZRejNoYjdoQVJ0eWJpdktJM045ZXRqMEpRN1Vleko0ejFpTmlKSVhGbUxvZWlqR1h0SFA5UnRlZkZmQkpubjhKWUg2aUxGNnBCM1JGbkU5ZnAzQU0veXdDaUpheU1lVFp3bHRxUk1xYnJObnEzaFFSVGF1bWthUEZEQ1dtQlZXcUtNNFZKUENWUXZIb3dkVnV6VlVyaVJGL3JpaTZCbm85bGpWeUlwNXJvbW1rSk1JNkh0TFFHT3VFQ2JhNUdSclhnTTV4SW4rN0xrU2tsaTJ5YmFkY1RqRTNISkRVZ0U0MjFzMFlKRlNSZnNCS2ZwdDdoeUo3SGxLSml2Z0NMaXNUMlNraTFZa3dFK3dvZjA0TE9zYUQ2MUdmUGlhUUQ4bU5UTlNNdnR5dEtEcThQZVRpRStZUUxKTEtBYWhzaUh2SjZRY2JwY1J6VVNONW9iR0xlVG9rdGZkSGY2UmVwTHNOb2VGa240QVZYTVd4Vm82TCtrYUpHcjZxemhLTTYya3dhZnQ5VFhvb3kyWlZhODNxcHVhZ3J5bU9FU0FrUktydjQwblpXVmhCOS9JVmhlTE14QjFXQ213UVh0QkVRNVhNZUJFTklVMFRvTWYvRS9oditTRDZHYnJ5bmtvTk1wNWdoaTRSOFE5b1dhaHJOYUd1U0NUTXA1MmVZczgwTXpObmVsR2grVzdGcFhOOWVTVUtUR0RvbmFicTc3eEViVDdaUVJOODlMTEkwbXNBVHNlM0p6UzNwTWsreDJ3MDhZdFo1eE1DMGduVVN3SFBjR3Z5NTF6UVh0MmsrRi9NWHZtL1IxS2JVNm04VzdpeVRCeGpCTDBNNzBic0s4TDJvMzYveGJMMDJTaXYzSTV5SlNJST0jI1BodTVJT3FBNlErSlgraGVnZkIvVjg3cUJ0QUxtTG5RMXpGYm1TUDEjIzVLNkhMTEFHVE9WU09KTVpBSVNB",
        "poolReferenceId": "1240709150158FAKAV",
        "pool": {
            "openingBal": "13.97",
            "mode": "DR",
            "amount": "0.00",
            "closingBal": "13.97"
        }
    },
    "timestamp": "2024-07-09 15:01:58",
    "ipay_uuid": "h0009c7aeb8d-3b0f-4c91-af8f-b59b2b9c8f58-xdPdjB2KKBtl",
    "orderid": "1240709150158FAKAV",
    "environment": "LIVE"
}