Smart-ID API: RP API v3 के लिए डेवलपर गाइड

अंतिम समीक्षा: 5 अक्टूबर 2026 · कानूनी सलाह नहीं

यह Smart-ID API की कोड-केंद्रित गाइड है: एंडपॉइंट, सेशन, रिस्पॉन्स की जाँच, डेमो टेस्टिंग और कानूनी स्थिति। देश के अनुसार अनुबंधों और AML नियमों के लिए हमारी Smart-ID इंटीग्रेशन गाइड पढ़ें।

Smart-ID एक नज़र में

Smart-ID, SK ID Solutions AS का एक मोबाइल ऐप है। SK के Relying Party API के ज़रिए कोई सेवा इसका उपयोग उपयोगकर्ता को लॉग इन कराने या हस्ताक्षर लेने के लिए करती है।^[13] हर कुंजी का एक हिस्सा SK के सर्वर पर रहता है। एस्टोनिया की Information System Authority (RIA) इसे "Smart-ID कुंजी प्रबंधन सर्वर सेवा" कहती है।^[4]

अपनाना: उपयोगकर्ता और लेनदेन

smart-id.com के लाइव काउंटर के अनुसार, 5 अक्टूबर 2026 को लिथुआनिया 1,857,471 उपयोगकर्ताओं के साथ Smart-ID का सबसे बड़ा बाज़ार है। इसके बाद लातविया में 1,198,463 और एस्टोनिया में 797,395 उपयोगकर्ता हैं।^[1] SK के अनुसार "हर महीने लगभग 100 मिलियन लेनदेन" होते हैं।^[2]

ERR News के अनुसार, एस्टोनिया में प्रमाणीकरण में Smart-ID की "लगभग 60 प्रतिशत बाज़ार हिस्सेदारी" है। काउंटर केवल कुल संख्या देता है। कोई प्राथमिक स्रोत यह नहीं बताता कि हर देश के वयस्कों में Smart-ID का हिस्सा कितना है (5 अक्टूबर 2026)।

उपयोगकर्ता क्या देखता है

RP API v3 तीन तरीकों से ऐप तक पहुँचता है: अलग-अलग डिवाइस पर डायनेमिक QR कोड, उसी फ़ोन पर Web2App या App2App लिंक, या पुश नोटिफ़िकेशन।^[12] SK, QR और ऐप-से-ऐप अनुभव को Smart-ID+ नाम से पेश करता है, जो "अब वेबसाइट पर आपका व्यक्तिगत पहचान कोड दर्ज करने पर निर्भर नहीं है"।^[8]

Smart-ID API v3 कैसे काम करता है

यह API HTTPS पर REST है और UTF-8 JSON का उपयोग करता है।^[19] चार POST एंडपॉइंट समूह एक सेशन खोलते हैं और एक sessionID लौटाते हैं। एक GET परिणाम लौटाता है।^[13]

RP API v3 के एंडपॉइंट समूह, SK के ओवरव्यू के अनुसार।^[13]

डिवाइस लिंक के साथ सरलीकृत क्रॉस-डिवाइस लॉग इन।^[12][18]

आम गलतियां:

• हर शुरुआती v3 अनुरोध में आपके द्वारा बनाया गया एक रैंडम rpChallenge होता है। replay हमलों से बचाव के लिए इसने v2 के nonce की जगह ली है।^[20]
• sessionSecret कभी भी आपके फ्रंटएंड तक नहीं पहुंचना चाहिए। एक फ्लो के लिए एक ही सेशन अनुरोध होता है, तब भी जब आप QR और लिंक दोनों साथ दिखाते हैं।^[18]
• नोटिफिकेशन फ्लो में आप चार अंकों का कोड rpChallenge के SHA-256 से निकालते हैं।^[17]
• SK आपको source IP और relyingPartyUUID के आधार पर प्रमाणित करता है, और HTTPS key pinning अनिवार्य करता है।^[19]
• SK के दस्तावेज़ीकरण के अनुसार जिस उपयोगकर्ता का खाता नहीं है, उसके लिए HTTP 404 मिलता है। enumeration से बचाव के लिए वह आपसे सभी त्रुटि मामलों में एक ही संदेश दिखाने को कहता है।^[19]

