استيراد الجلسة المشتركة API: KYC القابل لإعادة الاستخدام

قائمة بميزات التحقق التي تم تكوينها لهذه الجلسة، كأسماء عرض: ID_VERIFICATION، و NFC، و LIVENESS، و FACE_MATCH، و POA، و PHONE، و EMAIL_VERIFICATION، و AML، و IP_ANALYSIS، و DATABASE_VALIDATION، و QUESTIONNAIRE، و AGE_ESTIMATION، و FACE_SEARCH، و GEOLOCATION (التحقق من الموقع) (تستخدم جلسات التحقق من الشركات (KYB) مجموعة ميزات KYB: KYB_REGISTRY، و KYB_DOCUMENTS، و KYB_KEY_PEOPLE، و AML، و PHONE، و EMAIL_VERIFICATION، و IP_ANALYSIS، و QUESTIONNAIRE). عند استخدام include=events، يصبح كل إدخال كائناً {feature, node_id} بدلاً من سلسلة نصية بسيطة، وتتم إعادة تسمية ميزة البريد الإلكتروني: تظهر كـ EMAIL في وضع الأحداث بدلاً من EMAIL_VERIFICATION المستخدمة هنا.

مصفوفة من تقارير التحقق من الهوية (OCR) التي تم إنشاؤها بواسطة خطوات مستند الهوية في مخطط سير العمل. دائماً ما تكون مصفوفة JSON — اقرأ id_verifications[0] وكرّر القراءة إذا كان بإمكان سير العمل لديك تشغيل أكثر من فحص هوية واحد (على سبيل المثال، فحص أساسي بالإضافة إلى فحص إضافي). تكون null حتى تُنتج خطوة هوية واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وحقول المستند المستخرجة، وعناوين URL للصور، ودرجات الجودة، وMRZ، وتحليل العنوان، والتطابقات عبر الجلسات، وwarnings[].

مصفوفة من تقارير التحقق عبر NFC / جواز السفر الإلكتروني الناتجة عن خطوات NFC في مخطط سير العمل. هذه دائماً مصفوفة JSON، وليست كائن nfc مفرداً أبداً — اقرأ nfc_verifications[0] وكرّر القراءة إذا كان بإمكان سير العمل لديك تشغيل NFC أكثر من مرة. تكون null حتى تُنتج خطوة NFC واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وchip_protocol، وchip_data، وauthenticity (سلامة SOD + DG)، وcertificate_summary، وwarnings[]. تتم قراءة بطاقة My Number اليابانية عبر JPKI بدلاً من ICAO 9303: يحتوي عنصرها على chip_protocol: "jpki"، ويحمل أدلته تحت jpki، ويترك حقول ICAO بقيمة null. عندما يتم تجاوز خطوة NFC قبل أن تُتاح للمستخدم أصلاً (مستند بدون شريحة، أو شهادة مفقودة، أو عدم الإبلاغ عن إمكانية NFC، أو مفتاح MRZ غير قابل للقراءة، أو عدم توفر JPKI لبطاقة My Number)، يظل هذا الحقل null ويوضح nfc_skip_reason السبب؛ أما التخطي في الخطوة نفسها (نقر المستخدم على تخطٍّ، أو تبيّن عدم توفر القارئ في وقت المسح) فيظل يُنتج تقريراً مع is_nfc_skipped: true.

مصفوفة من تقارير كشف الحيوية التي تم إنشاؤها بواسطة خطوات كشف الحيوية في مخطط سير العمل. دائماً ما تكون مصفوفة JSON — وليست كائن liveness مفرداً أبداً. تكون null حتى تنتج خطوة كشف حيوية واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وmethod، وscore، وreference_image، وvideo_url، وage_estimation الاختياري، وmatches[] عبر الجلسات، وwarnings[].

مصفوفة من تقارير مطابقة الوجه التي تم إنشاؤها بواسطة خطوات مطابقة الوجه في مخطط سير العمل. دائماً ما تكون مصفوفة JSON — وليست كائن face_match مفرداً أبداً. تكون null حتى تنتج خطوة مطابقة وجه واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وscore التشابه، وsource_image، وtarget_image، وwarnings[].

مصفوفة من تقارير التحقق من رقم الهاتف — دائماً ما تكون مصفوفة JSON، وليست كائن phone مفرداً أبداً. تكون null حتى تنتج خطوة هاتف واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، ورقم الهاتف والبيانات الوصفية للدولة، وlifecycle[]، وmatches[]، وwarnings[].

