उपयोगकर्ता

उपयोगकर्ता डेटा मॉडल: विक्रेता उपयोगकर्ता स्कीमा

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

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

पहचान फ़ील्ड

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

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

स्थिति

फ़ील्ड	प्रकार	मान	विवरण
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	भविष्य के सत्रों और लेन-देन के लिए प्रवर्तन नियंत्रित करता है। देखें जीवनचक्र।

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

ये फ़ील्ड 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	ईमेल सत्यापन के माध्यम से सत्यापित ईमेल
`approved_phones[]`	strings का array	फ़ोन सत्यापन के माध्यम से सत्यापित फ़ोन नंबर
`features`	object	सभी सत्रों में प्रत्येक फ़ीचर की नवीनतम स्थिति

`features` मैप

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

{
  "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 — उपयोगकर्ता के पहचानकर्ताओं से प्रविष्टियाँ फ़िल्टर करें

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

{
  "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" }
}

अगले चरण

संचालन

बनाएँ, अपडेट करें, स्थिति बदलें, हटाएँ।

KYC इतिहास

उपयोगकर्ता से जुड़े हर सत्र को प्राप्त करें।

API संदर्भ

GET /v3/users// स्कीमा।

अंतिम संशोधन 7 नवंबर 2026

अवलोकन

मूल्य निर्धारण

वर्कफ़्लो और सत्यापन

समीक्षा और संचालन

एंटिटी (उपयोगकर्ता और व्यवसाय)

सेटिंग्स और कस्टमाइज़ेशन

सुरक्षा और अनुपालन

Didit Academy

संसाधन

उपयोगकर्ता डेटा मॉडल: विक्रेता उपयोगकर्ता स्कीमा

पहचान फ़ील्ड

स्थिति

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

`features` मैप

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

मेटाडेटा

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

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

अगले चरण

संचालन

KYC इतिहास

API संदर्भ

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

​स्थिति

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

​features मैप

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

​मेटाडेटा

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

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

​अगले चरण

संचालन

KYC इतिहास

API संदर्भ

पहचान फ़ील्ड

स्थिति

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

`features` मैप

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

मेटाडेटा

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

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

अगले चरण