Smart-ID API से किसी व्यवसाय को क्या मिलता है

पूरा हुआ सेशन state, result.endResult, cert में उपयोगकर्ता का प्रमाणपत्र और एक signature ऑब्जेक्ट लौटाता है। subject के serialNumber में पहचान कोड होता है, उदाहरण के लिए PNOEE-30001010004, जिसमें prefix देश बताता है।^[15]

SK के रिस्पॉन्स सत्यापन के लिए आपको ये करना होगा:^[15]

• जाँचें कि state COMPLETE है, endResult OK है, प्रोटोकॉल ACSP_V2 (लॉगिन) या RAW_DIGEST_SIGNATURE है।
• चेन को केवल SK के CA के आधार पर, OCSP या CRL के साथ, मान्य करें।
• हर Smart-ID नीति पहचानकर्ता (policy identifier) अनिवार्य करें, ताकि अन्य SK प्रमाणपत्र विफल हों।
• certificateLevel की तुलना अपने आवश्यक स्तर से करें।
• हस्ताक्षरित payload को फिर से बनाएँ और हस्ताक्षर सत्यापित करें।
• एक ही डिवाइस वाले फ़्लो में callback URL के मान सत्यापित करें।

आश्वासन स्तर और कानूनी स्थिति

Smart-ID अधिसूचित eID योजनाओं की EU सूची में नहीं है; एस्टोनिया की अधिसूचित योजना (High, 7 नवंबर 2018) ID कार्ड और Mobile-ID को कवर करती है।^[6]

सावधानी: ई-निवासी "निवासियों से अलग पहचाने नहीं जा सकते"।^[5]

एस्टोनिया में AML ग्राहक ड्यू डिलिजेंस

एस्टोनिया का धन शोधन और आतंकवादी वित्तपोषण निवारण अधिनियम (RahaPTS) § 31(3) में दूरस्थ मार्ग तय करता है।^[23]

§ 31(3)RahaPTS (एस्टोनिया)

"1) e-identimise süsteemi, millest on teatatud ... (EL) nr 910/2014 ... artikli 9 kohaselt ja mis vastab ... artikli 8 lõike 2 punktis b või c sätestatud usaldusväärsuse tasemele" या "2) kvalifitseeritud usaldusteenust"

स्रोत: Riigi Teataja, RahaPTS^[23]

हिंदी में: पर्याप्त या उच्च स्तर पर अधिसूचित eID योजना, या योग्य ट्रस्ट सेवा। मार्ग 1 लागू नहीं होता। Smart-ID के योग्य प्रमाणपत्र मार्ग 2 में आते हैं या नहीं, इस पर 5 अक्टूबर 2026 तक कोई आधिकारिक बयान नहीं है, इसलिए Finantsinspektsioon या कानूनी सलाहकार से पूछें। लिथुआनिया का AML कानून (अनुच्छेद 11) और लातविया का कैबिनेट विनियम संख्या 392 (बिंदु 7.1) कई दूरस्थ मार्गों में योग्य या सुरक्षित इलेक्ट्रॉनिक हस्ताक्षर को शामिल करते हैं।^[28][29]

2027 से: AMLR अनुच्छेद 22(6)

धन शोधन निवारण विनियमन (AMLR) 10 जुलाई 2027 से लागू होता है। अनुच्छेद 22(6)(b) "ऐसे इलेक्ट्रॉनिक पहचान साधन जो आश्वासन स्तर 'पर्याप्त' या 'उच्च' के संबंध में विनियमन (EU) संख्या 910/2014 की आवश्यकताओं को पूरा करते हैं और संबंधित योग्य ट्रस्ट सेवाएं" स्वीकार करता है।^[30] धन शोधन निवारण प्राधिकरण (AMLA) के 30 सितंबर 2026 के अंतिम मसौदा मानक, जो अभी कानून नहीं हैं, पर्याप्त या उच्च स्तर के eID को स्वीकार करते हैं, "चाहे वे अनुच्छेद 9 के तहत अधिसूचित हों या नहीं"।^[31] हमारा EUDI वॉलेट पेज eIDAS 2 की समय-सीमा बताता है।

