post https://api.instantpay.in/identity/verifyVoterId
Boost the integrity of your customer verification process by leveraging Instantpay's Voter ID Verification API solution, which seamlessly verifies Voter ID details using the EPIC Number from Election Commission data. Ensure compliance with regulatory standards, streamline verification processes, and fortify the security of user accounts and transactions. Automate Voter ID verification with Instantpay's API solution to enhance the reliability of your database—a pivotal component in a comprehensive identity verification toolkit.
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 |
|---|---|---|---|
| voterId | String | Mandatory | Voter Id EPIC 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/verifyVoterId' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825' \
--header 'X-Ipay-Endpoint-Ip: 14.142.186.142' \
--header 'Content-Type: application/json' \
--data '{
"voterId":"XXXXXXX78",
"consent":"Y",
"latitude":0.99,
"longitude":38,
"externalRef":"jdnjdi89"
}'
POST /identity/verifyVoterId 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: 120
{
"voterId":"XXXXXXX78",
"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": {
"VoterCardDetail": {
"address": {
"districtCode": 52,
"districtName": "NIWARI",
"districtNameVernacular": "निवाडी",
"state": "Madhya Pradesh",
"stateCode": "S12"
},
"userAge": *5,
"assemblyConstituencyName": "PRITHVIPUR",
"assemblyConstituencyNameVernacular": "पृथ्वीपुर",
"assemblyConstituencyNumber": 4*,
"constituencyPartName": "PRITHVIPUR ",
"constituencyPartNameVernacular": "पृथ्वीपुर",
"constituencyPartNumber": **,
"constituencySectionNumber": 1,
"epicNumber": "XXXXXXX78",
"userGender": "M",
"parliamentaryConstituencyName": "XXXXXXXX",
"parliamentaryConstituencyNameVernacular": "XXXXXX",
"parliamentaryConstituencyNumber": "*",
"pollingBooth": {
"latLong": "XX.21016616,XX.75255656",
"name": "Sample Name",
"nameVernacular": "",
"number":**
},
"relativeNameEnglish": "XXXXRA",
"relativeNameVernacular": "XXजेंद्र",
"relativeRelation": "FTHR",
"serialNumberApplicablePart": **0,
"status": "N",
"userNameEnglish": "XXXit",
"userNameVernacular": "अXXXित",
"voterLastUpdatedDate": "2023-09-14T12:16:59.664+00:00"
},
"pool": {
"referenceId": "1231005102932ZDVQP",
"openingBalance": "47.77",
"paymentAmount": "0.00",
"mode": "DR",
"closingBalance": "47.77"
}
},
"timestamp": "2023-10-05 10:29:32",
"ipay_uuid": "h0069a4b4c88-bc28-498b-9b14-1a126f47b691-0rg0hEqKrhr5",
"orderid": "1231005102932ZDVQP",
"environment": "LIVE",
"internalCode": null
}
Consent Text :
I hereby give my consent and submit voluntarily at my own discretion, my Voter ID for the
purpose of establishing my identity on the portal. The Voter ID submitted herewith shall not be used for
any purpose other than mentioned, or as per the requirements of the law.