الانتقال إلى المحتوى الرئيسي
POST
curl
استخدم هذا الإجراء عندما يكون الرابط السابق غير صالح: إما أن الجلسة حُذفت، أو انتهت صلاحيتها قبل أن يبدأ الشخص فيها أصلاً. تنطبق هذه الحالة على الجلسات المحذوفة حتى لو كان الشخص قد بدأ التحقق أو أنهاه بالفعل. لا تكون الجلسات المستوردة مؤهلةً بسبب انتهاء الصلاحية؛ بل يجب أن تكون قد حُذفت. ولا تُؤهَّل بسبب انتهاء الصلاحية الجلسة التي لم تُحذف وبدأ الشخص فيها بالفعل. ترتبط الجلسة الجديدة بالطرف نفسه، لذلك تُغذّي نتيجتها فحص الأشخاص الرئيسيين كما كانت ستفعل الجلسة الأصلية، ويبقى رابطها صالحاً للمدة المحددة لانتهاء صلاحية الجلسة في سير عمل KYC الذي تُشغّله (من ساعة واحدة إلى 4 أسابيع)، لا مدة انتهاء صلاحية جلسة الشركة. راجع الطرف وجلساته الفرعية في قرار جلسة الشركة. إذا كان ينبغي عدم التحقق من الشخص إطلاقاً، فبدلاً من ذلك تخطَّ الطرف. راجع الأشخاص الرئيسيون لمعرفة كيفية عمل الأطراف وعمليات التحقق الخاصة بها.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

sessionId
string<uuid>
مطلوب

معرّف UUID لجلسة التحقق من الشركات (KYB) الأصلية (الأب).

مثال:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
مطلوب

معرّف UUID لطرف الأشخاص الرئيسيين (key_people_checks[].submitted.parties[].uuid في قرار جلسة الشركة). يجب أن ينتمي إلى الجلسة المُشار إليها بواسطة sessionId.

مثال:

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

الاستجابة

تم إنشاء جلسة KYC جديدة. يُرجع الطرف المحدّث مع جلسته الفرعية الجديدة، والتي تنتهي صلاحيتها بعد مدة انتهاء صلاحية جلسة سير عمل KYC الخاص بها.

طرف من الأشخاص الرئيسيين (Key People) في جلسة التحقق من الشركات (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 الفرعية. يكون null عند عدم وجود جلسة أو إذا تم حذفها، وكذلك لمفتاح API ذي نطاق محدد دون صلاحية sessions: write.

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 للشخص الذي تم التحقق منه، بمجرد معرفته.

آخر تعديل في ٧ نوفمبر ٢٠٢٦