DEV Community

Mind vs Drive
Mind vs Drive

Posted on

GST e-Invoice का Signed QR Code असल में JWT है: Base64URL डिकोड करके क्या पढ़ें, और क्या साबित नहीं होता

GST e-Invoice का Signed QR Code असल में एक JWT है। अगर आप billing software, ERP integration या किसी accounting tool पर काम करते हैं, तो कभी न कभी इनवॉइस पर छपा QR scan करके उसके अंदर का डेटा पढ़ने की ज़रूरत पड़ती है। Scan करने पर मिलती है लगभग 900 अक्षरों की एक लंबी स्ट्रिंग, जो eyJ से शुरू होती है और जिसमें दो डॉट होते हैं। यह लेख बताता है कि उस स्ट्रिंग को Base64URL से कैसे डिकोड करें, उसमें कौन-से फ़ील्ड मिलते हैं, और डिकोड कर लेने से क्या साबित नहीं होता।

नोट: इस लेख का पूरा उदाहरण काल्पनिक है। GSTIN, इनवॉइस नंबर, IRN और साइनिंग की, सब डेमो के लिए बनाए गए हैं। किसी असली इनवॉइस या कंपनी से इनका कोई संबंध नहीं है।

आधिकारिक दस्तावेज़ क्या कहता है

e-Invoice पोर्टल पर NIC का "QR Code procedure" दस्तावेज़ (PDF, जुलाई 2025 का संस्करण, जिसे हमने 20 नवंबर 2026 को देखा) तीन बातें साफ़ लिखता है:

  1. IRN जनरेट होने पर IRP जवाब में एक SignedQRCode लौटाता है, और business उसी से इनवॉइस पर QR बनाता है।
  2. यह Signed QR Code JWT के रूप में होता है, जिसके तीन हिस्से डॉट से अलग होते हैं: signature parameters (header), data (payload) और signature।
  3. QR में ये 10 पैरामीटर होते हैं: supplier का GSTIN, recipient का GSTIN, invoice number, document type, invoice की तारीख, invoice value, line items की संख्या, main item का HSN code, IRN (hash) और IRN जनरेट होने की तारीख।

दस्तावेज़ इसे "Base64 form" कहता है। तकनीकी रूप से ये हिस्से Base64URL में होते हैं, यानी + की जगह -, / की जगह _, और आख़िर में = padding नहीं होती। यही छोटा-सा फ़र्क़ आगे कई गड़बड़ियों की वजह बनता है।

काल्पनिक उदाहरण: डेमो टोकन

नीचे वाला टोकन हमने ख़ुद बनाया है। Header में RS256, payload में उसी ढांचे का डेटा जो NIC के दस्तावेज़ में दिखाया गया है, और signature हमारी अपनी डेमो RSA key से बना है (NIC की key से नहीं)। चाहें तो इसे कॉपी करके ख़ुद आज़मा सकते हैं:

eyJhbGciOiJSUzI1NiIsImtpZCI6IkRFTU8tS0VZLTAxIiwidHlwIjoiSldUIn0.eyJpc3MiOiJERU1PLU5PVC1OSUMiLCJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI3REVNT1gwMDAwWDFaMVwiLFwiQnV5ZXJHc3RpblwiOlwiMjlERU1PWTAwMDBZMVoyXCIsXCJEb2NOb1wiOlwiREVNTy8yNi0yNy8wNDJcIixcIkRvY1R5cFwiOlwiSU5WXCIsXCJEb2NEdFwiOlwiMTgvMTEvMjAyNlwiLFwiVG90SW52VmFsXCI6MTE4MDAsXCJJdGVtQ250XCI6MixcIk1haW5Ic25Db2RlXCI6XCI5OTgzMTRcIixcIklyblwiOlwiNmU2YjJhZDAxZDk0YTE2Y2M2NjRiYzhmODUwOWFjMGVlMjNjNzRhMWYwNTM2M2UzZGNiYjUyZjdhYzM3ZDAzY1wiLFwiSXJuRHRcIjpcIjIwMjYtMTEtMTggMTU6MjA6MDBcIn0ifQ.JXNoiRUY81jqTFYWrbOdZBvwVq1Q_HGCiVT6Wb1nrsIi39CGowSlto5E7VByy5gJxkR-3wsE8KFEGTM3AveOODqPrdJq6sYjMrFnaEvHw9U3ivjyA-fOur8E_SnR8k_sqpMrK_fh66evMFEF2VBeMbpgzBz_j9cD24v_Qsd0t3uce0SahLjotO36garhLfarrQPw0yrUJWMA9w6140U1AeCjO9nEjeoRZasT3aXsj_kStqkgIpSQOsYhUyWvMsUczXDsCF60SdUgZSSv0ZShlyJWocA7pi9FnBb0nrib3q_Y5EsuoXP-62Wfy7XVxg3ZzvAPO5xkk4jidJeOOuin6A
Enter fullscreen mode Exit fullscreen mode

