> ## 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.

# Sessions API: एकीकृत KYC और KYB सत्यापन

> Didit का Sessions API एक endpoint पर KYC और KYB देता है। प्रति-उपयोग मूल्य, sub-2s, 220+ देश, 14,000+ दस्तावेज़, $10 मासिक निःशुल्क क्रेडिट।

सत्र Didit पर सत्यापन की इकाई होते हैं। जब आप सत्यापन शुरू करते हैं, तो एक **सत्र** बनता है; जब सत्यापन पूरा हो जाता है, तो सत्र में पूरा निर्णय payload होता है। यही सत्र API दोनों प्रकारों को संभालती है:

| प्रकार | क्या सत्यापित करता है | निर्णय payload में शामिल है |
| - | - | - |
| **उपयोगकर्ता सत्यापन (KYC) सत्र** | एक व्यक्ति | पहचान सत्यापन, लाइवनेस डिटेक्शन, चेहरा मिलान, पते का प्रमाण (POA), NFC, डेटाबेस सत्यापन, फ़ोन सत्यापन, ईमेल सत्यापन, AML स्क्रीनिंग, प्रश्नावलियाँ, डिवाइस और IP विश्लेषण |
| **व्यवसाय सत्यापन (KYB) सत्र** | एक कंपनी / कानूनी इकाई | कंपनी रजिस्ट्री जाँच, प्रमुख व्यक्ति (अधिकारी/UBOs), दस्तावेज़ सत्यापन, फ़ोन सत्यापन, ईमेल सत्यापन, AML स्क्रीनिंग, प्रश्नावलियाँ, डिवाइस और IP विश्लेषण |

Didit Academy के उस पाठ में, जिसमें बताया गया है कि उपयोगकर्ता क्या देखते हैं, 5:34 वाला अध्याय होस्टेड फ़्लो की तुलना अपनी स्क्रीन बनाने से करता है। यही वह ट्रेड-ऑफ़ है जिसका निर्णय यह API आपके लिए लेती है।

