Quickstart

GST overview

GSTIN is a Goods and Services Tax Identification Number that is assigned to each individual registered under GST. It is a 15-digit unique identification number. GSTIN resolves as follows: The state code is represented by the first two digits of the 15-digit GSTIN. The PAN number for the individual or corporate entity is the following 10 digits. The thirteenth digit is depending on how many times the company has registered under the same PAN within a state.

What is Setu GST API?

With Setu's GSTIN Verification API, you can quickly confirm the GSTIN information of your clients for speedy KYC, vendor onboarding, business loan financing, and insurance needs.

Steps to integrate

1 — Start KYC and business documentation

This is started once Setu’s Sales team has interacted with you and confirmed integration. You will need to add a few KYC details and review some agreements. Please reachout to us via Setu Support to get started here.

2 — Get API credentials

Contact Setu to receive x-client-id and x-client-secret details. These credentials are required to make API calls on Sandbox or Production.

3 — Integrate on Sandbox

The URLs you would need for this API—

• Sandbox—https://dg-sandbox.setu.co
• Production—https://dg.setu.co
• Headers—Contact Setu for providing the credentials required to successfully call Setu APIs. This contains:
  • x-client-id
  • x-client-secret
  • x-product-instance-id

---

Verify GST

Call this API to verify gstin number provided by your customer. The request param are.

• gstin is the gstin value. It may belong to different categories like Company, Trust, Goverment, Firm,_ etc.

While testing on Sandbox, you may use the following sample values—

• Use 27AAICB3918J1CT for a valid GST
• Use 27AAICA3919J1CT for a valid GST with additional address present.
• If you use any other values for gstin, you will get a inavlid gstin response.