StampMitraDevelopers
गाइड

Developer गाइड और यूज़ केस

StampMitra की verification और e-Stamp APIs पर विस्तृत गाइड। हर गाइड सीधे जवाब से शुरू होती है और docs वाले ही API डेटा से बनी है।

गाइड

  • PAN वेरिफिकेशन API कैसे करें: भारत में डेवलपर के लिए पूरी गाइड

    PAN verification API में आप अपने सर्वर से POST /v1/verify/pan पर PAN और चाहें तो नाम भेजते हैं। जवाब में valid, registeredName, nameMatchResult और referenceId मिलते हैं। यह नंबर और नाम का रिकॉर्ड से मिलान बताती है, यह साबित नहीं करती कि फॉर्म भरने वाला असली मालिक है। गलत format पर 400 आता है। पहले sandbox में टेस्ट कीजिए।

  • GSTIN वेरिफिकेशन API: GST नंबर वेरिफाई करने की पूरी गाइड

    GSTIN verification API में आप 15 कैरेक्टर का GSTIN भेजते हैं और जवाब में valid, कानूनी नाम, ट्रेड नाम, registration की स्थिति और पता मिलता है। StampMitra पर यह POST /v1/verify/gstin है, और सिर्फ PAN हो तो POST /v1/verify/pan-to-gstin GSTIN की सूची देता है। sandbox में टेस्ट करके production key से लाइव जाएँ।

  • गाड़ी का RC वेरिफ़िकेशन API: डीलर और फ्लीट ऐप के लिए पूरी गाइड

    Vehicle RC verification API में आप POST /v1/verify/rc पर vehicleNumber भेजते हैं और मालिक का नाम, गाड़ी की क्लास, chassis, engine, RC स्टेटस, RC की आख़िरी तारीख और बीमा की तारीख JSON में मिलती है। Sandbox में sk_test_ key से मुफ़्त टेस्ट करें, production में सफल कॉल पर शुल्क लगता है।

  • कारोबार वेरिफाई API: GSTIN, CIN और Udyam से सप्लायर ऑनबोर्डिंग

    StampMitra की API में कारोबार वेरिफाई करने के पाँच endpoints हैं: gstin, cin, udyam, pan-to-gstin और pan-to-udyam। हर एक POST /v1/verify/... पर चलता है और Bearer API key माँगता है। जवाब में स्थिति, नाम और referenceId आते हैं। CIN के जवाब में directors भी मिलते हैं। नहीं मिलना भी पूरा नतीजा है, error नहीं।

  • e-stamp paper API: catalog से certificate तक पूरा order flow

    StampMitra की e-stamp API में सात कदम हैं: /v1/services से catalog, /v1/estamp/states से state और instrument, /v1/estamp/duty/calculate से duty, /v1/orders से order, parties जोड़ना, /v1/payments/intents से payment, और आख़िर में documents से certificate download। duty की रकम सिर्फ़ server निकालता है, आप उसे कभी खुद नहीं निकालते।

  • Node.js और Python से PAN वेरिफाई कैसे करें: चरण-दर-चरण गाइड

    Node.js या Python से PAN वेरिफाई करने के लिए अपने सर्वर से https://api-b2b.stampmitra.in/v1/verify/pan पर POST भेजें। Header में Authorization: Bearer sk_test_... लगाएं और body में pan (ABCDE1234F) तथा वैकल्पिक name दें। जवाब में valid, panStatus और referenceId मिलता है। key को सर्वर पर ही रखें, और valid: false को error नहीं, पूरा हुआ नतीजा मानें।

  • API Errors और उन्हें संभालने की गाइड: 402, 429, 403 क्या करें

    StampMitra API में 402 का मतलब fulfilment wallet में balance कम है, 429 का मतलब उस endpoint की rate limit पार हो गई है, और 403 का मतलब API key valid है पर endpoint का scope उसमें नहीं है। 402 और 403 में retry बेकार है, 429 और 502 में backoff के साथ सीमित retry करें। हर error में code, message और requestId आता है, support को requestId भेजें।

  • sandbox और production API key में फर्क: पहली बार live जाने से पहले की गाइड

    sandbox key (sk_test_) टेस्टिंग के लिए है, sandbox data पर चलती है और wallet नहीं घटाती। production key (sk_live_) KYC-approved organization को मिलती है और हर सफल call का पैसा wallet से काटती है। API key IP allowlist से key सिर्फ तय IP या CIDR से चलती है, और PAN व RC जैसे संवेदनशील scopes पर यह default रूप से ज़रूरी है।

यूज़ केस

  • फिनटेक और NBFC के लिए KYC API: drop-off से automation तक

    KYC API से लोन या फिनटेक ऐप ग्राहक का PAN, बैंक खाता, GSTIN, CIN और Udyam कुछ सेकंड में JSON में जाँच सकती है, जिससे manual इंतज़ार घटता है। लेकिन API का एक सही नतीजा किसी regulated संस्था को अपने-आप KYC-compliant नहीं बनाता: नीति, risk category और रिकॉर्ड की ज़िम्मेदारी संस्था की रहती है।

  • रेंट एग्रीमेंट ई-स्टांप API: प्रॉपर्टी ऐप में tenant onboarding

    StampMitra API में रेंट एग्रीमेंट का e-stamp एक तय क्रम में चलता है: पहले GET /v1/services से entitled service देखें, फिर POST /v1/orders से order बनाएँ, उसके orderId पर parties जोड़ें, फिर payment intent बनाएँ और आख़िर में documents endpoint से certificate लें। duty की राशि हमेशा duty calculate endpoint से आती है और नियम राज्य के हिसाब से बदलते हैं।