post https://api.instantpay.in/identity/gstinByPan
Verify the linkage between PAN (Permanent Account Number) and GSTIN with Instantpay's PAN to GSTIN Verification API solutions. Businesses can seamlessly integrate this tool to ensure accurate verification of PAN details linked to GST registrations.
Enhance the reliability of your customer database and streamline compliance with GST regulations. Incorporating PAN to GSTIN verification into your identity verification processes can mitigate the risk of errors and non-compliance, creating a more secure and trustworthy business environment.
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 |
| 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/gstinByPan' \
--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 '{
"pan" : "AAOCS6028B",
"latitude" : "27.0001",
"longitude" : "24.0001",
"externalRef" : "afdsfsdgdfgdgf",
"consent" : "Y"
}'
POST /identity/gstinByPan HTTP/1.1
Host: api.instantpay.in
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOQ8l80uxEOrgU6T3Oc4znVc=
X-Ipay-Client-Secret: 9e08574b440f1b4b13d19654cf31aa9b5d0b1effcc80785ded93ea87c5640fa7
X-Ipay-Auth-Code: 1
X-Ipay-Endpoint-Ip: 49.249.72.66
Content-Type: application/json
Content-Length: 150
{
"pan" : "AAOCS6028B",
"latitude" : "27.0001",
"longitude" : "24.0001",
"externalRef" : "afdsfsdgdfgdgf",
"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": {
"gstByPan": [
{
"gstin": "99AAOCS6028BSP",
"status": "ACTIVE",
"stateCode": "",
"stateName": ""
}
],
"pool": {
"referenceId": "1230621152403PQMMB",
"openingBalance": "10.02",
"paymentAmount": "1.18",
"mode": "DR",
"closingBalance": "8.84"
}
},
"timestamp": "2023-06-21 15:24:03",
"ipay_uuid": "h00699767989-56e6-4c05-9e21-0bf9c7bd4656",
"orderid": "1230621152403PQMMB",
"environment": "LIVE",
"internalCode": null
}