post https://api.instantpay.in/identity/aadhaarPanStatus
By calling a single API, verify the linking status between Aadhaar and PAN effortlessly with Instantpay's Aadhaar-PAN Linking Status API solution. This feature aids businesses in ensuring compliance and authenticity while reducing manual efforts and providing a quick and reliable means to confirm the linkage status between an individual's Aadhaar and PAN details.
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 of User |
| aadharNumber | String | Mandatory | Encrypted Aadhar Number with algorithm aes-256-cbc |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude |
| externalRef | String | Mandatory | Your Unique Transaction id |
| consent | Enum (Y/N) | Mandatory | Consent should be accepted by customer |
Sample Request
curl --location 'https://api.instantpay.in/identity/ckyc' \
--header 'X-Ipay-Auth-Code: 2' \
--header 'X-Ipay-Client-Id: wiDLYLyGQc+21HPiah76S/HiAhx8pc2Hmkc9sXb7RDM=' \
--header 'X-Ipay-Client-Secret: a3d33c38bae71eca82bed090a1d0a757280563a2ed732521d20b8b78e2486190' \
--header 'X-Ipay-Endpoint-Ip: 14.142.186.142' \
--header 'X-Ipay-Request-Hash: 123456789|123456789|123456789|123456789|123456789|123456789|1234' \
--header 'X-Ipay-Request-Timestamp: 1659943695791' \
--header 'X-Ipay-Hash-Check: OFF' \
--header 'User-Agent: InstantPayAPITest/1.0.0' \
--header 'Content-Type: application/json' \
--data '{
"aadhaarNumber": " d818RUdRgpNK8LFtFcMI02nRIvRoaL5klCpx+KwFON8=",
"pan": "AAOCS6028B",
"latitude": "27.897394",
"longitude": "78.088013",
"externalRef": "233",
"consent": "Y"
}'
GET /identity/aadhaarPanStatus HTTP/1.1
Host: api.instantpay.in
Content-Type: application/json
Content-Length: 209
{
"aadhaarNumber": " d818RUdRgpNK8LFtFcMI02nRIvRoaL5klCpx+KwFON8=",
"pan": "AAOCS6028B",
"latitude": "27.897394",
"longitude": "78.088013",
"externalRef": "233",
"consent": "Y"
}
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 |
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"poolReferenceId": "1230717111927TMBZR",
"pool": {
"openingBal": "96176.11",
"amount": "1.18",
"closingBal": "96174.93"
},
"linkingStatus": "LINKED",
"linkingDescription": "Your PAN AAXXXXXX8B is already linked to given Aadhaar 72XXXXXXXX63"
},
"timestamp": "2023-07-17 11:19:27",
"ipay_uuid": "h00099aa6fa7-83ab-43fe-934e-28789ae0cae9",
"orderid": "1230717111927TMBZR",
"environment": "SANDBOX",
"internalCode": null
}
Consent Text :
I hereby give my consent and submit voluntarily at my own discretion, my Aadhaar Number or VID for the
purpose of establishing my identity on the portal. The Aadhaar submitted herewith shall not be used for
any purpose other than mentioned, or as per the requirements of the law.