signatures[] के एक आइटम के रूप में यहाँ पाते हैं:
- उपयोगकर्ता सत्यापन (KYC) और व्यवसाय सत्यापन (KYB) सत्रों के लिए
GET /v3/session/{sessionId}/decision/। - V3 सत्र webhook के
decisionमें; ये तब भेजे जाते हैं जब सत्रApproved,Declined,In ReviewयाAbandonedहोता है। - कंसोल में सत्र का हस्ताक्षर टैब, और PDF रिपोर्ट का हस्ताक्षर अनुभाग।
signatures निर्णय में केवल तभी होता है जब वर्कफ़्लो में ई-हस्ताक्षर चरण शामिल हो। जब तक कोई हस्ताक्षरकर्ता इस चरण तक नहीं पहुँचता, यह एक खाली ऐरे रहता है। KYC चरण में एक आइटम होता है; KYB चरण में प्रति हस्ताक्षरकर्ता एक आइटम होता है।
उदाहरण
हस्ताक्षर ऑब्जेक्ट
जब तक
status का मान signed न हो, तब तक किसी भी हस्ताक्षरकर्ता को हस्ताक्षरित न मानें। Advanced (AES) हस्ताक्षर पर null प्रमाणपत्र, टाइमस्टैम्प या signed_file का अर्थ है कि अभी तक कोई हस्ताक्षर नहीं हुआ है। हस्ताक्षरित Simple हस्ताक्षर में signed_file होता है लेकिन प्रमाणपत्र और टाइमस्टैम्प हमेशा null होते हैं।
हस्ताक्षरकर्ता
दस्तावेज़
फ़ील्ड
documents[].fields[] का प्रत्येक आइटम दस्तावेज़ का एक फ़ील्ड है, इस हस्ताक्षरकर्ता की प्रति पर उसके मान के साथ:
हस्ताक्षरित दस्तावेज़ डाउनलोड करें
अपनी API कुंजी के साथsigned_file और evidence_file में दिए गए पाथ का उपयोग करें। प्रत्येक रूट स्वयं PDF के साथ रिस्पॉन्स देता है।
रिस्पॉन्स देने से पहले, Didit संग्रहीत फ़ाइल की जांच उसके रिकॉर्ड किए गए SHA-256 से करता है। यदि वे भिन्न होते हैं, तो हस्ताक्षरित PDF और साक्ष्य रूट
409 लौटाते हैं और छवि रूट 400 लौटाता है, प्रत्येक signature_document_changed के साथ। जब किसी KYB चरण में कई हस्ताक्षरकर्ता हों, तो हमेशा साक्ष्य रूट में signature_id पास करें।
हस्ताक्षरित PDF
हस्ताक्षरित PDF में क्रम से निम्नलिखित शामिल होते हैं:- दस्तावेज़ के वे पेज जो हस्ताक्षरकर्ता को दिखाए गए थे, जिसमें प्रत्येक फ़ील्ड का मान वहीं स्टैम्प किया गया है जहाँ आपने उसे रखा था।
- साक्ष्य पेज, जब तक कि आपने
signature_evidence_pageको बंद न किया हो। - केवल Advanced (AES) के लिए, PAdES हस्ताक्षर, Didit द्वारा जारी किए गए RFC 3161 टाइमस्टैम्प और भविष्य में इसे सत्यापित करने के लिए आवश्यक निरस्तीकरण डेटा के साथ। Simple PDF साक्ष्य पेज के बाद समाप्त हो जाता है और इसमें कोई डिजिटल हस्ताक्षर, सील या टाइमस्टैम्प नहीं होता है।
Signed with Didit · जिसके बाद हस्ताक्षर की id के पहले 8 वर्ण होते हैं।
Didit हस्ताक्षरकर्ता को दिखाए गए दस्तावेज़ के बाइट्स के बाद फ़ील्ड मान, साक्ष्य पेज और हस्ताक्षर जोड़ता है। वह दस्तावेज़ हस्ताक्षरित फ़ाइल का एक सटीक प्रीफ़िक्स है, इसलिए हस्ताक्षरित PDF के विरुद्ध अभी भी sha256_original की जांच की जा सकती है।
साक्ष्य PDF
साक्ष्य PDF एक हस्ताक्षरकर्ता के लिए निम्नलिखित रिकॉर्ड करता है:- स्तर और प्रारूप।
- हस्ताक्षरकर्ता का नाम, उनकी हस्ताक्षर करने की क्षमता और KYB के लिए कंपनी।
- सत्यापित पहचान सत्र (केवल Advanced (AES))।
- पुष्टि: चैनल, मास्क किया गया गंतव्य और समय (केवल Advanced (AES))।
- हस्ताक्षरकर्ता का IP पता।
- प्रत्येक दस्तावेज़: शीर्षक, पेजों की संख्या और मूल का SHA-256। Word दस्तावेज़ के लिए, Word फ़ाइल का नाम और SHA-256, कनवर्टर संस्करण और PDF का SHA-256।
- अपनाया गया हस्ताक्षर: टाइप किया गया (इसकी हस्तलेखन शैली के साथ) या ड्रॉ किया गया, इसे कब अपनाया गया था, और हस्ताक्षर तथा आद्याक्षर छवियां।
- प्रत्येक दस्तावेज़ के प्रत्येक फ़ील्ड के लिए: इसका लेबल, पेज और प्रकार, इसका मान (हस्ताक्षर या आद्याक्षर के लिए छवि), मान कहाँ से आया (उदाहरण के लिए हस्ताक्षरकर्ता द्वारा टाइप किया गया, सत्यापित पहचान या आपका API), यह कब भरा गया था (UTC) और हस्ताक्षरकर्ता द्वारा टाइप किए गए मान के लिए उस समय उनका IP पता।
- अंतिम सहमति: वह पाठ जिस पर हस्ताक्षरकर्ता समीक्षा स्क्रीन पर सहमत हुआ था, और कब।
- प्रत्येक हस्ताक्षरित फ़ाइल का SHA-256 और, Advanced (AES) के लिए, प्रमाणपत्र (किसे जारी किया गया, जारीकर्ता, सीरियल और वैधता) तथा टाइमस्टैम्प।
हस्ताक्षर को फिर सत्यापित करें
POST /v3/session/{session_id}/signatures/{node_id}/validate/ चरण के प्रत्येक हस्ताक्षरित PDF को फिर से पढ़ता है और इसके SHA-256 की जांच करता है। Advanced (AES) हस्ताक्षर के लिए यह PAdES हस्ताक्षर, इसके प्रमाणपत्र, निरस्तीकरण डेटा और टाइमस्टैम्प को भी सत्यापित करता है। Simple हस्ताक्षर में कोई डिजिटल हस्ताक्षर नहीं होता है, इसलिए जांच केवल फ़ाइल की अखंडता की होती है। यह परिणाम को validation में सहेजता है और अपडेट किए गए signatures[] को लौटाता है। किसी एक हस्ताक्षरकर्ता की जांच करने के लिए signature_id भेजें। इसके लिए write:sessions की आवश्यकता होती है, और कंसोल में यह फिर सत्यापित करें बटन है। संग्रहीत हस्ताक्षरित PDF जो अब अपने sha256_signed से मेल नहीं खाती है, वह signature_document_changed के साथ 400 लौटाती है।
जब तक दस्तावेज़ हस्ताक्षरित नहीं होते, validation null रहता है। यदि Didit हस्ताक्षर के परिणाम की पुष्टि नहीं कर सकता है, तो validation { "valid": null, "reason": "signature_provider_outcome_unknown", "checked_at" } होता है और स्थिति हल होने तक status signing बना रहता है: इसे अहस्ताक्षरित मानें।
PDF रिपोर्ट में
PDF रिपोर्ट हस्ताक्षरकर्ता, पुष्टिकरण, प्रमाणपत्र, टाइमस्टैम्प और दस्तावेज़ों को उनके हैश के साथ एक हस्ताक्षर अनुभाग प्रिंट करती है। जब दस्तावेज़ों में फ़ील्ड होते हैं, तो उसके बाद एक ई-हस्ताक्षर · फ़ील्ड पेज आता है, जिसमें प्रति दस्तावेज़ एक तालिका होती है: प्रत्येक फ़ील्ड का मान, हस्ताक्षर और इनिशियल्स की छवियां, समय और स्रोत। हस्ताक्षर अनुभाग KYC रिपोर्ट में बैंक सत्यापन के बाद और KYB रिपोर्ट में दस्तावेज़ों के बाद आता है। केवल उसी अनुभाग को प्रिंट करने के लिएpages=signature पास करें।