Streamline your business operations and guarantee GST compliance for your customers with Instantpay's GSTIN Verification API solution. By integrating this feature into your systems, businesses can elevate their due diligence processes and ensure up-to-date records of GST registrations. Access a seamless solution for swift and accurate GST Identification Numbers (GSTIN) verification.
With this API, you will obtain information such as GSTIN Status (Active/Suspended/Canceled), company name, and address, providing a comprehensive insight into the GST compliance status of your clientele. Enhance operational efficiency and minimize risks associated with non-compliance by incorporating Instantpay's GSTIN Verification API solution into your identity verification toolkit.
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
| Name | Type | Mandatory (M) , Optional (O) | Description |
|---|---|---|---|
| gstNumber | String | M | GST Number of Company |
| externalRef | String | M | Your Unique Transaction Id |
| lattitude | String | M | End Customer Latitude. |
| longitude | String | M | End Customer Longitude. |
Sample Request
curl --location --request POST 'https://api.instantpay.in/identity/verifyGstin' \
--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 '{
"gstNumber" : "24DACP2435DZY",
"externalRef" :"123456789",
"latitude" : "25.**41",
"longitude" : "85.**76"
}'
POST /identity/verifyGstin 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
{
"gstNumber" : "24DACP2435DZY",
"externalRef" :"123456789",
"latitude" : "25.**41",
"longitude" : "85.**76"
}
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/Sandbox |
Note :
1- externalRef must be unique and in alpha numeric characters.
2- Latitude and Longitude must be represented in degrees with 4 digits after decimal.
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"pool": {
"referenceId": "1220**********LKPR",
"openingBalance": "16.82",
"paymentAmount": "1.18",
"mode": "DR",
"closingBalance": "15.64"
},
"gstDetails": {
"gstin": "24DACP2435DZY",
"lgnm": "Business Name",
"stj": "State Name",
"ctj": "City Name",
"rgdt": "05/01/2022",
"ctb": "Proprietorship",
"dty": "Regular",
"nba": [
"Supplier of Services",
"Retail Business",
"Wholesale Business"
],
"sts": "Active",
"cxdt": "",
"tradeNam": "Payby Digital Service",
"stjCd": "GJ067",
"ctjCd": "VC0303",
"pradr": {
"addr": {
"bnm": "Sample Address",
"st": "Street Name",
"loc": "Locality",
"bno": "Address",
"stcd": "State Name",
"flno": "Floor Number",
"lt": "",
"lg": "",
"dst": "Surat",
"city": "",
"pncd": "394190"
},
"ntr": "Supplier of Services, Retail Business, Wholesale Business"
},
"adadr": [],
"filingFreq": null,
"lastUpdated": "31/Mar/2022"
}
},
"timestamp": "2022-04-05 14:35:12",
"ipay_uuid": "h00695fd4116-152b-4fd0-864e-22e7c9ce4bbb",
"orderid": "12************KPR",
"environment": "LIVE",
}