PAN Verification

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

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code -1 (Fixed)MY
X-Ipay-Client-IdStringUnique Client IDMY
X-Ipay-Client-SecretStringUnique secret keyMY
X-Ipay-Endpoint-IpStringEnd Customer IP AddressMN

Request Parameters

Following are the parameters to be sent in the request body:

ParametersTypeMandatory (M) , Optional (O)Description
panStringMPAN number of End User
latitudeStringMEnd Customer Latitude.
longitude StringMEnd Customer Longitude.
externalRefStringMYour 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

NameTypeDescription
statuscodestringInstantPay Status Code
actcodestringAction Code
statusstringStatus message
dataarrayResponse Data (If Present)
timestampstringCurrent time (YYYY-MM-DD HH:II:SS)
ipay_uuidstringRequest reference number
orderidstringTransaction Id ( If transaction otherwise it is null )
environmentstringLive

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
}
Language
Click Try It! to start a request and see the response here!