مصفوفة من تقارير التحقق من البريد الإلكتروني — دائماً ما تكون مصفوفة JSON، وليست كائن email مفرداً أبداً. تكون null حتى تنتج خطوة بريد إلكتروني واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وعنوان البريد الإلكتروني، وبيانات الاختراق، وlifecycle[]، وmatches[]، وwarnings[].

مصفوفة من تقارير إثبات العنوان (POA) — دائماً ما تكون مصفوفة JSON، وليست كائن poa مفرداً أبداً. تكون null حتى تنتج خطوة إثبات عنوان واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وعنوان URL لملف المستند، والجهة المصدرة، والتواريخ، والعنوان المحلل، وwarnings[].

تقارير Document AI مجمّعة حسب عقدة سير العمل — تكون دائماً مصفوفة JSON، وليست كائناً مفرداً أبداً. وتكون null حتى تنتج خطوة Document AI واحدة على الأقل بيانات. تظهر فقط عندما يكون session_kind = user. كل عنصر هو مجموعة عقدة مع status إجمالي، وnode_id، ومصفوفة items[] لنتائج كل مستند (البيانات المستخرجة مرتبطة بمفتاح الحقل المكوّن)، وwarnings.

مصفوفة من تقارير إجابات الاستبيانات — دائماً ما تكون مصفوفة JSON، وليست كائن questionnaire مفرداً أبداً. تكون null حتى تنتج خطوة استبيان واحدة على الأقل بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، والبيانات الوصفية للاستبيان، والأقسام التي تحتوي على عناصر النموذج، وإجابات المستخدم.

نتائج التحقق البنكي، عنصر واحد لكل خطوة تحقق بنكي، للتحقق من المستخدمين والتحقق من الشركات. تكون null حتى تُنتج خطوة نتيجة ما. يوضح حقل method لكل عنصر كيفية التحقق من الحساب: open_banking (تسجيل الدخول إلى البنك) أو account_lookup (فحص الحساب)، أو خيار بديل عبر statement أو microdeposits، وnone عندما يتابع الشخص دون بنك قبل تقييم أي محاولة (continued_without_bank). راجع طرق التحقق البنكي.

نتائج التوقيع الإلكتروني، عنصر واحد لكل موقّع وخطوة توقيع، لكل من التحقق من المستخدمين والتحقق من الشركات (KYB). لا تظهر إلا عندما يتضمن سير العمل خطوة التوقيع الإلكتروني؛ وهي مصفوفة فارغة حتى يصل أحد الموقّعين إليها. راجع تقرير التوقيع الإلكتروني.

مصفوفة تقارير فحص AML — دائماً مصفوفة JSON، وليست أبداً كائن aml مفرداً. تكون null إلى أن تُنتج خطوة AML واحدة على الأقل بيانات. كل عنصر هو التقرير الكامل، بما يشمل node_id، وstatus على مستوى الميزة، وtotal_hits، وentity_type، وhits[]، وscore، وscreened_data، وis_ongoing_monitoring_enabled، وwarnings[].

مصفوفة من تقارير تحليل الجهاز وعنوان IP — دائماً ما تكون مصفوفة JSON، وليست كائن ip_analysis مفرداً أبداً. تكون null حتى تنتج خطوة واحدة على الأقل من خطوات تحليل IP بيانات. يمثل كل عنصر التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وبيانات IP وتحديد الموقع الجغرافي، وبصمة الجهاز، وwarnings[]. يتم إزالة التكرار من المدخلات ذات (node_id, ip_address, device_fingerprint) المكررة من جانب الخادم.

مصفوفة من نتائج التحقق من الموقع، نتيجة واحدة لكل خطوة تحقق من الموقع: المحاولة المقبولة لتلك الخطوة. تكون null حتى تنتج خطوة تحقق من الموقع بيانات. توجد المحاولات السابقة للخطوة نفسها في geolocation_attempts.

كل محاولة لكل خطوة تحقق من الموقع في هذه الجلسة، الأقدم أولاً. يتم استبعاد المحاولات التي استُبدلت بإعادة الإرسال. وسير العمل الذي يحجب geolocation_checks من خلال سمات الاستجابة الخاصة به يحجب هذه القائمة أيضاً.

