> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# उपयोगकर्ता दस्तावेज़: पहचान, पते का प्रमाण, सहायक फ़ाइलें

> Didit के User entities पर पहचान, पते का प्रमाण और सहायक फ़ाइलें: क्या एकत्र होता है, कैसे प्राप्त करें और कंसोल से कैसे अपलोड करें।



उपयोगकर्ता दस्तावेज़ प्रॉम्प्ट
        प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o session-report.pdf
\```

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User entity:

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "$WORKFLOW_ID", "vendor_data": "user-42"}'
\```

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

यहाँ पेस्ट करें

सत्यापन के दौरान उपयोगकर्ता द्वारा अपलोड किया गया हर दस्तावेज़ उसकी User entity से स्थायी रूप से जुड़ जाता है। यह पेज बताता है कि क्या-क्या एकत्र किया जाता है, उसे कैसे प्राप्त करें, और अतिरिक्त दस्तावेज़ मैन्युअल रूप से कैसे अपलोड करें।## Didit क्या एकत्र करता है| दस्तावेज़ का प्रकार | कब एकत्र किया जाता है | निकाले गए फ़ील्ड |
| - | - | - |
| **सरकारी ID** (पासपोर्ट, राष्ट्रीय ID, ड्राइविंग लाइसेंस, निवास परमिट) | [पहचान सत्यापन](https://docs.didit.me/hi/core-technology/id-verification/overview.md) चरण | नाम, DOB, दस्तावेज़ संख्या, जारीकर्ता देश, समाप्ति, MRZ (जहाँ मौजूद हो) |
| **सेल्फ़ी / लाइवनेस फ़्रेम** | [लाइवनेस](https://docs.didit.me/hi/core-technology/liveness/overview.md) चरण | चेहरे का सबसे बड़ा क्रॉप, पैसिव लाइवनेस स्कोर |
| **पते का प्रमाण (POA)** | [POA](https://docs.didit.me/hi/core-technology/proof-of-address/overview.md) चरण | नाम, पता, जारीकर्ता, दस्तावेज़ तिथि |
| **NFC चिप रीड** | [NFC सत्यापन](https://docs.didit.me/hi/core-technology/nfc-verification/overview.md) चरण | चिप डेटा, ICAO सर्टिफ़िकेट चेन, OCR से मिलान |
| **अतिरिक्त दस्तावेज़** | विश्लेषक का अनुरोध या कस्टम वर्कफ़्लो चरण | लागू होने पर OCR, अन्यथा जैसा है वैसा संग्रहीत |[समर्थित दस्तावेज़ प्रकार](https://docs.didit.me/hi/core-technology/id-verification/supported-documents-id-verification.md) में देश × दस्तावेज़ का पूरा मैट्रिक्स दिया गया है (220+ देशों में 14,000+ दस्तावेज़)।## दस्तावेज़ प्राप्त करनादस्तावेज़ सीधे उपयोगकर्ता से नहीं, बल्कि उस **सत्र** से जुड़े होते हैं जिसने उन्हें एकत्र किया। किसी उपयोगकर्ता के सभी दस्तावेज़ सूचीबद्ध करने के लिए:**1. उपयोगकर्ता के सत्र सूचीबद्ध करें**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. हर सत्र का निर्णय प्राप्त करें**हर सत्र के निर्णय में एकत्र किए गए दस्तावेज़ों के URL शामिल होते हैं।```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```रिस्पॉन्स में `id_verification.document_images`, `proof_of_address.document_images` और `liveness.images` फ़ील्ड देखें।**3. साइन किए गए URL का उपयोग करें**रिस्पॉन्स में मौजूद इमेज URL अल्पकालिक साइन किए गए URL होते हैं। उपयोग की अवधि तक उन्हें क्लाइंट-साइड कैश करें, या उनकी समय-सीमा समाप्त होने पर निर्णय दोबारा प्राप्त करें।## PDF रिपोर्ट बनानाकिसी सत्र के लिए एकत्र किए गए सब कुछ का मनुष्य द्वारा पढ़ने योग्य एक्सपोर्ट, जिसमें सभी दस्तावेज़ शामिल हों, इसके लिए उपयोग करें:**`GET /v3/session/{session_id}/generate-pdf/`**यह सत्र के विवरण, सुविधा के परिणाम और एम्बेडेड दस्तावेज़ इमेज वाला PDF लौटाता है। अनुपालन ऑडिट, SAR संलग्नकों और नियामक फ़ाइलिंग के लिए उपयोगी है।## कंसोल से दस्तावेज़ अपलोड करनाअनुपालन ऑपरेटर किसी उपयोगकर्ता या सक्रिय सत्र के लिए अतिरिक्त दस्तावेज़ अपलोड कर सकते हैं:1. *Users → \[user] → Documents → Upload document* पर जाएँ।
2. दस्तावेज़ का प्रकार चुनें (ID, POA, कस्टम)।
3. फ़ाइल अपलोड करें; समर्थित प्रकारों के लिए OCR अपने आप चलता है।
4. दस्तावेज़ सबसे हाल के सत्र से जुड़ जाता है (या आप एक रेमेडिएशन सत्र बना सकते हैं)।> [!NOTE]
>
> दस्तावेज़ अपलोड UI केवल कंसोल पर उपलब्ध है; किसी उपयोगकर्ता से सीधे दस्तावेज़ जोड़ने के लिए कोई सार्वजनिक API endpoint नहीं है। सभी दस्तावेज़ कैप्चर के लिए सत्र को प्रवेश बिंदु के रूप में उपयोग करें।## दस्तावेज़ क्रॉस-रेफ़रेंसिंगजब कोई सत्र कई दस्तावेज़ प्रकार एकत्र करता है, तो Didit उन्हें आपस में क्रॉस-रेफ़रेंस करता है:- **ID ↔ लाइवनेस** — ID पर मौजूद चेहरा लाइवनेस सेल्फ़ी से मेल खाता है।
- **ID ↔ POA** — POA पर मौजूद नाम, ID से निकाले गए नाम से मेल खाता है।
- **ID ↔ NFC** — MRZ / दृश्य डेटा, NFC चिप डेटा से मेल खाता है।असंगतियाँ सत्र के निर्णय पर चेतावनी के रूप में दिखाई जाती हैं, और इन्हें मैन्युअल समीक्षा शुरू करने के लिए कॉन्फ़िगर किया जा सकता है।## दस्तावेज़ निगरानी और पुनः सत्यापनउन उपयोग-मामलों के लिए जिनमें दस्तावेज़ की वैधता लगातार जाँचनी हो (जैसे समाप्त हो चुकी ID):- **दस्तावेज़ समाप्ति** हर सत्यापित ID पर ट्रैक की जाती है। सत्र के निर्णय में `expiration_date` फ़ील्ड देखें।
- **दस्तावेज़ निगरानी** डिफ़ॉल्ट रूप से चालू और स्वचालित है: इसे सक्षम करने की ज़रूरत नहीं है। जब ID की समाप्ति तिथि निकल जाती है, तो `"Approved"` सत्र `"Kyc Expired"` पर चला जाता है, ID सत्यापन परिणाम में `DOCUMENT_EXPIRED` चेतावनी जुड़ जाती है, और `status.updated` webhook फ़ायर होता है। तिथि निकलने से पहले कोई चेतावनी नहीं भेजी जाती।
- **इसे बंद करना** — [पहचान सत्यापन सेटिंग्स](https://docs.didit.me/hi/core-technology/id-verification/overview.md) में उस देश और दस्तावेज़ प्रकार के लिए **Expiration mode** को **Allow expired** पर सेट करें। डिफ़ॉल्ट **Reject expired** वह मोड है जिसमें निगरानी होती है। **Allow expired** के साथ स्वीकृत दस्तावेज़ की कभी निगरानी नहीं होती।
- **पुनः सत्यापन** — दस्तावेज़ ताज़ा करने के लिए उसी `vendor_data` पर नया सत्र शुरू करें।## दस्तावेज़ जियोलोकेशन[ID दस्तावेज़ जियोलोकेशन](https://docs.didit.me/hi/core-technology/id-verification/document-geolocation-id-verification.md) जाँच सबमिट करने वाले व्यक्ति के IP स्थान की तुलना ID के जारीकर्ता देश से करती है। परिणाम सत्र के निर्णय से जुड़े होते हैं।## गोपनीयता और प्रतिधारण- सभी दस्तावेज़ स्थिर अवस्था में एन्क्रिप्टेड होते हैं।
- इमेज तक पहुँच अल्पकालिक साइन किए गए URL के ज़रिए होती है।
- प्रतिधारण एप्लिकेशन की [डेटा प्रतिधारण](https://docs.didit.me/hi/console/data-retention.md) नीति का पालन करता है।
- उपयोगकर्ताओं को हटाने का अनुरोध करने का अधिकार है; हटाने से इमेज, OCR से निकाला गया डेटा और NFC डेटा हट जाते हैं।## अगले चरण> [card] [पहचान सत्यापन](https://docs.didit.me/hi/core-technology/id-verification/overview.md)
>
> ID कैप्चर और OCR कैसे काम करते हैं।> [card] [पते का प्रमाण](https://docs.didit.me/hi/core-technology/proof-of-address/overview.md)
>
> POA दस्तावेज़ संग्रह।> [card] [सत्र निर्णय](https://docs.didit.me/hi/sessions-api/retrieve-session.md)
>
> GET /v3/session/{id}/decision/ संदर्भ।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.