GST Invoice QR Code: What It Is and How to Generate One
What the mandatory GST e-invoice QR code is, who needs it, how it's generated through the government's IRP — and how to pair it with a separate SMLLR QR for warranty, support, or reorder.
GST Invoice QR Code: The 30-Second Answer
The GST invoice QR code is a government-generated code that appears on B2B invoices issued by businesses above a turnover threshold, produced automatically as part of the e-invoicing process — it isn't something you generate on SMLLR, Tally, or any third-party tool directly. When your accounting software submits an invoice to the government's Invoice Registration Portal (IRP), the IRP validates it, assigns a unique Invoice Reference Number (IRN), and returns a signed QR code containing key invoice details, which your software then embeds on the printed or PDF invoice.
This guide covers what that mandatory QR code contains, who needs it, and how the process actually works — and separately, how a business can add a second, distinct dynamic QR code to the same invoice for things the government code was never designed to do, like warranty registration or support.
Who Needs the Mandatory GST E-Invoice QR Code
E-invoicing — and the QR code that comes with it — is currently mandatory for GST-registered businesses whose aggregate annual turnover has crossed ₹5 crore in any financial year since FY 2017–18, even if turnover has since dropped below that threshold. It applies only to B2B transactions (invoices issued to other GST-registered businesses); B2C invoices to end consumers don't require IRN generation on the IRP. An invoice above the threshold that lacks a valid IRN and QR code is treated as invalid under GST law, which means the buyer cannot claim Input Tax Credit on it — making this a compliance requirement with a direct financial consequence for both parties, not just a formatting rule.
What's Actually Encoded in the GST Invoice QR Code
The QR code returned by the IRP is a signed, government-issued code — not a generic link — and typically contains:
- Supplier's GSTIN
- Invoice number and invoice date
- Total invoice value
- Number of line items on the invoice
- HSN code of the line item with the highest value
- The Invoice Reference Number (IRN) — a unique 64-character hash generated from the supplier's GSTIN, document type, financial year, and document number
- Date of IRN generation
How the GST Invoice QR Code Is Actually Generated
The QR code isn't something you design or generate directly — it's a byproduct of the e-invoice registration workflow:
- Your accounting or billing software (Tally, Zoho Books, ClearTax, or a similar e-invoicing-enabled tool) prepares the invoice in the government's required JSON schema.
- The software submits that JSON to the IRP, usually through a GST Suvidha Provider (GSP) integration.
- The IRP validates the invoice, checks for duplicates, and generates the IRN along with a digitally signed QR code.
- The IRP returns both to your software, which embeds the QR code and IRN directly onto the invoice PDF or print layout.
- Most GST-compliant billing software in India handles this entire round-trip automatically the moment you finalize an eligible invoice — there's no separate manual QR generation step for the business to perform.
Common Mistakes and Penalties Around the E-Invoice QR Code
The most common failure isn't a technical one — it's businesses assuming an invoice is compliant because it looks like their old format, when their billing software either isn't configured for e-invoicing or silently failed to register the invoice with the IRP. Since an invoice without a valid IRN and QR code is invalid for ITC purposes, this can quietly damage business relationships with buyers who discover they can't claim credit on it. Non-compliance also attracts a direct penalty of ₹10,000 per invoice, separate from any downstream ITC dispute with the buyer.
A Related but Separate Rule: Dynamic QR for B2C Payments
It's worth distinguishing the B2B e-invoice QR code from a separate, older requirement: businesses with turnover above ₹500 crore are additionally required to display a Dynamic QR Code on B2C invoices specifically to facilitate UPI or digital payment by the end consumer at the point of billing. This is a different rule with a different purpose (enabling payment, not tax verification) and a different turnover threshold — the two requirements shouldn't be confused with each other, and most small and mid-size Indian businesses fall under neither at the ₹500 crore B2C threshold even if they're within the ₹5 crore B2B e-invoicing bracket.
Where SMLLR Fits: A Second QR for What the Government Code Can't Do
The IRP-generated QR code exists purely for tax verification — it's static content locked at the moment of invoice generation, meant to be scanned by tax officers or verification tools, not customers. It can't carry a warranty registration link, a support chat, a reorder page, or any marketing destination, and it isn't meant to. SMLLR doesn't replace or modify this government QR code in any way — instead, businesses commonly print a second, separate dynamic QR code on the same invoice, clearly labeled apart from the compliance code, pointing to whatever's useful for that customer relationship: a WhatsApp support chat for delivery issues, a warranty registration form, or a reorder link for consumables.
Design and Placement: Keeping Two QR Codes From Confusing Customers
When an invoice carries both the mandatory IRN QR code and a separate SMLLR marketing or support QR code, clear labeling matters more than clever design.
- Keep the government IRN QR code exactly as your billing software generates it — don't resize, recolor, or reposition it in a way that could affect its scannability for verification purposes.
- Label your SMLLR QR code distinctly — e.g., 'Scan for Order Support' or 'Scan to Register Warranty' — so it's obviously separate from the compliance code beside it.
- Place the two codes with clear visual separation (a divider line or distinct section on the invoice) rather than side by side without labels, which is where customer confusion happens.
- If your invoice template has limited space, prioritize keeping the mandatory IRN QR code fully intact — the second QR code is a value-add, not a requirement, and can be smaller or placed on a separate page or annexure if needed.
Setting Up Your Second QR Code on SMLLR
Adding a support or engagement QR code to your invoice template takes a few minutes: create a URL, WhatsApp, or landing-page QR code on smllr.app pointing to whatever destination fits your invoice — a support chat, a warranty form, or a reorder page — customize it with Level Q or H error correction so it stays scannable at typical invoice print sizes, and drop the downloaded SVG or PNG into your invoice template alongside (not on top of) the government-generated IRN QR code. SMLLR's Basic plan (₹499/month, 10 QR codes) covers this for most small businesses, scaling to ₹999/month (Pro, 50 QR codes) and ₹1,999/month (Premium, 150 QR codes with white-label and API access) — all billed in INR with a GST invoice, and a 14-day free trial on every tier.
Related Reading
Frequently Asked Questions
Can I generate a GST invoice QR code using SMLLR or another third-party tool?
No. The mandatory GST e-invoice QR code is generated exclusively by the government's Invoice Registration Portal (IRP) as part of the e-invoice authentication process, based on invoice data submitted through GST-compliant billing software. No third-party tool, including SMLLR, generates or replaces this code.
Who is required to have a GST invoice QR code on their invoices?
Businesses whose aggregate annual turnover has exceeded ₹5 crore in any financial year since FY 2017–18 must generate e-invoices (and their accompanying QR code and IRN) for B2B transactions. B2C invoices don't require this.
What information does the GST invoice QR code contain?
It encodes the supplier's GSTIN, invoice number and date, total invoice value, line item count, the highest-value item's HSN code, the Invoice Reference Number (IRN), and the IRN generation date — all digitally signed by the IRP.
What happens if my invoice is missing a valid GST QR code and IRN?
The invoice is treated as invalid under GST law. The buyer cannot claim Input Tax Credit on it, and the issuing business can face a penalty of ₹10,000 per non-compliant invoice.
Is the GST e-invoice QR code the same as the Dynamic QR Code required for B2C payments?
No. They're separate rules. The e-invoice QR code (₹5 crore B2B threshold) exists for tax verification. The Dynamic QR Code for B2C invoices (₹500 crore threshold) exists to let end consumers pay via UPI at the point of billing. Most small and mid-size businesses fall under only the first, if either.
Can I add my own QR code to an invoice that already has a mandatory GST QR code?
Yes. Many businesses print a second, clearly labeled dynamic QR code — from SMLLR or a similar tool — alongside the government-generated one, pointing to a support chat, warranty registration, or reorder page. The two codes serve entirely different purposes and should be visually distinguished from each other.
Does my billing software handle GST e-invoice QR code generation automatically?
Most GST-compliant billing software (Tally, Zoho Books, ClearTax, and similar tools with e-invoicing support) handles the full round-trip to the IRP automatically once an invoice is finalized. It's worth confirming your specific software and plan tier actually has e-invoicing enabled, since a misconfigured setup can silently produce non-compliant invoices.