مصفوفة تقارير التحقق من قواعد البيانات — دائماً مصفوفة JSON، وليست أبداً كائن database_validation مفرداً. تكون null حتى تُنتج خطوة تحقق من قاعدة البيانات واحدة على الأقل بياناتٍ. كل عنصر هو التقرير الكامل، بما في ذلك node_id، وstatus على مستوى الميزة، وscreened_data، ومصفوفة validations[] لكل خدمة (يحتوي كل منها على source_data الخاص بالسجل)، وwarnings[]. تختلف حقول screened_data وsource_data بحسب الدولة:

ARG (الأرجنتين): screened_data: {document_number, selfie, gender, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, date_of_death, tax_id, tax_id_type, face_match_score, sit_1_since, banks, last_position, highest_position, rejected_checks}. يستخدم التحقق البيومتري لمطابقة الوجه من RENAPER. يُستنتج الجنس تلقائياً من تحليل الوجه أو الاسم الأول عندما لا يكون متوفراً في المستند (مثل رخص القيادة)

BOL (بوليفيا): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender}

BRA (البرازيل): screened_data: {tax_number, first_name, last_name, date_of_birth}. يتضمن source_data دائماً {identification_number, first_name, last_name, date_of_birth, lgpd_minor, minor_under_18, minor_under_16} لعمليات تطابق CPF الناجحة. تُعيّن عمليات البحث الناجحة للبالغين تلك العلامات إلى false. قد تُرجع خدمة Receita Federal Consulta CPF الرمز HTTP 422 (قاصر دون 18 عاماً) أو 451 (دون 16 عاماً) مع حجب البيانات بموجب LGPD؛ في هذه الحالات، يُعيّن source_data علامات القاصرين إلى true بحسب الاقتضاء، ويتضمن حالة HTTP الواردة، ويكون التحقق على مستوى الحقل no_match. راجع قسم البرازيل في مرجع رموز نتائج التحقق من قواعد البيانات للاطلاع على القائمة الكاملة للرموز.

CHL (تشيلي): screened_data: {personal_number, first_name, last_name, date_of_birth}. source_data: {identification_number, first_name, last_name, date_of_birth, gender}

COL (كولومبيا): screened_data: {document_number, document_type, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, document_type}

CRI (كوستاريكا): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

DOM (جمهورية الدومينيكان): screened_data: {personal_number}. source_data: {identification_number} (يُرجع valid/invalid فقط)

ECU (الإكوادور): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, street, formatted_address, gender, nationality, education, marital_status, spouse, mother_name, father_name, profession}

ESP (إسبانيا): screened_data: {personal_number, document_type, expiration_date, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, document_type, expiration_date}

GTM (غواتيمالا): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

HND (هندوراس): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

MEX (المكسيك): screened_data: {personal_number (CURP), first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender, nationality, curp_status, state_of_birth, doc_probatorio, registration_year, registration_state, registration_municipality, num_acta, crip, issuing_state_code, foreign_registry_number, folio_carta, folio_certificado}. يستخدم السجل المدني RENAPO. تتوفر أيضاً خدمة منفصلة للتحقق من صلاحية INE لـ MEX كعملية تحقق فردية إضافية.

PAN (بنما): screened_data: {personal_number, selfie}. source_data: {identification_number}. يستخدم التحقق البيومتري من SIB

PER (بيرو): screened_data: {personal_number (DNI), first_name, last_name}. source_data: {identification_number, first_name, last_name, paternal_name, maternal_name, verification_number, verification_letter}

PRY (باراغواي): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

SLV (السلفادور): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

URY (أوروغواي): screened_data: {personal_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

VEN (فنزويلا): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, gender, date_of_birth, document_type}

عمليات التحقق من سجل الشركات. تكون موجودة فقط عندما تكون session_kind = business. يغلّف كل عنصر payload سجل الشركات بالكامل.

فحوصات مجمعة للأشخاص الرئيسيين. تظهر فقط عندما يكون session_kind = business. يستخدم كل عنصر بنية من قسمين (registry، submitted، ubo_kyc_summary).

عمليات التحقق من المستندات مجمّعة حسب عقدة سير العمل. تظهر فقط عندما يكون session_kind = business.

يتم إرجاعها فقط مع include=resubmissions، لجلسات المستخدمين والشركات. مدخل واحد لكل طلب إعادة تقديم، من الأقدم إلى الأحدث. يحمل كل مدخل النتائج التي أرجعتها الخطوات المعاد تقديمها قبل الطلب، بحيث تظل عمليات الإرسال السابقة قابلة للقراءة. يؤدي حذف الجلسة إلى حذف كل عملية إرسال.