कोई व्यवसाय कैसे जुड़ता है: सीधा RP अनुबंध या ब्रोकर

SK की प्रक्रिया: बिना किसी समझौते के मुफ्त में परीक्षण करें, सुरक्षा उपाय चुनें, अपने IP पते और सेवा का नाम भेजें, हस्ताक्षर करें, अपना RP UUID प्राप्त करें, और "आपकी पहली पूछताछ के कुछ ही दिनों में" लाइव हो जाएं।^[21] प्रमाणित ब्रोकर भी Smart-ID को आगे बेचते हैं, और एस्टोनियाई सार्वजनिक निकाय RIA के TARA गेटवे का उपयोग कर सकते हैं।^[5]

Smart-ID तक पहुँचने के तीन तरीके।^[21][5]

SK की मूल्य सूची (1 जून 2026 से) हर "Smart-ID प्रमाणीकरण या हस्ताक्षर अनुरोध" पर शुल्क लेती है: €0.109, न्यूनतम €60 मासिक शुल्क के साथ। 3 million प्लान पर यह घटकर €0.0106 हो जाता है, और 5 million से ऊपर व्यक्तिगत समझौता होता है।^[11] SK के अनुसार मौजूदा RP के लिए Smart-ID+ "बिना किसी अतिरिक्त लागत के" उपलब्ध है।^[7]

डेमो एनवायरनमेंट पर परीक्षण

डेमो: https://sid.demo.sk.ee/smart-id-rp/v3/, relyingPartyUUID 00000000-0000-4000-8000-000000000000, नाम DEMO। लाइव: https://rp-api.smart-id.com/v3/।^[14] परिणाम के अनुसार टेस्ट खाते:^[16]

उपयोग के मामले और क्षेत्रीय नियम

• KYC और AML ऑनबोर्डिंग। हस्ताक्षरित नाम और व्यक्तिगत कोड मिलते हैं। AML के लिए उपयुक्तता हर देश में अलग है।^[23][28][29]
• जुआ और आयु। एस्टोनिया का Gambling Act 21 वर्ष से कम आयु के लोगों को संयोग के खेलों से रोकता है (§ 34(2))। यह रिमोट ऑपरेटरों से हर खिलाड़ी को सत्यापित करने और व्यक्तिगत कोड दर्ज करने की अपेक्षा करता है (§ 53(1))।^[24] हमें API में केवल आयु वाला कोई क्लेम नहीं मिला।
• हस्ताक्षर। क्वालिफाइड खाते v3/signature के माध्यम से हस्ताक्षर करते हैं। "2025 में 10 में से 4 लिथुआनियाई लोगों ने क्वालिफाइड ई-हस्ताक्षर का उपयोग किया"।^[13][33]
• टेलीकॉम। कोई भी बाल्टिक नियम SIM पंजीकरण के लिए Smart-ID का नाम नहीं लेता (5 अक्टूबर 2026)।

सीमाएँ और फ़ॉलबैक

"एस्टोनिया और लातविया में Smart-ID फ़िलहाल केवल उन लोगों तक सीमित है जिनके पास एस्टोनियाई या लातवियाई राष्ट्रीय ID-नंबर हैं"। लिथुआनिया के अनिवासी दो बैंकों में Smart-ID Basic प्राप्त कर सकते हैं।^[22] Smart-ID की कोई आयु सीमा नहीं है, लेकिन पंजीकरण के तरीकों की है (लातवियाई ID कार्ड 14 वर्ष से)। 18 वर्ष से कम आयु के खातों के लिए माता-पिता की अनुमति आवश्यक है।^[32]

5 अक्टूबर 2026 तक हमें कोई दर्ज आउटेज नहीं मिला। जोखिम फ़िशिंग है। ERR News के अनुसार, 2025 में PIN घोटालों के ज़रिए एस्टोनियाई बैंक खातों से लगभग €23 मिलियन चुराए गए। 29 अप्रैल 2026 से एस्टोनियाई पंजीकरण कार्ड रीडर के बजाय NFC के ज़रिए ID कार्ड पढ़ता है।^[34]

