> ## 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.

# API التحقق من قواعد البيانات: KYC عبر السجلات الحكومية

> يقدم Didit أسرع وأرخص API للتحقق عبر السجلات الحكومية، بدءاً من $0.05 لكل فحص في 60+ دولة مع مطابقة الوجه عند توفر الصورة.

تتحقق خدمة **التحقق من قواعد البيانات** من Didit من بيانات هوية الشخص بمطابقتها مع المصدر المعتمد لتلك الدولة — مثل السجل المدني الوطني، أو هيئة الضرائب، أو القوائم الانتخابية، أو مكتب الائتمان، أو السجل البيومتري الذي أصدر المستند في المقام الأول. يُرجع كل فحص تطابقاً لكل حقل (`identification_number` و`first_name` و`last_name` و`date_of_birth`، وحقول العنوان عندما تستخدمها الخدمة) بالإضافة إلى نتيجة مجمعة وتفاصيل السجل الأساسي عند توفرها.تُعد هذه الخدمة أقوى خط دفاع ضد الاحتيال بالهوية الاصطناعية: إذ سيفشل رقم DNI أو CPF الحقيقي المسروق في استعلام السجل، ولن يكون الرقم المُلفق موجوداً في قاعدة البيانات الرسمية على الإطلاق. تقترن خدمة التحقق من قواعد البيانات مع ميزة مطابقة الوجه البيومترية لدينا في الدول التي يحتفظ فيها السجل بصورة رسمية (الأرجنتين عبر RENAPER، وبنما عبر Tribunal Electoral SIB / SIB Plus) حتى تتمكن ليس فقط من التأكد من أن الرقم حقيقي، بل ومن أن **الشخص الذي يقف أمام الكاميرا هو صاحبه الفعلي**.

موجه تكامل التحقق من قواعد البيانات



      
      

\<pre>

\````# Goal
Integrate Didit Database Validation (verify identity data against authoritative national registries) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when Database Validation runs as a step in a hosted Didit flow. Fields are auto-fed into the registry lookup from the steps in front of it — ID Verification, NFC, Liveness, Phone/Email Verification, Proof of Address, Document AI or a Questionnaire. An ID Verification step is not required.

