v1

latestOpenAPI 3.1.02026-07-2414704.6 MB

Aadhaar-PAN Linking Status

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.

post/identity/aadhaarPanStatus

Headers

X-Ipay-Auth-Codestring

Auth Code

X-Ipay-Client-Idstring

Unique Client Id Provided by Instantpay

X-Ipay-Client-Secretstring

Unique Client Secret Provided by Instantpay

X-Ipay-Endpoint-Ipstring

End Customer IP Address

Request body

panstring

PAN number of End User

latitudestring

End Customer Latitude.

longitudestring

End Customer Longitude.

externalRefstring

Your Unique Transaction id

consentstring

Consent should be accepted by customer

aadhaarNumberstring

Encrypted Aadhar Number with algorithm aes-256-cbc

Response

200

statuscodestring

{"stackTrail":"paths:/identity/aadhaarPanStatus:post:responses:200:content:application/json:schema:properties:actcode","oasType":"schema","type":"unknown"}

statusstring

timestampstring

ipay_uuidstring

orderidstring

environmentstring

{"stackTrail":"paths:/identity/aadhaarPanStatus:post:responses:200:content:application/json:schema:properties:internalCode","oasType":"schema","type":"unknown"}

Example response

{
  "statuscode": "TXN",
  "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"
}