हिस्सा 1: header

पहले डॉट से पहले का हिस्सा eyJhbGciOiJSUzI1NiIsImtpZCI6IkRFTU8tS0VZLTAxIiwidHlwIjoiSldUIn0 है। यह 64 अक्षरों का है, padding नहीं है, और डिकोड करने पर मिलता है:

{ "alg": "RS256", "kid": "DEMO-KEY-01", "typ": "JWT" }
Enter fullscreen mode Exit fullscreen mode

असली टोकन में kid और x5t (certificate का thumbprint) भी होते हैं। इनसे पता चलता है कि किस key से साइन किया गया था।

हिस्सा 2: payload, और उसके अंदर एक और JSON

यहीं पहली चौंकाने वाली बात आती है। Payload डिकोड करने पर data एक object नहीं, बल्कि string निकलता है, जिसके अंदर escaped JSON है:

{
  "iss": "DEMO-NOT-NIC",
  "data": "{\"SellerGstin\":\"27DEMOX0000X1Z1\",\"BuyerGstin\":\"29DEMOY0000Y1Z2\",\"DocNo\":\"DEMO/26-27/042\",\"DocTyp\":\"INV\",\"DocDt\":\"18/11/2026\",\"TotInvVal\":11800,\"ItemCnt\":2,\"MainHsnCode\":\"998314\",\"Irn\":\"6e6b2ad0…d03c\",\"IrnDt\":\"2026-11-18 15:20:00\"}"
}
Enter fullscreen mode Exit fullscreen mode

(Irn यहाँ बीच से छोटा करके दिखाया गया है; टोकन में पूरे 64 hex अक्षर हैं।) असली टोकन में iss की वैल्यू NIC होती है; हमने जानबूझकर DEMO-NOT-NIC रखा है।

इसलिए data को दूसरी बार JSON.parse करना पड़ता है। दो बातें और ध्यान रखें:

  • DocDt का फ़ॉर्मैट DD/MM/YYYY है, जबकि IrnDt का YYYY-MM-DD HH:mm:ss। एक ही parser से दोनों पढ़ेंगे तो तारीख़ें उलट-पुलट हो सकती हैं।
  • TotInvVal एक number है, string नहीं। हमारे उदाहरण में 11800 है।

हिस्सा 3: signature

तीसरा हिस्सा 342 अक्षरों का है, जो डिकोड होकर 256 bytes बनता है (2048-bit RSA signature)। इसमें - और _ दोनों मौजूद हैं, इसलिए साधारण base64 -d इस पर invalid input देकर रुक जाता है (हमने GNU coreutils 9.7 पर यह जाँचा)।

कोड में: डिकोड और वेरिफ़ाई

Python में (signature जाँचने के लिए cryptography पैकेज चाहिए):

import base64, json
from cryptography.hazmat.primitives import serialization, hashes
from cryptography.hazmat.primitives.asymmetric import padding
from cryptography.exceptions import InvalidSignature

def b64url_decode(s: str) -> bytes:
    return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

raw = open("signed_qr.txt", encoding="utf-8").read()
token = "".join(raw.split()).strip('“”"')        # PDF/chat से आए line break और quotes हटाएँ
h, p, sig = token.split(".")
payload = json.loads(b64url_decode(p))
data = json.loads(payload["data"])               # दूसरी बार parse
print(data["DocNo"], data["TotInvVal"])          # DEMO/26-27/042 11800

