post https://api.instantpay.in/identity/corporateEmpCheck
Instantpay's Mobile Number to EPFO (Employee Provident Fund Organisation) UAN (Universal Account Numbers)Verification API solution offers a seamless solution for businesses to verify EPFO UAN number details using mobile numbers.
By integrating this feature, businesses can streamline employee onboarding processes, enhance data accuracy, and ensure compliance with EPFO regulations. Simplify the verification of mobile numbers and UANs to create a more efficient and secure environment for managing employee information.
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 |
|---|---|---|---|
| customerPhoneNumber | String | Mandatory | Mobile Number |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude |
| externalRef | String | Mandatory | Your Unique Transaction id |
| consent | String | Mandatory | Consent should be accepted by customer |
Sample Request
curl --location 'https://api.instantpay.in/identity/corporateEmpCheck' \
--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 '{
"customerPhoneNumber":"7428585742",
"consent":"Y",
"latitude":0.99,
"longitude":38,
"externalRef":"jdnjdi89"
}'
POST /identity/corporateEmpCheck HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 14.142.186.142
Content-Type: application/json
Content-Length: 116
{
"customerPhoneNumber":"7428585742",
"consent":"Y",
"latitude":0.99,
"longitude":38,
"externalRef":"jdnjdi89"
}
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": {
"employeData": {
"personalDetails": {
"userGender": "MALE",
"userDob": "08/09/1998",
"userFullName": "Sample Name",
"userPhoneNumber": "7428585742"
},
"employmentDetails": {
"isEmployed": true,
"dateOfExitMarked": false,
"uanList": [
"101748344546"
],
"uanCount": 1,
"recentEmployerData": {
"memberId": "DSNHP13800300000332",
"establishmentId": "DSNHP13800000",
"dateOfExit": "NA",
"dateOfJoining": "18/10/2021",
"establishmentName": "INSTANTPAY INDIA LIMITED",
"uanNumber": "1017123444546"
},
"previousEmployerData": {
"list": [
{
"sequenceNumber": "1",
"uanNumber": "101748344546",
"dateOfExit": "NA",
"dateOfJoining": "18/10/2021",
"establishmentId": "DSNHP13800120000",
"establishmentName": "INSTANTPAY INDIA LIMITED",
"memberId": "DSNHP13800301000332",
"leaveReason": "NA",
"mobile": "NA",
"aadhaarVerificationStatus": "Verified"
}
]
}
}
},
"pool": {
"referenceId": "1240130150440BSGHU",
"openingBalance": "20.97",
"paymentAmount": "5.90",
"mode": "DR",
"closingBalance": "15.07"
}
},
"timestamp": "2024-01-30 15:04:40",
"ipay_uuid": "h0059b370c0f-3176-417f-b799-518c8638edbc-D2ldwjni01D9",
"orderid": "1240130150440BSGHU",
"environment": "LIVE",
"internalCode": null
}