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

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