pub = serialization.load_pem_public_key(open("public_key.pem", "rb").read())
try:
    pub.verify(b64url_decode(sig), f"{h}.{p}".encode(), padding.PKCS1v15(), hashes.SHA256())
    print("signature OK")
except InvalidSignature:
    print("signature INVALID")
Enter fullscreen mode Exit fullscreen mode

हमारे डेमो टोकन और डेमो public key के साथ यह signature OK देता है। अगर payload में TotInvVal को 11800 से 1180 कर दें और टोकन दोबारा जोड़ें, तो वही जाँच INVALID देती है। असली इनवॉइस के लिए public key या DS certificate वही लें जो e-Invoice पोर्टल पर दिया गया है। NIC के अनुसार पोर्टल पर एक offline verification app भी मिलता है।

डिकोड करने से क्या साबित नहीं होता

Base64URL सिर्फ़ encoding है, encryption नहीं। कोई भी व्यक्ति वैसा ही दिखने वाला payload बनाकर उसे Base64URL कर सकता है। इसलिए:

  • डिकोड हो जाना ≠ असली होना। Payload पढ़ पाने का मतलब बस इतना है कि स्ट्रिंग सही ढंग से encoded है। इनवॉइस सच में IRP पर दर्ज हुआ है, यह RS256 signature जाँचने पर ही पता चलता है।
  • iss या kid देखकर भरोसा न करें। ये भी उसी payload या header का हिस्सा हैं, जिसे कोई भी लिख सकता है।
  • QR को "साफ़" करके दोबारा न छापें। अगर आप डिकोड किया हुआ JSON QR में डाल देंगे, तो signature चला जाएगा और कोई उसे वेरिफ़ाई नहीं कर पाएगा। QR में हमेशा पूरी original JWT स्ट्रिंग ही रहनी चाहिए।
  • Exp claim नहीं है। इस payload में exp नहीं होता, इसलिए "expired" जैसी कोई जाँच यहाँ लागू नहीं होती।

ब्राउज़र में जल्दी देखना (2 मिनट)

अगर बस यह देखना है कि QR में कौन-सा GSTIN या इनवॉइस नंबर है, तो हिंदी इंटरफ़ेस वाला JWT डिकोडर काम आ सकता है:

  1. स्कैन की गई स्ट्रिंग को "इनपुट स्ट्रिंग" बॉक्स में पेस्ट करें। बीच में आए line break या आगे-पीछे के quotes से फ़र्क़ नहीं पड़ता, क्योंकि टूल Base64URL के बाहर के अक्षर हटा देता है।
  2. Header और payload पेस्ट करते ही दो पैनलों में दिख जाते हैं, और status bar में Valid JWT Token Structure (RS256 / JWT) आता है। हर पैनल के "कॉपी" बटन से JSON कॉपी करें।
  3. data वाली string को ऊपर के कोड की तरह दूसरी बार parse करें।

ध्यान रखें: इस पेज के कुछ लेबल अंग्रेज़ी में हैं (जैसे "Verify Signature")। RS256 टोकन पर यह सेक्शन सिर्फ़ Asymmetric (RS256) दिखाता है और signature की जाँच नहीं करता, क्योंकि टूल अभी केवल HMAC (HS256/384/512) वेरिफ़ाई करता है। RS256 की जाँच के लिए ऊपर वाला कोड या पोर्टल का offline app इस्तेमाल करें। डिकोडिंग ब्राउज़र में ही होती है।

अगर आपको सिर्फ़ एक हिस्से को Base64URL से डिकोड करना है, तो URL-सुरक्षित Base64 पेज भी है।


स्रोत: NIC, "QR Code procedure" (e-Invoice पोर्टल, PDF, जुलाई 2025) और NIC e-Invoice API sandbox, "Get IRN Details", दोनों 20 नवंबर 2026 को देखे गए। उदाहरण का सारा डेटा काल्पनिक है।

Disclosure: यह टूल Mind vs Drive का है, जो इस अकाउंट के पीछे की टीम है।

Top comments (0)