post https://api.instantpay.in/identity/verifyEmail
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 |
|---|---|---|---|
| String | Mandatory | Email ID | |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude |
| externalRef | String | Mandatory | Your Unique Transaction id |
Sample Request
curl --location 'https://api.instantpay.in/identity/verifyEmail' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAxxxxxxxxxxxxxGzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 82e4755dxxxxxxxxxxxxx12208df87f3000aa5b56fc926d1' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "[email protected]",
"latitude": "11.1012",
"longitude": "77.9134",
"externalRef": "Abcd1234"
}'
POST /identity/verifyEmail HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYxxxxxxxxxxxx5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 82e4755dxxxxxxxxxxxxxxxx12208df87f3000aa5b56fc926d1
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json
Content-Length: 119
{
"email": "[email protected]",
"latitude": "11.1012",
"longitude": "77.9134",
"externalRef": "Abcd1234"
}
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 |
| internalCode | String | It will be null |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"externalRef": "1735013918",
"poolReferenceId": "1241224041838UPLPL",
"txnReferenceId": "16856103",
"pool": {
"account": "7505684294",
"openingBal": "96273.56",
"mode": "DR",
"amount": "4.72",
"closingBal": "96268.84"
},
"emailDetails": {
"userDefinedRecordId": "1241224041838UPLPL",
"eMail": "[email protected]",
"eName": "",
"emailAge": "",
"emailCreationDays": "",
"domainAge": "1995-08-13T07:00:00Z",
"domainCreationDays": "10725",
"firstVerificationDate": "2024-11-29T09:19:03Z",
"firstSeenDays": "24",
"lastVerificationDate": "2024-12-18T08:49:34Z",
"status": "Verified",
"country": "US",
"fraudRisk": "500 Moderate",
"EAScore": "500",
"EAReason": "Limited History for Email",
"EAStatusID": "2",
"EAReasonID": "8",
"EAAdviceID": "4",
"EAAdvice": "Moderate Fraud Risk",
"EARiskBandID": "3",
"EARiskBand": "Fraud Score 301 to 600",
"sourceIndustry": "",
"fraudType": "",
"lastFlaggedOn": "",
"dob": "",
"gender": "",
"location": "",
"smFriends": "",
"totalHits": "2",
"uniqueHits": "1",
"imageUrl": "",
"emailExists": "Yes",
"domainExists": "Yes",
"company": "",
"title": "",
"domainName": "gmail.com",
"domainCompany": "Google",
"domainCountryName": "United States",
"domainCategory": "Webmail",
"domainCorporate": "No",
"domainRiskLevel": "Moderate",
"domainRelevantInfo": "Valid Webmail Domain from United States",
"domainRiskLevelID": "3",
"domainRelevantInfoID": "508",
"domainRiskCountry": "No",
"smLinks": [],
"phoneStatus": "",
"shipForward": "No",
"overallDigitalIdentityScore": "",
"emailToIpConfidence": "",
"emailToPhoneConfidence": "",
"emailToBillAddressConfidence": "",
"emailToShipAddressConfidence": "",
"emailToFullNameConfidence": "",
"emailToLastNameConfidence": "",
"ipToPhoneConfidence": "",
"ipToBillAddressConfidence": "",
"ipToShipAddressConfidence": "",
"ipToFullNameConfidence": "",
"ipToLastNameConfidence": "",
"phoneToBillAddressConfidence": "",
"phoneToShipAddressConfidence": "",
"phoneToFullNameConfidence": "",
"phoneToLastNameConfidence": "",
"billAddressToFullNameConfidence": "",
"billAddressToLastNameConfidence": "",
"shipAddressToBillAddressConfidence": "",
"shipAddressToFullNameConfidence": "",
"shipAddressToLastNameConfidence": "",
"transAmount": "",
"transCurrency": "",
"trackingId": "",
"custom1": "",
"custom2": "",
"custom3": "",
"custom4": "",
"custom5": "",
"custom6": "",
"custom7": ""
}
},
"timestamp": "2024-12-24 09:48:43",
"ipay_uuid": "h0009dcc70d4-0c55-49b4-bcdd-ed703b8c4afa-pIUloyDSQX5r",
"orderid": "1241224041838UPLPL",
"environment": "SANDBOX",
"internalCode": "Transaction Successful"
}