post https://api.instantpay.in/identity/verifyPan
Instantpay's PAN Verification API solution provides businesses with a robust solution for authenticating PAN details swiftly and accurately. Integrate this powerful solution into your systems to verify Permanent Account Numbers, ensuring meticulous compliance with regulatory standards.
Along with ascertaining PAN details, it also provides essential additional information such as the last modified date, name on the card, and Aadhaar's seeding status.
Stay ahead of the curve and prioritise precision in identity verification with Instantpay—your trusted partner in creating seamless experience for your business.
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code -1 (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client ID | M | Y |
| X-Ipay-Client-Secret | String | Unique secret key | M | Y |
| X-Ipay-Endpoint-Ip | String | End Customer IP Address | M | N |
Request Parameters
Following are the parameters to be sent in the request body:
| Parameters | Type | Mandatory (M) , Optional (O) | Description |
|---|---|---|---|
| pan | String | M | PAN number of End User |
| latitude | String | M | End customer Latitude. |
| longitude | String | M | End Customer Longitude. |
| externalRef | String | M | Your Unique Transaction id |
| nameOnCard | String | M | Full name as in PAN |
| dateOfBirth | String | M | Date of Birth in YYYY-MM-DD format |
Sample Request
curl --location --request POST 'https://api.instantpay.in/identity/verifyPan' \
--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-raw '{
"pan": "AAOCS6028B",
"nameOnCard": "Sample Name",
"dateOfBirth": "1998-09-08",
"externalRef": "12345",
"latitude": "23.0000",
"longitude": "45.0000"
}
POST /identity/verifyPan HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json
{
"pan": "AAOCS6028B",
"nameOnCard": "TEST",
"dateOfBirth": "1998-09-08",
"externalRef": "12345",
"latitude": "23.0000",
"longitude": "45.0000"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| statuscode | string | InstantPay Status Code |
| actcode | string | Action Code |
| status | string | Status message |
| data | array | Response Data (If Present) |
| timestamp | string | Current 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 |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"poolReferenceId": "1241113141523HLHCS",
"pool": {
"openingBal": "13.17",
"mode": "DR",
"amount": "0.00",
"closingBal": "13.17"
},
"panDetails": {
"name": {
"first": "",
"middle": "",
"last": "",
"full": ""
},
"nameOnCard": "Mohammad Shahbaz Ali",
"status": "VALID",
"panNumber": "XXXXXXX79B",
"gender": null,
"aadhaarSeeding": 1,
"lastModified": "",
"dob": null,
"constitution": "Individual",
"nameVerified": true,
"dateOfBirthVerified": false
}
},
"timestamp": "2024-11-13 14:15:23",
"ipay_uuid": "h0009d7a55e0-a43f-4d84-8642-c16153a30096-mN5wEnWhhtMQ",
"orderid": "1241113141523HLHCS",
"environment": "LIVE",
"internalCode": null
}