1\. Add the DATABASE_VALIDATION feature to the workflow (Business Console or POST /v3/workflows/). Optionally pin specific services per country.
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `database_validations[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you already have the identity data and want a one-shot registry check.

POST https://verification.didit.me/v3/database-validation/
multipart/form-data — x-api-key: YOUR_API_KEY

curl example (Brazil CPF):
\```bash
curl -X POST 'https://verification.didit.me/v3/database-validation/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "issuing_state=BRA" \
-F "identification_number=00000000191" \
-F "first_name=Jane" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-15" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, database_validation: { match_type: "full_match"|"partial_match"|"no_match", validation_type, services_used, match_score, validations: [{ service, status, matched_fields, record_details }], warnings: [...] } }.

\# Important behaviour
\- Use `identification_number` (universal field) — Didit maps it to CPF/RUT/CURP/DNI/etc. by issuing_state.
\- Omit `services` to run the country's default service only. Pass `services=["bra_cpf"]` (etc.) to choose which services run — list several to run more than one.
\- Argentina (`arg_renaper`) and Panama (`pan_sib`) take an extra `selfie` (JPG/PNG/WebP up to 2 MB) and `gender` for biometric face-match against the registry photo.
\- Services flagged `requires_consent=true` in the catalog require `consent=true` (HTTP 400 otherwise).
\- Billing is **per successful service hit** — multi-service requests can produce multiple usage events.

\# Status / match_type
status: "Approved" | "In Review" | "Declined" (per the partial-match / no-match actions configured on the workflow)
match_type: "full_match" | "partial_match" | "no_match"

\# Warnings (LogWarningChoices.DATABASE_VALIDATION)
warnings[] risk codes include:
DATABASE_VALIDATION_NO_MATCH, DATABASE_VALIDATION_PARTIAL_MATCH, COULD_NOT_PERFORM_DATABASE_VALIDATION (biometric outcomes surface via per-service outcome_code, e.g. BIOMETRIC_NO_MATCH).
Full catalogue: /core-technology/database-validation/database-validation-warnings.

\# Failure modes to handle
\- HTTP 400 — service id not eligible for issuing_state, missing required field, missing consent for PAYGO services.
\- HTTP 502 with validation_errors[] — every selected upstream service failed; request is **not billed** and a COULD_NOT_PERFORM_DATABASE_VALIDATION log is written. Retry later or fall back to OCR-only.
\- match_type="no_match" — record not in registry; treat as synthetic identity per policy.
\- match_type="partial_match" — some fields match, others don't (e.g. DOB matches, name doesn't); route to review.

\# See also
\- Canonical schema: /reference/data-models#database-validation
\- Per-feature report: /core-technology/database-validation/database-validation-report
\- Risk catalogue: /core-technology/database-validation/database-validation-warnings
\- Outcome codes: /core-technology/database-validation/database-validation-outcome-codes
\- Full integration playbook: /integration/integration-prompt````

\</pre>

## لماذا Didit- **أرخص الأسعار بنظام الدفع لكل استدعاء.** تبدأ من **\$0.05** لكل فحص (جمهورية الدومينيكان) وتصل إلى **\$7.00** لأعلى المصادر المتخصصة تكلفة. يُحدد السعر لكل خدمة وليس لكل دولة — فتُسعَّر الخدمة وفقاً لذلك إذا كان السجل يفرض رسوماً مرتفعة بالجملة (بطاقة الهوية الوطنية الفنلندية تبلغ **\$2.10**). اطّلع دائماً على السعر للخدمة المحددة التي تخطط لاستدعائها من [جدول الأسعار لكل خدمة](https://docs.didit.me/ar/getting-started/database-validation-pricing.md). لا توجد حدود دنيا شهرية، ولا رسوم للمنصة، ولا فوترة لكل مقعد — لا يتم احتساب الرسوم إلا على الاستعلامات الناجحة فقط.
- **الأسرع في التكامل.** [سجّل حسابك](https://business.didit.me/)، واحصل على مفتاح API من لوحة التحكم، ويمكنك استدعاء `POST /v3/database-validation/` في غضون دقائق. دون الحاجة إلى مكالمة مبيعات، أو دورة مشتريات، أو أوراق إثبات المفهوم — Didit خدمة ذاتية بالكامل.
- **استعلامات مباشرة من المصدر المعتمد.** RENAPER، وReceita Federal (SERPRO)، وTribunal Electoral، وRENAPO، وRENAP، وRNP، وRNPN، وJunta Central Electoral، وRegistraduría Nacional، وSEGIP، وServicio de Registro Civil، وTribunal Supremo de Elecciones، وDirección General de la Policía — وليست سحباً للبيانات من مُجمّعات البيانات.
- **مطابقة الوجه بيومترياً عندما يتوفر لدى السجل صورة رسمية في الملف.** درجة ثقة أعلى من OCR دون أي عمل تكاملي إضافي.
- **زمن استجابة مناسب لبيئة الإنتاج.** يكون زمن الاستجابة عند المئين 95 (p95) عادةً أقل من 1.5 ثانية من البداية إلى النهاية، مع توافر بنسبة 99.9% على أساس ربع سنوي.يتناول درس Academy حول قراءة نتيجة التحقق خدمة التحقق من قواعد البيانات عند الدقيقة 11:05، ويعرض نتائج التطابق الكامل والجزئي وعدم التطابق.[التحقق من قواعد البيانات: تطابق كامل، وجزئي، وعدم تطابق — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=665\&rel=0\&playsinline=1)## التغطية العالميةمرر المؤشر فوق أي دولة مميزة للاطلاع على كل خدمة من خدمات التحقق من قواعد البيانات التي نوفرها هناك، ومجال البيانات (الهوية، والبيانات المالية، والبيانات البيومترية، والعنوان، والاتصالات، ...)، وسعر كل استدعاء. الدول المفعلة جاهزة للاستخدام في بيئة الإنتاج اليوم؛ أما البقية فيتم ربطها عند الطلب بمجرد أن يطلب العميل ذلك.Live Database Validation coverageProduction-ready countries and the cheapest live service available in each.LIVE<details><summary>Show on-demand catalog countries ()</summary></details>> [!TIP]
>
> **ألا تجد دولتك؟** تواصل معنا — يشمل كتالوجنا 60+ دولة تضم مئات الخدمات التي نفعّلها عند الطلب بمجرد أن يحتاجها العميل. عادةً ما تصبح عمليات التكامل الجديدة جاهزة للعمل في غضون أسبوعين إلى 3 أسابيع.## كيف يعمل التحقق من قواعد البياناتلا يعمل التحقق من قواعد البيانات بشكل تخميني أبداً. فهو لا يُنفَّذ إلا عندما تتحقق **جميع** الشروط التالية:1) حددت الجلسة دولة للاستعلام عنها — من `issuing_state` الخاصة بـ [التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/overview.md)، أو، عندما لا يحتوي سير العمل على خطوة التحقق من الهوية، من الدولة الوحيدة التي تم تكوين خطوة التحقق من قواعد البيانات لها.
2) تتوفر في تلك الدولة خدمة واحدة على الأقل من خدمات التحقق من قواعد البيانات مُمكَّنة في سير العمل.
3) وفّرت الخطوات السابقة لخطوة التحقق من قواعد البيانات **كل حقل مطلوب** تحتاج إليه الخدمة المختارة.إذا تم تمكين خدمة ولكن لم تصل الحقول المطلوبة أبداً (على سبيل المثال، تعذر استخراج رقم CPF من مستند RG برازيلي ملطخ)، فسيتم تخطي الخدمة، و**لن يتم فرض أي رسوم عليك**، ويتم إصدار تحذير في الجلسة: `DATABASE_VALIDATION_NOT_APPLICABLE` عندما لا يحمل المستند ببساطة المعرّف الذي تستعلم الخدمة بواسطته، و`COULD_NOT_PERFORM_DATABASE_VALIDATION` عندما كان ينبغي أن يكون متاحاً ولم يكن كذلك. كلاهما مدرج في [كتالوج التحذيرات](https://docs.didit.me/ar/core-technology/database-validation/database-validation-warnings.md).يمكن لشخص من فريقك يتمتع بصلاحية مراجعة الجلسة ملء الحقل المفقود يدوياً من صفحة تفاصيل الجلسة في Console، وسيؤدي حفظه إلى إعادة تشغيل الفحص تلقائياً. هذا إجراء يقوم به المراجِع، وليس شيئاً يمكن للمستخدم النهائي القيام به — للسماح للـ **مستخدم** بتقديم حقل لا يحمله مستنده، اطلبه في الاستبيان (أو استخراج عبر Document AI، أو قيمة ترسلها عند إنشاء الجلسة) وقم بربطه في خطوة التحقق من قواعد البيانات، كما هو موضح أدناه.### التحقق من قواعد البيانات لا يتطلب التحقق من الهويةكانت خطوة التحقق من قواعد البيانات تقتضي في السابق وجود خطوة التحقق من الهوية قبلها، لأن تقنية OCR الخاصة بمستند الهوية كانت الطريقة الوحيدة المتكاملة للحصول على بيانات المستخدم النهائي. لم يعد الأمر كذلك: **فكل حقل مطلوب يحدد الخطوات التي يمكنها توفيره**، وتصبح الخدمة متاحة بمجرد أن يتضمن سير العمل لديك خطوة توفر كل حقل تحتاجه.| مصدر الإدخال | ما يوفره |
| - | - |
| التحقق من الهوية | الأسماء، وتاريخ الميلاد، والعنوان، ورقم المستند/الرقم الشخصي، والمعرّفات الخاصة بكل دولة والمطبوعة على مستند الهوية (الرقم الضريبي، ورقم الهوية الوطنية، ورقم جواز السفر، ورقم رخصة القيادة، …) |
| NFC | المجموعة الفرعية المقروءة من الشريحة لما سبق، بمستوى موثوقية أعلى |
| كشف الحيوية | صورة السيلفي المباشرة، لخدمات سجلات القياسات الحيوية للوجه |
| التحقق من رقم الهاتف | رقم الهاتف المتحقق منه |
| التحقق من البريد الإلكتروني | عنوان البريد الإلكتروني المتحقق منه |
| إثبات العنوان | العنوان السكني المتحقق منه ومكوناته |
| Document AI | أي حقل تقوم بربطه بأحد مفاتيح حقول الاستخراج الخاصة بك |
| الاستبيان | أي حقل تقوم بربطه بأحد أسئلتك |
| إدخال API | أي شيء، في API المستقل — يوفّر المتصل القيم مباشرة |هذا يعني أن **خدمة القياسات الحيوية للوجه يمكن تشغيلها من خطوة كشف الحيوية وحدها**، دون وجود أي مستند هوية في أي مكان في سير العمل، ويمكن استيفاء خدمة تعتمد على رقم ضريبي أو رقم هاتف أو بريد إلكتروني من خلال إجابة استبيان، أو خطوة التحقق من رقم الهاتف/البريد الإلكتروني، أو استخراج عبر Document AI.تضمن قاعدتان الحفاظ على الأمان:- **يجب أن يقوم سير العمل الذي لا يتضمن التحقق من الهوية بتكوين دولة واحدة فقط** في خطوة التحقق من قواعد البيانات. فبدون وجود `issuing_state` من المستند، تعد هذه الإشارة الواضحة الوحيدة للسجل الوطني المطلوب الاستعلام عنه، لذا فإن التكوين متعدد الدول دون التحقق من الهوية لن يُشغّل أي شيء بدلاً من التخمين.
- **يبقى فحص الحقول المطلوبة دون تغيير.** حيث يتم تخطي الخدمة التي لا تتوفر جميع حقولها في وقت التشغيل قبل إجراء أي استعلام لدى أي مزود، وبذلك لا تتم محاسبتك أبداً على قاعدة بيانات لم يُستعلم عنها على الإطلاق.#### ربط حقول Document AI والاستبيانتستخدم حقول الاستخراج في Document AI وأسئلة الاستبيان أسماء المفاتيح *الخاصة بك*، وليست الخاصة بـ Didit. ويتم ربط المفتاح الذي يطابق تماماً اسم إدخال في التحقق من قواعد البيانات (`tax_number`، و`date_of_birth`، و`phone`، …) تلقائياً دون الحاجة إلى تكوين. بالنسبة لأي شيء آخر، يعرض محرر سير العمل قائمة اختيار في خطوة التحقق من قواعد البيانات للحقول التي لا تزال غير مملوءة، حيث تقوم بتوجيه كل حقل إلى مفتاح حقل Document AI أو إجابة الاستبيان التي توفره.في Console، تظهر الخدمة التي لا يمكن لسير العمل تشغيلها بعد معطلة مع توضيح السبب — أي الحقول المفقودة وما هي الخطوة التي توفرها — ويقترح المحرر إضافة تلك الخطوة نيابةً عنك. وتؤدي إضافتها إلى تفعيل كل خدمة تتيحها هذه الخطوة على الفور.> [!TIP]
>
> **مثال عملي — معرّف لا يحمله المستند.** تستعلم خدمة الهوية الوطنية في نيجيريا عبر رقم NIN المكون من 11 رقماً، والذي غالباً لا يكون مطبوعاً على المستندات التي يحمّلها الأشخاص، لذا فإن الاعتماد على مستند الهوية وحده يؤدي إلى تخطي الفحص باعتباره غير قابل للتطبيق لشريحة واسعة من المستخدمين. ضع خطوة **الاستبيان** قبل خطوة التحقق من قواعد البيانات لطلب رقم NIN، ثم اربط `national_id` بذلك السؤال في خطوة التحقق من قواعد البيانات. هذا الربط نفسه هو ما يجعل المعرّف غير الموجود على المستند على الإطلاق — مثل رقم التحقق المصرفي أو رقم تسجيل الشركة — قابلاً للاستخدام داخل سير العمل.بالنسبة للخدمات المعتمدة على العنوان، تقسم Didit حقل `address` الواحد في مستند الهوية إلى عناصر عنوان منظمة تلقائياً:| حقل Didit | المعنى |
| - | - |
| `address_element_1` | عنوان الشارع، بما في ذلك الرقم ونوع الشارع |
| `address_element_2` | الشقة أو الوحدة، أو المبنى، أو الطابق، أو سطر عنوان إضافي (اختياري) |
| `address_element_3` | الضاحية، أو الحي، أو المنطقة المحلية، أو المجاورة |
| `address_element_4` | المدينة، أو البلدة، أو الولاية، أو المقاطعة، أو المنطقة |
| `address_element_5` | الرمز البريدي |عند استدعاء API المستقل، يمكنك إرسال إما حقل `address` واحد أو هذه الحقول المنظمة مباشرة. وتكون الأولوية للحقول المنظمة في حال توفر الاثنين معاً. وتتطلب الخدمات التي تستلزم البحث عن العنوان وجود `address_element_1` بالإضافة إلى عنصر عنوان آخر واحد على الأقل؛ وإذا لم تتمكن Didit من استخلاص هذه العناصر من مستند الهوية أو إثبات العنوان في سير العمل، فسيتم تخطي الخدمة ولن تتم فوترتها.إذا لم تكن الدولة المحددة مُمكّنة على الإطلاق، فسيتم تخطي الخطوة دون إشعار ودون تحذير ودون فرض أي رسوم.![سير عمل التحقق من قواعد البيانات في Didit لفحص بيانات المستخدم مقابل سجلات الهوية الحكومية](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/database-validation-how-it-works.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=3d5bb0df058265af0d8728cd60a78416)## نتيجة التطابقتُرجع كل خدمة مفعلة تحققاً لكل حقل:| الحقل | النتائج |
| - | - |
| `identification_number` | `full_match` · `partial_match` · `no_match` |
| `first_name` | `full_match` · `partial_match` · `no_match` |
| `last_name` | `full_match` · `partial_match` · `no_match` |
| `date_of_birth` | `full_match` · `no_match` |
| `address` | `full_match` · `partial_match` · `no_match` |يتم تجميع قيمة `match_type` الإجمالية لتصبح:- **`full_match`** — كل حقل طُلب التحقق منه يتطابق مع مصدر واحد على الأقل.
- **`partial_match`** — تطابق جزئي؛ يتم التوجيه إلى قائمة انتظار المراجعة وفقاً لقواعد سير العمل لديك.
- **`no_match`** — لم يؤكد أي مصدر البيانات؛ الرفض عادةً.## كيفية استنتاج المطابقة (1×1 / 2×2)لم نعد نطلب منك التحديد المسبق لـ "1×1" أو "2×2" — إذ يتم استنتاجهما من عدد الخدمات المختلفة التي حققت تطابقاً كاملاً مع البيانات المُدخلة:- **نتيجة 1×1** — أرجعت خدمة واحدة تطابقاً كاملاً (أكد مصدر موثوق واحد البيانات).
- **نتيجة 2×2** — أرجعت خدمتان أو أكثر تطابقاً كاملاً (تأكيد مستقل؛ أعلى درجة ثقة يمكننا تقديمها).يمكن لسير العمل تفعيل أي عدد من الخدمات لكل دولة؛ وتُحاسَب عن كل خدمة تُرجع نتيجة بالفعل. أما الخدمات التي تعذر استخراج حقولها المطلوبة فيتم تخطيها دون أي رسوم.➡️ راجع **[طرق المطابقة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-matching-methods.md)** للاطلاع على منطق اتخاذ القرار الكامل وكيفية تفاعله مع `partialMatchAction` / `noMatchAction`.## التحقق من قواعد البيانات البيومتريةتنشر السجلات المدنية في بعض البلدان قالباً بيومترياً (صورة شخصية أو بصمة إصبع). عندما يكون ذلك متاحاً، فإننا نقرن البحث في السجل بـ **مطابقة الوجه البيومترية** مع صورة السيلفي الخاصة بالمستخدم:- **الأرجنتين (`arg_renaper`)** — مطابقة بيومترية للوجه مع صورة RENAPER الرسمية المحفوظة. تغطية سكانية بنسبة 100%؛ فكل مواطن أرجنتيني يحمل DNI مسجل في قاعدة البيانات.
- **بنما (`pan_cedula_sib`، `pan_cedula_sib_plus`)** — مطابقة بيومترية للوجه مع خدمة Tribunal Electoral SIB. تُعد SIB Plus النسخة ذات المستوى الأعلى بحدود بيومترية أكثر صرامة وبيانات وصفية أغنى للمطابقة.بالنسبة لهذه الخدمات، فإن حقل `selfie` **مطلوب**. داخل مسار الجلسة، يُعاد استخدام صورة السيلفي الخاصة بكشف الحيوية (الأعلى جودة) ويتم الرجوع إلى الصورة الشخصية في المستند كخيار بديل. خارج الجلسة، عند استدعاء API المستقلة (`POST /v3/database-validation/`، الوضع B أعلاه)، تقوم بتقديم صورة JPEG/PNG بنفسك.## إثراء الهوية العالميتُعد `glb_identity_enrichment` **خدمة عالمية للتحقق من قواعد البيانات، ومتاحة عبر واجهة API المستقلة فقط**. فمن خلال بريد إلكتروني و/أو رقم هاتف، تتعرف على الأشخاص المرتبطين (الأسماء وتواريخ الميلاد والعناوين وأرقام الهواتف ورسائل البريد الإلكتروني وأرقام الهوية الوطنية) وتُرجع درجة تطابق الاسم، المحددة وفقاً لـ [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md) القياسية `MATCH` / `PARTIAL_MATCH` / `NO_MATCH` / `DOCUMENT_NOT_FOUND` (مع ما يقابلها من `match_type`، وهي `full_match` / `partial_match` / `no_match`).نظراً لأنها خدمة عالمية (`GLB`) تعتمد على البريد الإلكتروني/الهاتف بدلاً من دولة إصدار المستند، فهي **غير متوفرة في أداة إنشاء سير العمل**. يمكنك استدعاؤها مباشرة عبر API المستقلة مع تعيين `issuing_state` إلى `GLB`:```json theme={null}
POST /v3/database-validation/
{
  "issuing_state": "GLB",
  "services": ["glb_identity_enrichment"],
  "email": "john.doe@example.com",
  "phone": "+14155552671"
}
```تتم فوترتها بسعر **\$0.20 لكل طلب** (يتم احتساب التكلفة فقط عندما يُرجع المزود نتيجة).## الإعداداتيتم ضبط التحقق من قواعد البيانات لكل سير عمل من لوحة التحكم. لكل دولة، تحدد الخدمات المعينة التي ترغب في تشغيلها؛ ويتم استنتاج حقول الإدخال المطلوبة والاختيارية من مجموع تلك الخدمات. يتم تكوين الإجراء المتخذ عند نتائج `partial_match` و `no_match` بشكل منفصل، ويمكن أن يكون `approve`، أو `review`، أو `decline`.![Didit database validation console settings selecting per-country registry services and outcome rules](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/database-validation-console.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=2e1ac27f07fa9ca9c54108c6fd19a6b3)## إشعارات التوفرتتعطل السجلات الحكومية والمصادر الأخرى من وقت لآخر. وطالما يتعذر الوصول إلى قاعدة بيانات، لا تُرجع عمليات الفحص المرتبطة بها أي إجابة ولا تتم فوترتها. وداخل سير العمل، تنتهي الخدمة إلى [`REGISTRY_UNAVAILABLE`](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes). أما في API المستقل، فيظهر الانقطاع نفسه بأحد ثلاثة أشكال، لذا اقرأ النتائج الخاصة بكل خدمة **و** `database_validation.errors[]`، ولا تعتمد أبداً على حالة HTTP وحدها:- `200` مع `outcome_code: "REGISTRY_UNAVAILABLE"` لتلك الخدمة في `validations`، عندما احتفظت Didit بنتيجة للإبلاغ عنها.
- `200` مع وجود تلك الخدمة في `database_validation.errors[]` كـ `code: "empty_provider_response"` و`retryable: true`، عندما لم تُصدر أي إجابة قابلة للاستخدام على الإطلاق بينما قدمت خدمة محددة أخرى إجابة. وتكون الخدمة الفاشلة عندئذٍ غائبة عن `validations` وعن `services_used`، بحيث تكون `errors[]` هي المكان الوحيد الذي تظهر فيه.
- `502` مع `validation_errors[].code: "empty_provider_response"` و`retryable: true`، عندما لا تُرجع أي خدمة محددة نتيجة قابلة للاستخدام (راجع [المدخلات المرفوضة والنتائج غير المتوفرة](https://docs.didit.me/ar/standalone-apis/database-validation.md#المدخلات-المرفوضة-والنتائج-غير-المتاحة)).تتبع `status` الإجمالية الخدمات التي استجابت بالفعل، لذا فهي ليست إشارة موثوقة لانقطاع الخدمة بمفردها. فالطلب الذي لم يتبق لديه ما يُقارن به يتحول إلى `In Review`، لكن الطلب الذي حدد عدة خدمات يمكن أن يعود بـ `Approved` بناءً على مطابقة خدمة أخرى بينما كان أحد مصادره غير متوفر. أعِد محاولة الخدمة الفاشلة من `errors[]` بدلاً من إعادة الطلب بأكمله.لا يعبر أي من هذه الأشكال عن أي شيء يتعلق بالشخص الذي يجري التحقق منه.تراقب Didit النتائج المباشرة لعمليات الفحص الفعلية، قاعدة بيانات تلو الأخرى، وترسل بريداً إلكترونياً إلى مؤسستك عندما يكون الانقطاع مستمراً وليس مجرد طلب فاشل فردي:| البريد الإلكتروني | وقت الإرسال | ما يخبرك به |
| - | - | - |
| **انقطاع قاعدة البيانات** | تعطلت قاعدة بيانات لمدة لا تقل عن عشر دقائق، مع بقاء جميع عمليات الفحص تقريباً في تلك الفترة دون إجابة. ولا يؤدي أي تعطل قصير أو فشل فردي إلى إرسال هذا التنبيه. | قاعدة البيانات والدولة المتأثرتان ووقت رصد حالات الفشل لأول مرة. قد لا تُرجع عمليات الفحص أي نتيجة حتى استعادة الوصول؛ وهذا لا يعني أن الهويات المُرسلة غير صالحة. |
| **استعادة الوصول إلى قاعدة البيانات** | عادت عمليات الفحص الفعلية للاستجابة مجدداً لمدة لا تقل عن خمس دقائق دون أي حالات فشل. ولا تُحتسب الفترات الهادئة كتعافٍ أبداً، لذا تستغرق قاعدة البيانات ذات حركة المرور المنخفضة وقتاً أطول لتأكيد كلتا الحالتين. | وقت تأكيد التعافي. **لا** تُعاد معالجة عمليات التحقق التي لم تكتمل أثناء الانقطاع تلقائياً: راجعها وأعِد المحاولة. |تُرسل الإشعارات إلى الأعضاء وجهات اتصال الفوترة في كل مؤسسة أجرت فحصاً على قاعدة البيانات المحددة تلك خلال آخر 48 ساعة. لا يلزم تكوين أي شيء ولا توجد آلية اشتراك مسبق. لا تؤدي حركة المرور في البيئة التجريبية إلى تشغيلها أبداً، وكذلك حالات الفشل الناتجة عن البيانات التي أرسلتها (مدخلات مرفوضة أو مشوهة) أو عن الخدمات التي تعمل باستخدام بيانات اعتماد ربطتها مؤسستك بنفسها. ويُعد الفحص الذي أُجيب عليه عبر مصدر احتياطي متاحاً، وكذلك عدم التطابق القاطع.## الأسعار — ادفع مقابل ما تستخدمه فقطتتم فوترة التحقق من قواعد البيانات **لكل استعلام ناجح، لكل خدمة**، بالسعر المنشور لتلك الخدمة. وتتراوح الأسعار من **\$0.05** لكل فحص (جمهورية الدومينيكان عبر Junta Central Electoral) وتصل إلى **\$7.00** للمصادر المتخصصة الأكثر تكلفة. تقع العديد من عمليات البحث في السجلات الحكومية ضمن نطاق **من 0.20 دولار أمريكي إلى 0.30 دولار أمريكي**، لكن عدداً لا بأس به يكلف أكثر بكثير لأن المصدر نفسه يفرض رسوماً أعلى — فالهوية الوطنية الفنلندية (`fin_national_id`) تبلغ **\$2.10** لكل استعلام ناجح. حدد سعر الدولة من الصف الخاص بها في [جدول الأسعار](https://docs.didit.me/ar/getting-started/database-validation-pricing.md)، وليس من نطاق تقريبي أبداً. لا يوجد حد أدنى شهري أو التزامات أو رسوم منصة.أنت تدفع فقط عندما تُرجع الخدمة نتيجة. لا تتم فوترة الخدمات التي يتم تخطيها بسبب نقص بيانات الإدخال، وكذلك الخدمة التي يفشل استدعاء مصدرها بحد ذاته - حيث يعني خطأ السجل أو تعذر الوصول إلى السجل (`REGISTRY_ERROR` / `REGISTRY_UNAVAILABLE`) أنه لم تتم الإجابة على الاستعلام قط، وبالتالي فهو ليس نتيجة خاضعة للرسوم.يتم احتساب كل استعلام ناجح في السجل بدءاً من الاستعلام الأول، سواء كان يعمل داخل سير العمل أو من خلال API المستقل `POST /v3/database-validation/`. ويُدفع من رصيد خطتك أو رصيد الشحن مثل أي فحص آخر، وينطبق خصم خطتك على سعره بالكامل. راجع [صفحة الأسعار](https://docs.didit.me/ar/getting-started/pricing.md#الخصومات).➡️ [أسعار التحقق من قواعد البيانات](https://docs.didit.me/ar/getting-started/database-validation-pricing.md) · [سجّل واحصل على مفتاح API](https://business.didit.me/)## جميع الخدمات

\<table><thead><tr><th>الدولة</th>
            \<th>ISO3</th>
            \<th>الخدمة</th>
            \<th>الوصف</th>
            \<th>السعر (بالدولار الأمريكي)</th></tr></thead>
        \<tbody /></table>

## متابعة القراءة- [طرق المطابقة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-matching-methods.md) — كيفية استخلاص نتائج 1×1 / 2×2 وكيفية التعامل معها.
- [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md) — القائمة الكاملة لرموز استجابة المزود (متوفى، قاصر، المستند غير موجود، عدم تطابق بيومتري، …) وكيفية تعيينها لقرارات الجلسة.
- [التحذيرات](https://docs.didit.me/ar/core-technology/database-validation/database-validation-warnings.md) — ما نعرضه عندما يتعذر تشغيل خدمة بسبب نقص البيانات.
- [التقارير](https://docs.didit.me/ar/core-technology/database-validation/database-validation-report.md) — عمليات تصدير الفوترة الشهرية لكل خدمة متضمنة الدولة ومعرّف الخدمة والاستخدام وسعر الوحدة والتكلفة الإجمالية.
- [الدول المدعومة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-supported-countries.md) — عرض جدول ثابت لجميع الدول التي نغطيها اليوم.


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