पहले eID, फ़ॉलबैक के रूप में दस्तावेज़। हर फ़ॉलबैक की आवश्यकता का कारण दर्ज करें।^[31]

Smart-ID API कार्यान्वयन चेकलिस्ट

पहले SK के मुफ़्त डेमो पर बनाएँ, ताकि आपका कोड काम करने तक अनुबंध की ज़रूरत न पड़े।^[21] रिस्पॉन्स सत्यापन इस काम का मुख्य हिस्सा है।^[15]

• डेमो URL और प्रकाशित टेस्ट खातों पर बनाएँ।^[14][16]
• डिवाइस लिंक फ़्लो को प्राथमिकता दें। नोटिफ़िकेशन की अनुमति केवल ज्ञात डिवाइसों पर दें।^[13]
• हर लॉगिन के लिए एक नया रैंडम rpChallenge बनाएँ।^[20]
• SK की HTTPS कुंजी को पिन करें और sessionSecret को सर्वर पर रखें।^[19][18]
• SK के रिस्पॉन्स सत्यापन का हर चरण चलाएँ।^[15]
• SK को अपने IP और सेवा का नाम भेजें, फिर अनुबंध पर हस्ताक्षर करें।^[21]
• हर देश में AML उपयोग के लिए अपना कानूनी आधार लिखित रूप में दर्ज करें।^[23]
• जिन यूज़र्स के पास Smart-ID नहीं है, उनके लिए दस्तावेज़ वाला रास्ता जोड़ें।

Smart-ID में Didit कैसे मदद करता है

Smart-ID, Didit पर एस्टोनिया, लातविया, लिथुआनिया और बेल्जियम में eID सत्यापन के लिए लाइव है। SK कनेक्शन Didit के पास है। इसलिए आपको RP अनुबंध, IP allow-list और सर्टिफ़िकेट कोड की ज़रूरत नहीं पड़ती।

कंसोल में Workflows, फिर ID Verification चरण, फिर Countries पर जाएँ। देश चुनें और "Wallets accepted" के अंतर्गत Smart-ID पर टिक करें। API से methods.EST.wallet सेट करें, एक सेशन बनाएँ और GET /v3/session/{id}/decision/ या वेबहुक पढ़ें। डिजिटल ID वॉलेट डॉक्स के अनुसार verification_method का मान "wallet" होता है और साथ में एक wallet_verification ऑब्जेक्ट होता है।^[35] यूज़र Smart-ID ऐप में एक तुलना कोड को स्वीकृत करता है। Didit कभी PIN नहीं माँगता।

आपको पूरा नाम, जन्म तिथि, बाल्टिक व्यक्तिगत कोड, आश्वासन स्तर (High के रूप में लेबल किया गया) और एक हस्ताक्षर जाँच मिलती है। पता नहीं मिलता, पोर्ट्रेट भी नहीं। जिन उपयोगकर्ताओं के पास Smart-ID नहीं है, वे दस्तावेज़ सत्यापन पर जाते हैं, साथ में NFC चिप रीडिंग ($0.15), लाइवनेस और फेस मैच होते हैं। पूर्ण KYC की लागत $0.33 है और AML स्क्रीनिंग की $0.20। केवल पूरे हुए eID साइन-इन का बिल बनता है। एक पूरा Smart-ID सत्यापन $0.20 का है (मूल्य पृष्ठ)। हर eID डिजिटल ID वॉलेट पृष्ठ पर है।

अक्सर पूछे जाने वाले प्रश्न

स्रोत

