> ## 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 entity का हर फ़ील्ड: पहचान, स्थिति, KYC सेशन, बायोमेट्रिक, गतिविधि टाइमस्टैम्प और मेटाडेटा। मूल्य निर्धारण प्रति उपयोग।

यह पेज User entity के हर फ़ील्ड का दस्तावेज़ीकरण करता है। फ़ील्ड पाँच समूहों में बाँटे गए हैं: पहचान, स्थिति, सत्र सारांश, गतिविधि टाइमस्टैम्प और मेटाडेटा।

## पहचान फ़ील्ड

| फ़ील्ड | प्रकार | विवरण |
| - | - | - |
| `uuid` | UUID | Didit द्वारा असाइन की गई प्राथमिक कुंजी। स्थिर और अद्वितीय। |
| `didit_internal_id` | string | मानव-पठनीय आंतरिक पहचानकर्ता (API प्रतिक्रियाओं में दिखाई देता है)। |
| `vendor_data` | string | उपयोगकर्ता के लिए आपका पहचानकर्ता। प्रत्येक एप्लिकेशन के लिए अद्वितीय। [और पढ़ें](https://docs.didit.me/hi/entities/vendor-data-linking.md)। |
| `display_name` | string | कंसोल में दिखाया जाने वाला ओवरराइड नाम। सेट न होने पर `full_name` या `vendor_data` डिफ़ॉल्ट रूप से उपयोग होता है। |
| `full_name` | string | नवीनतम स्वीकृत उपयोगकर्ता सत्यापन (KYC) सत्र के पहचान दस्तावेज़ से प्रसारित पूरा कानूनी नाम। |
| `date_of_birth` | date (ISO 8601) | नवीनतम स्वीकृत उपयोगकर्ता सत्यापन (KYC) सत्र से प्रसारित। |
| `portrait_image` | URL | नवीनतम स्वीकृत लाइवनेस जाँच की सेल्फ़ी के लिए साइन किया गया S3 URL। |

> [!NOTE]
>
> `full_name`, `date_of_birth` और `portrait_image` सत्यापित सत्र से प्राप्त होने पर केवल-पढ़ने योग्य होते हैं। आप इन्हें कंसोल के माध्यम से या `PATCH /v3/users/{vendor_data}/` से ओवरराइड कर सकते हैं, लेकिन मैन्युअल ओवरराइड ऑडिट लॉग में चिह्नित किए जाते हैं।

## स्थिति

| फ़ील्ड | प्रकार | मान | विवरण |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | भविष्य के सत्रों और लेन-देन के लिए प्रवर्तन नियंत्रित करता है। देखें [जीवनचक्र](https://docs.didit.me/hi/entities/lifecycle.md)। |

## सत्र सारांश फ़ील्ड

ये फ़ील्ड Didit द्वारा गणना किए जाते हैं और सत्र पूरे होने के साथ वास्तविक समय में अपडेट होते हैं।

| फ़ील्ड | प्रकार | विवरण |
| - | - | - |
| `session_count` | int | इस उपयोगकर्ता के लिए अब तक बनाए गए कुल सत्र |
| `approved_count` | int | वे सत्र जो `APPROVED` पर समाप्त हुए |
| `declined_count` | int | वे सत्र जो `DECLINED` पर समाप्त हुए |
| `in_review_count` | int | वर्तमान में समीक्षाधीन (`IN_REVIEW`) सत्र |
| `issuing_states[]` | ISO देश कोड का array | सभी सत्रों में सत्यापित पहचान दस्तावेज़ों के जारीकर्ता देश |
| `approved_emails[]` | strings का array | [ईमेल सत्यापन](https://docs.didit.me/hi/core-technology/email-verification/overview.md) के माध्यम से सत्यापित ईमेल |
| `approved_phones[]` | strings का array | [फ़ोन सत्यापन](https://docs.didit.me/hi/core-technology/phone-verification/overview.md) के माध्यम से सत्यापित फ़ोन नंबर |
| `features` | object | सभी सत्रों में प्रत्येक फ़ीचर की नवीनतम स्थिति |

### `features` मैप

हर सत्र में एक या अधिक सुविधाएँ चलती हैं (पहचान सत्यापन, लाइवनेस, चेहरा मिलान, AML, POA, NFC, आदि)। `features` मैप इस उपयोगकर्ता के लिए हर सुविधा की **नवीनतम** स्थिति रखता है:

```json theme={null}
{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}
```

सुविधा स्थितियाँ: `NOT_FINISHED`, `APPROVED`, `DECLINED`, `IN_REVIEW`, `EXPIRED`, `ABANDONED`, `RESUB_REQUESTED`।

यह जानने के लिए `features` मैप को त्वरित तरीके के रूप में उपयोग करें कि "क्या यह उपयोगकर्ता अभी पूरी तरह सत्यापित है?", सभी सत्रों को एक-एक करके जाँचे बिना।

## गतिविधि टाइमस्टैम्प

| फ़ील्ड | प्रकार | कब अपडेट होता है |
| - | - | - |
| `first_session_at` | ISO timestamp | पहला सत्र बनाए जाने पर |
| `last_session_at` | ISO timestamp | सबसे हाल का सत्र बनाए जाने या अपडेट किए जाने पर |
| `last_activity_at` | ISO timestamp | कोई भी बदलाव: सत्र, लेन-देन, स्थिति, प्रोफ़ाइल, नोट्स, टैग |
| `created_at` | ISO timestamp | एंटिटी पंक्ति बनाए जाने पर |
| `updated_at` | ISO timestamp | एंटिटी पंक्ति के अंतिम बार अपडेट होने पर |

## मेटाडेटा

| फ़ील्ड | प्रकार | विवरण |
| - | - | - |
| `metadata` | object (JSON) | आपके नियंत्रण वाला मुक्त-रूप JSON। आंतरिक टैग, स्तर, साइनअप स्रोत, आदि के लिए उपयोग करें। |
| `tags[]` | array | फ़िल्टरिंग और समूहीकरण के लिए कंसोल/API द्वारा प्रबंधित टैग |

मेटाडेटा की कोई स्कीमा नहीं है: आप जो भी लिखते हैं, Didit उसे सहेजता है।

## संबंध (उपयोगकर्ता पंक्ति में संग्रहीत नहीं)

| संबंध | कैसे प्राप्त करें |
| - | - |
| सत्र | `GET /v3/sessions?vendor_data=<value>` |
| लेन-देन (आवेदक के रूप में) | `GET /v3/transactions/?vendor_data=<value>` |
| लेन-देन (प्रतिपक्ष के रूप में) | कंसोल में प्रतिपक्ष के vendor\_data से लेन-देन सूची फ़िल्टर करें |
| जुड़े हुए व्यवसाय (निदेशक / UBO) | कंसोल में उपयोगकर्ता विवरण पेज पर दिखाए जाते हैं |
| चेहरे के बायोमेट्रिक्स | कंसोल + Lists API |
| ब्लॉकलिस्ट प्रविष्टियाँ | [Lists API](https://docs.didit.me/hi/management-api/lists/overview.md) — उपयोगकर्ता के पहचानकर्ताओं से प्रविष्टियाँ फ़िल्टर करें |

## उदाहरण प्रतिक्रिया

```json theme={null}
{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}
```

## अगले चरण

> [card] [संचालन](https://docs.didit.me/hi/entities/users/operations.md)
>
> बनाएँ, अपडेट करें, स्थिति बदलें, हटाएँ।

> [card] [KYC इतिहास](https://docs.didit.me/hi/entities/users/kyc-history.md)
>
> उपयोगकर्ता से जुड़े हर सत्र को प्राप्त करें।

> [card] [API संदर्भ](https://docs.didit.me/hi/management-api/users/get.md)
>
> GET /v3/users/{vendor_data}/ स्कीमा।


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