EPFO UAN Verification

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code is "1" (Fixed)MY
X-Ipay-Client-IdStringUnique Client Id Provided by InstantpayMY
X-Ipay-Client-SecretStringUnique Client Secret Provided by InstantpayMY
X-Ipay-Endpoint-IpStringEnd customer IP AddressMY

Request Parameters

Parameter Name

Type

Requirement

Description

uanNumber

String

Mandatory

Customer EPFO UAN 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/verifyUan' \
--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: 14.142.186.142' \
--header 'Content-Type: application/json' \
--data '{
"uanNumber": "101309058",
"consent": "Y",
"externalRef": "1737352942",
"latitude": 0.99,
"longitude": 38
}'
curl --location 'https://api.instantpay.in/identity/verifyUan' \
--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: 14.142.186.142' \
--header 'Content-Type: application/json' \
--data '{
"uanNumber": "101309058",
"consent": "Y",
"externalRef": "1737352942",
"latitude": 0.99,
"longitude": 38
}'

Response Parameters

Parameter NameTypeDescription
statuscodeStringInstantpay Status Code
actcodeStringAction Code
statusArrayStatus message
dataStringResponse Data(if Present)
timestampStringResponse time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id(if transaction otherwise it is null)
environmentStringLive/Sandbox
internalCodeStringIt will be null

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "uanDetails": {
            "personal_details": {
                "userGender": "FEMALE",
                "userDob": "03-01-19XX",
                "userFullName": "ANURXXXX",
                "userPhoneNumber": null
            },
            "employment_details": {
                "isEmployed": true,
                "dateOfExitMarked": false,
                "uanList": [
                    "1013090XXXX"
                ],
                "uanCount": 1,
                "recentEmployerData": {
                    "memberId": "DSNHP13800300001XXXXX",
                    "establishmentId": "DSNHP1380XXXXXX",
                    "dateOfExit": null,
                    "dateOfJoining": "08-10-2024",
                    "establishmentName": "INSTANTPAY INDIA LIMITED",
                    "uanNumber": "1013090XXXXX"
                },
                "previousEmployerData": [
                    {
                        "sequenceNumber": "1",
                        "uanNumber": "1013090XXXX",
                        "dateOfExit": null,
                        "dateOfJoining": "08-10-2XXX",
                        "establishmentId": "DSNHP1380XXXXX",
                        "establishmentName": "INSTANTPAY  INDIA LIMITED",
                        "memberId": "DSNHP13800300001XXXXXX",
                        "leaveReason": null,
                        "mobile": null,
                        "aadhaarVerificationStatus": ""
                    }
                ]
            }
        },
        "poolReferenceId": "1250121105046RHRHR",
        "pool": {
            "openingBal": "5.41",
            "mode": "DR",
            "amount": "0.00",
            "closingBal": "5.41"
        }
    },
    "timestamp": "2025-01-21 10:50:46",
    "ipay_uuid": "h0009e04da96-6c83-427b-abba-2ac8ba5c1f3d-vCkbEcbI3JrE",
    "orderid": "1250121105046RHRHR",
    "environment": "LIVE",
    "internalCode": null
}
Language
Click Try It! to start a request and see the response here!