मुख्य सामग्री पर जाएं
POST
curl
इसका उपयोग तब करें जब पिछला लिंक काम न कर रहा हो: सत्र हटा दिया गया हो, या व्यक्ति के इसे शुरू करने से पहले ही उसकी समय-सीमा समाप्त हो गई हो। हटाए गए सत्र योग्य हैं, भले ही व्यक्ति ने सत्यापन शुरू कर दिया हो या पूरा कर लिया हो। इंपोर्ट किए गए सत्र समाप्ति के आधार पर योग्य नहीं होते; उन्हें हटाया गया होना चाहिए। जो सत्र हटाया नहीं गया है और जिसे व्यक्ति पहले ही शुरू कर चुका है, वह समाप्ति के आधार पर योग्य नहीं है। नया सत्र उसी पार्टी से जुड़ा होता है, इसलिए उसका परिणाम प्रमुख व्यक्ति की जाँच में वैसे ही जाता है जैसे मूल सत्र का जाता। उसका लिंक उस KYC वर्कफ़्लो की सत्र समाप्ति अवधि तक चलता है जिसे वह चलाता है (1 घंटे से 4 हफ़्ते तक), न कि व्यवसाय सत्र की अवधि तक। पार्टी और उसके चाइल्ड सत्र पढ़ने के लिए व्यवसाय सत्र का निर्णय देखें। यदि व्यक्ति का सत्यापन बिल्कुल नहीं किया जाना चाहिए, तो इसके बजाय पार्टी को छोड़ें। पार्टी और उनके सत्यापन कैसे काम करते हैं, यह जानने के लिए प्रमुख व्यक्ति देखें।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

पथ पैरामीटर

sessionId
string<uuid>
आवश्यक

पैरेंट व्यवसाय सत्यापन (KYB) सत्र का UUID।

उदाहरण:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
आवश्यक

प्रमुख व्यक्ति पक्ष का UUID (व्यवसाय सत्र के निर्णय में key_people_checks[].submitted.parties[].uuid)। यह sessionId द्वारा संदर्भित सत्र से संबंधित होना चाहिए।

उदाहरण:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

प्रतिक्रिया

नया KYC सत्र बनाया गया। अपने नए चाइल्ड सत्र के साथ अपडेटेड पार्टी लौटाता है, जो इसके KYC वर्कफ़्लो के सत्र समाप्ति समय के बाद समाप्त हो जाता है।

व्यवसाय सत्यापन (KYB) सत्र की एक प्रमुख व्यक्ति पार्टी, उसके चाइल्ड सत्यापन के साथ। वही पार्टी व्यवसाय सत्र निर्णय के key_people_checks[].submitted.parties[] में दिखाई देती है।

uuid
string<uuid>
आवश्यक

पक्ष पहचानकर्ता।

entity_type
enum<string>
आवश्यक

क्या पक्ष कोई व्यक्ति है या कंपनी।

उपलब्ध विकल्प:
person,
company
source
enum<string>
आवश्यक

REGISTRY: कंपनी रजिस्ट्री से लिया गया। USER: Key People स्क्रीन में दर्ज किया गया।

उपलब्ध विकल्प:
REGISTRY,
USER
name
string
आवश्यक

पक्ष का डिस्प्ले नाम।

is_active
boolean
आवश्यक

क्या पक्ष सक्रिय है।

is_skipped
boolean
आवश्यक

क्या पक्ष सत्यापन से मुक्त है। पुनः जनरेट करने पर यह साफ़ हो जाता है।

requires_verification
boolean
आवश्यक

क्या भूमिका और स्वामित्व के नियमों को इस पक्ष के लिए सत्यापन की आवश्यकता है।

roles
object[]
आवश्यक

कंपनी में पक्ष द्वारा धारित भूमिकाएं।

kyc_session_deleted
boolean
आवश्यक

चाइल्ड KYC सत्र हटा दिया गया था, इसलिए यह कभी सेटल नहीं हो सकता।

kyb_sub_session_deleted
boolean
आवश्यक

kyc_session_deleted का कंपनी-पक्ष समकक्ष।

first_name
string | null

पहला नाम (व्यक्ति)।

last_name
string | null

अंतिम नाम (व्यक्तियों का)।

company_name
string | null

कंपनी का नाम (कंपनी पक्ष)।

registration_number
string | null

कंपनी पंजीकरण संख्या (कंपनी पक्ष)।

email
string<email> | null

वह ईमेल जिस पर सत्यापन लिंक भेजा जाता है।

nationality
string | null

व्यक्तियों के लिए राष्ट्रीयता, कंपनियों के लिए निगमन का देश।

phone_number
string | null

पक्ष के लिए एकत्र किया गया फ़ोन नंबर।

date_of_birth
string<date> | null

जन्म तिथि (व्यक्ति)।

position
string | null

मुक्त-पाठ पद का नाम (व्यक्तियों के लिए)।

custom_fields
object

वर्कफ़्लो-परिभाषित कस्टम फ़ील्ड जो पार्टी के लिए एकत्र किए गए हैं, फ़ील्ड कुंजी द्वारा अनुक्रमित।

kyc_session_id
string<uuid> | null

चाइल्ड व्यक्तिगत KYC सत्र (व्यक्ति)।

kyc_session_status
enum<string> | null

चाइल्ड KYC सत्र की स्थिति। हटाया गया सत्र वही स्थिति बनाए रखता है जो हटाए जाने के समय उसकी थी।

उपलब्ध विकल्प:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

चाइल्ड KYC सत्र का होस्टेड लिंक। जब कोई नहीं है या इसे हटा दिया गया था, और बिना sessions: write वाली स्कोप्ड API कुंजी के लिए null।

kyb_sub_session_id
string<uuid> | null

चाइल्ड KYB सत्र (कंपनी पक्षकार)।

kyb_sub_session_status
enum<string> | null

चाइल्ड KYB सत्र की स्थिति।

उपलब्ध विकल्प:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

चाइल्ड KYB सत्र का होस्टेड लिंक, उन्हीं null नियमों के साथ जो kyc_session_url के लिए हैं।

verification_workflow_type
enum<string> | null

वर्कफ़्लो का प्रकार जिसे चाइल्ड सत्र चलाता है।

उपलब्ध विकल्प:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

वर्कफ़्लो जो चाइल्ड सत्र चलाता है।

verification_workflow_label
string | null

उस वर्कफ़्लो का लेबल।

verification_workflow_features
object[] | null

चाइल्ड सत्र के वर्कफ़्लो की सुविधाएँ उनकी वर्तमान स्थिति के साथ।

didit_internal_id
string<uuid> | null

सत्यापित व्यक्ति का Didit पहचानकर्ता, ज्ञात होने पर।

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