[होस्टेड फ़्लो बनाम अपनी स्क्रीन बनाना | Didit Academy](https://www.youtube.com/embed/LzGe-dMWjUw?start=334\&rel=0\&playsinline=1)

## प्रकार वर्कफ़्लो तय करता है

जब आप [सत्र बनाते](https://docs.didit.me/hi/sessions-api/create-session.md) हैं, तो आप `workflow_id` पास करते हैं। वर्कफ़्लो का प्रकार तय करता है कि सत्र उपयोगकर्ता सत्यापन होगा या व्यवसाय सत्यापन; कॉलर इसे अलग से नहीं चुनते। KYB वर्कफ़्लो व्यवसाय सत्यापन सत्र बनाते हैं; KYC वर्कफ़्लो उपयोगकर्ता सत्यापन सत्र बनाते हैं।

## `session_kind` डिस्क्रिमिनेटर

सत्र बनाने, प्राप्त करने, सूचीबद्ध करने, स्थिति अपडेट करने, साझा करने और इंपोर्ट करने से मिलने वाली हर प्रतिक्रिया में एक टॉप-लेवल फ़ील्ड शामिल होता है:

```json theme={null}
{
  "session_id": "...",
  "session_kind": "user",
  ...
}
```

* `"user"`: सत्र **उपयोगकर्ता सत्यापन (KYC) सत्र** है। प्रतिक्रिया में उपयोगकर्ता-विशिष्ट सुविधा ऐरे होते हैं।
* `"business"`: सत्र **व्यवसाय सत्यापन (KYB) सत्र** है। प्रतिक्रिया में व्यवसाय-विशिष्ट सुविधा ऐरे होते हैं।

अपनी तरफ़ से प्रतिक्रिया के ढाँचे के आधार पर स्विच करने के लिए इस फ़ील्ड का उपयोग करें।

> [!NOTE]
>
> Enum मान छोटे पहचानकर्ता `"user"` और `"business"` हैं। हमने API की सुविधा के लिए इन्हें छोटा रखा है। पूरे नाम **उपयोगकर्ता सत्यापन (KYC)** और **व्यवसाय सत्यापन (KYB)** पूरे दस्तावेज़ में स्पष्टता के लिए इस्तेमाल होते हैं।

## प्रकार के अनुसार सुविधा ऐरे

किसी निर्णय में मौजूद सुविधा ऐरे प्रकार पर निर्भर करते हैं। जो फ़ील्ड एक प्रकार में नहीं होते, वे उस प्रकार की प्रतिक्रिया में दिखाई ही नहीं देते (कोई null नहीं, कोई placeholder नहीं):

| सुविधा ऐरे | उपयोगकर्ता सत्यापन (KYC) | व्यवसाय सत्यापन (KYB) |
| - | :-: | :-: |
| `id_verifications` | ✅ | — |
| `liveness_checks` | ✅ | — |
| `face_matches` | ✅ | — |
| `nfc_verifications` | ✅ | — |
| `poa_verifications` | ✅ | — |
| `database_validations` | ✅ | — |
| `registry_checks` | — | ✅ |
| `document_verifications` | — | ✅ |
| `key_people_checks` | — | ✅ |
| `aml_screenings` | ✅ | ✅ |
| `phone_verifications` | ✅ | ✅ |
| `email_verifications` | ✅ | ✅ |
| `questionnaire_responses` | ✅ | ✅ |
| `ip_analyses` | ✅ | ✅ |
| `reviews` | ✅ | ✅ |
| `contact_details` | ✅ | ✅ |

## साझा शीर्ष-स्तरीय फ़ील्ड

हर सत्र (दोनों प्रकार) में ये फ़ील्ड होते हैं:

| फ़ील्ड | विवरण |
| - | - |
| `session_id` | सत्र का UUID |
| `session_kind` | `"user"` (उपयोगकर्ता सत्यापन / KYC) या `"business"` (व्यवसाय सत्यापन / KYB) |
| `session_number` | आवेदन के भीतर क्रमिक संख्या |
| `session_url` | होस्टेड सत्यापन URL |
| `status` | समग्र सत्र स्थिति: `APPROVED`, `DECLINED`, `IN_REVIEW`, `IN_PROGRESS` आदि |
| `workflow_id` | इस्तेमाल किए गए वर्कफ़्लो का UUID |
| `vendor_data` | इकाई के लिए आपका पहचानकर्ता। [और जानें](https://docs.didit.me/hi/entities/vendor-data-linking.md) |
| `metadata` | निर्माण के समय आपके द्वारा जोड़ा गया फ़्री-फ़ॉर्म JSON |
| `callback` | वैकल्पिक कॉलबैक URL |
| `features` | वर्कफ़्लो द्वारा चलाई जाने वाली सुविधा सूची, अल्पविराम से अलग |
| `expected_details` | क्रॉस-वैलिडेशन के लिए वैकल्पिक अपेक्षित-डेटा payload |
| `created_at`, `expires_at` | टाइमस्टैम्प |

## कवर किए गए endpoints

निम्नलिखित endpoints दोनों प्रकार स्वीकार करते हैं। कोई अलग `/v3/business-session/*` path नहीं है।

| Endpoint | किसके लिए काम करता है |
| - | - |
| [`POST /v3/session/`](https://docs.didit.me/hi/sessions-api/create-session) | वर्कफ़्लो प्रकार के आधार पर उपयोगकर्ता सत्यापन या व्यवसाय सत्यापन सत्र बनाता है |
| [`GET /v3/session/{id}/decision/`](https://docs.didit.me/hi/sessions-api/retrieve-session) | कोई भी प्रकार लौटाता है; `session_id` के आधार पर तय होता है |
| [`GET /v3/sessions/`](https://docs.didit.me/hi/sessions-api/list-sessions) | दोनों प्रकार सूचीबद्ध करता है। फ़िल्टर करने के लिए `session_kind` क्वेरी पैरामीटर इस्तेमाल करें |
| [`PATCH /v3/session/{id}/update-status/`](https://docs.didit.me/hi/sessions-api/update-status) | दोनों प्रकार अपडेट करता है |
| [`DELETE /v3/session/{id}/delete/`](https://docs.didit.me/hi/sessions-api/delete-session) | दोनों प्रकार हटाता है |
| [`GET /v3/session/{id}/generate-pdf/`](https://docs.didit.me/hi/sessions-api/generate-pdf) | दोनों प्रकारों के लिए PDF बनाता है; सही टेम्पलेट (उपयोगकर्ता सत्यापन या व्यवसाय सत्यापन) चुनता है |
| [`POST /v3/session/{id}/share/`](https://docs.didit.me/hi/sessions-api/share-session/share) | साझा करने के token में `session_kind` शामिल होता है |
| [`POST /v3/session/import-shared/`](https://docs.didit.me/hi/sessions-api/share-session/import) | दोनों प्रकार इंपोर्ट करता है; token से `session_kind` सुरक्षित रखता है |

## खोज कैसे काम करती है

उपयोगकर्ता सत्यापन और व्यवसाय सत्यापन सत्र दो अलग प्रकार हैं। IDs UUID होते हैं, इसलिए टकराव असंभव है। जब आप `session_id` के साथ किसी endpoint को कॉल करते हैं, तो Didit:

1. पहले उपयोगकर्ता सत्यापन तालिका में ID खोजता है (अधिकांश ट्रैफ़िक यहीं आता है)।
2. न मिलने पर व्यवसाय सत्यापन तालिका में खोजता है।
3. अगर दोनों में से किसी तालिका में मिलान नहीं है, तो 404 लौटाता है।

आपको API को यह बताने की ज़रूरत नहीं होती कि आप कौन-सा प्रकार खोज रहे हैं।

## स्थितियाँ दोनों प्रकारों में एक जैसी हैं

स्थिति मान दोनों प्रकारों के लिए एक जैसे हैं, और API उन्हें यहाँ लिखे गए रूप में ही लौटाता है: `"Not Started"`, `"In Progress"`, `"Approved"`, `"Declined"`, `"In Review"`, `"Abandoned"`, `"Expired"`, `"Kyc Expired"`, `"Resubmitted"`, `"Awaiting User"`। मिलान सटीक और केस-संवेदी है। पूरी सूची के लिए [सत्यापन स्थितियाँ](https://docs.didit.me/hi/integration/verification-statuses.md) देखें।

## webhook

webhook इवेंट में पहले से `session_kind` फ़ील्ड होता है, ताकि आपके webhook हैंडलर प्रकार के अनुसार इवेंट रूट कर सकें:

| इवेंट | प्रकार | कब ट्रिगर होता है |
| - | - | - |
| `status.updated` | दोनों | किसी सत्र की स्थिति बदलती है। payload में `session_kind: "user"` या `"business"` होता है। |
| `data.updated` | दोनों | किसी सत्र का डेटा बदलता है (सुविधा परिणाम, कंपनी रजिस्ट्री का अपडेट, सतत AML निगरानी)। payload में `session_kind` होता है। |
| `business.status.updated` / `business.data.updated` | व्यवसाय इकाई | जुड़ी हुई व्यवसाय इकाई बदलती है। |
| `user.status.updated` / `user.data.updated` | उपयोगकर्ता इकाई | जुड़ी हुई उपयोगकर्ता इकाई बदलती है। |

हस्ताक्षर सत्यापन और पुनः प्रयास के नियमों के लिए [webhook](https://docs.didit.me/hi/integration/webhooks.md) देखें, और व्यवसाय सत्यापन (KYB) इवेंट सूची के लिए [KYB webhook](https://docs.didit.me/hi/business-verification/webhooks.md) देखें।

## अगले चरण

> [card] [सत्र बनाएँ](https://docs.didit.me/hi/sessions-api/create-session.md)
>
> सत्यापन शुरू करें: उपयोगकर्ता सत्यापन या व्यवसाय सत्यापन (KYB)।

> [card] [सत्र प्राप्त करें](https://docs.didit.me/hi/sessions-api/retrieve-session.md)
>
> निर्णय प्राप्त करें। यह दोनों प्रकारों के लिए काम करता है।

> [card] [सत्र सूची](https://docs.didit.me/hi/sessions-api/list-sessions.md)
>
> `session_kind` के आधार पर फ़िल्टर करें।

> [card] [स्थिति अपडेट करें](https://docs.didit.me/hi/sessions-api/update-status.md)
>
> स्वीकृत करें, अस्वीकृत करें, समीक्षा करें, दोबारा सबमिट करें।

> [card] [PDF जनरेट करें](https://docs.didit.me/hi/sessions-api/generate-pdf.md)
>
> प्रकार के अनुसार PDF रिपोर्ट।

> [card] [शेयर + इंपोर्ट](https://docs.didit.me/hi/sessions-api/share-session/overview.md)
>
> सत्रों को एप्लिकेशन के बीच ले जाएँ।


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