Take PAN verification to the next level with Instantpay's PAN Verification Plus API. This advanced tool authenticates PAN details and enriches your customer database with additional data points such as address, date of birth, gender, etc, providing a more comprehensive understanding of your clients.
Improve the depth of your due diligence processes by leveraging Instantpay's PAN Verification Plus API solutions, an essential component for businesses seeking a more thorough and detailed approach to identity verification.
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 |
|---|---|---|---|
pan | String | Mandatory | PAN 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 |
Sample Request
curl --location 'https://api.instantpay.in/identity/verifyPanPlus' \
--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 '{
"pan":"AAOCS6028B",
"consent":"Y",
"latitude":0.99,
"longitude":38,
"externalRef":"jdnjdi89"
}'POST /identity/verifyPanPlus 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
{
"pan":"AAOCS6028B",
"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": {
"panPlusData": {
"panNumber": "AAOCS6028B",
"userFullName": "Sample Name",
"userFullNameSplit": [
"Sample",
"",
"Name"
],
"maskedAadhaar": "XXXXXXXX6077",
"userAddress": {
"line1": "0",
"line2": "",
"streetName": "",
"zip": "",
"city": "",
"state": "",
"country": "",
"full": ""
},
"userGender": "M",
"userDob": "25/11/2000",
"aadhaarLinkedStatus": true,
"panType": "Person"
},
"pool": {
"referenceId": "1231214113159AFDYH",
"openingBalance": "11.76",
"paymentAmount": "0.00",
"mode": "DR",
"closingBalance": "11.76"
}
},
"timestamp": "2023-12-14 11:31:59",
"ipay_uuid": "h0059ad833c0-2926-4921-8134-ff0243e5f213-Jti4esNJvo2O",
"orderid": "1231214113159AFDYH",
"environment": "LIVE",
"internalCode": null
}