post https://api.instantpay.in/identity/verifyPan
PAN verification service which returns the details of a PAN and status by inputting the Permanent Account Number of an individual or a business. Usage is restricted to the guidelines and use-cases defined by the competent authority and subletting it not allowed.
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 |
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" : "AA******8B",
"latitude" : "27.0001",
"longitude" : "24.0001",
"externalRef" : "123456789"
}'
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" : "AA******8B",
"latitude" : "27.0001",
"longitude" : "24.0001",
"externalRef" : "123456789"
}
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": {
"pool": {
"referenceId": "1220**********JSKY",
"openingBalance": "17.82",
"paymentAmount": "0.00",
"mode": "DR",
"closingBalance": "17.82"
},
"panDetails": {
"name": {
"first": "****",
"middle": "*****",
"last": "*****",
"full": "**********"
},
"status": "VALID",
"panNumber": "CJXXXXXX55F",
"gender": null,
"aadhaarSeeding": null,
"lastModified": null,
"dob": null,
"constitution": "Individual"
}
},
"timestamp": "2022-02-16 15:56:47",
"ipay_uuid": "h006959ccf00-ce00-43e6-9583-ebc118a77f82",
"orderid": "1220**********JSKY",
"environment": "LIVE",
"internalCode": null
}