1. Smart-ID होम पेज, लाइव उपयोगकर्ता काउंटर, SK ID Solutions, 5 अक्टूबर 2026 को देखा गया।
2. 2025: सीमाओं से परे डिजिटल भरोसे को आगे बढ़ाना, SK ID Solutions, 19 जनवरी 2026।
3. यूरोप में डिजिटल पहचान में भरोसा और प्रतिस्पर्धा, e-Estonia, 2026।
4. इलेक्ट्रॉनिक पहचान (eID), सूचना प्रणाली प्राधिकरण (RIA)।
5. TARA तकनीकी विनिर्देश, RIA।
6. eIDAS के तहत पूर्व-अधिसूचित और अधिसूचित eID योजनाओं का अवलोकन, यूरोपीय आयोग, 5 अक्टूबर 2026 को देखा गया।
7. Smart-ID+, SK ID Solutions।
8. नया Smart-ID मुझे धोखाधड़ी से कैसे बचाता है, Smart-ID FAQ।
9. एस्टोनिया की सरकार ने सुरक्षा मज़बूत करने के लिए Smart-ID+ अपनाया, SK ID Solutions, 28 जनवरी 2026।
10. मुझे कभी एक पुष्टि कोड और कभी तीन कोड क्यों दिखते हैं, Smart-ID FAQ।
11. मूल्य सूची, SK ID Solutions, 1 जून 2026 से मान्य।
12. रिलाइंग पार्टी API: परिचय, SK ID Solutions, संस्करण 3.2.3।
13. रिलाइंग पार्टी API: API एंडपॉइंट का अवलोकन, SK ID Solutions।
14. एनवायरनमेंट के तकनीकी पैरामीटर, SK ID Solutions।
15. रिलाइंग पार्टी API: रिस्पॉन्स सत्यापन, SK ID Solutions।
16. स्वचालित परीक्षण के लिए टेस्ट खाते, SK ID Solutions।
17. रिलाइंग पार्टी API: नोटिफिकेशन-आधारित फ्लो, SK ID Solutions।
18. रिलाइंग पार्टी API: डिवाइस लिंक फ्लो, SK ID Solutions।
19. रिलाइंग पार्टी API: API का तकनीकी विवरण, SK ID Solutions।
20. रिलाइंग पार्टी API: चेंजलॉग, SK ID Solutions।
21. ई-सेवा प्रदाताओं के लिए इंटीग्रेशन प्रक्रिया, Smart-ID।
22. क्या विदेशी और अनिवासी Smart-ID का उपयोग कर सकते हैं, Smart-ID FAQ।
23. Rahapesu ja terrorismi rahastamise tõkestamise seadus (RahaPTS), § 31, Riigi Teataja।
24. Hasartmänguseadus (जुआ अधिनियम), Riigi Teataja।
25. Elektroniskā identifikācija, लातविया का रक्षा मंत्रालय।
26. Smart-ID ने लातविया में प्रमाणीकरण के लिए स्थानीय क्वालिफाइड दर्जा प्राप्त किया, SK ID Solutions, 29 मई 2023।
27. Smart-ID और Mobile-ID को लिथुआनिया में राज्य-अनुमोदित साधनों के रूप में मान्यता मिली, SK ID Solutions, 19 दिसंबर 2024।
28. धन शोधन और आतंकवादी वित्तपोषण की रोकथाम पर कानून, अनुच्छेद 11, लिथुआनिया, INFOLEX समेकित पाठ।
29. मंत्रिमंडल विनियमन संख्या 392, लातविया, likumi.lv।
30. विनियमन (EU) 2024/1624 (AMLR), EUR-Lex, 19 जून 2024 का आधिकारिक जर्नल।
31. अंतिम रिपोर्ट, AMLR के अनुच्छेद 28(1) के तहत मसौदा RTS, AMLA, 30 सितंबर 2026।
32. Smart-ID के उपयोग के लिए आयु सीमाएं, Smart-ID FAQ।
33. SK ID Solutions ने 2025 में लिथुआनिया में लगभग तीन मिलियन प्रमाणपत्र जारी किए, SK ID Solutions, 7 मई 2026।
34. एस्टोनियाई ID कार्ड से Smart-ID पंजीकरण अब NFC के माध्यम से उपलब्ध, Smart-ID, 29 अप्रैल 2026।
35. डिजिटल ID वॉलेट, Didit दस्तावेज़ीकरण।
36. रिलाइंग पार्टी API: इंटरैक्शन, SK ID Solutions।

Smart-ID, Didit के eID सत्यापन में लाइव पाँच eID में से एक है। यह भी देखें: eID सत्यापन क्या है और BankID Sweden API गाइड।