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

# التحقق من الهوية: التحقق عند التسجيل وإعادة التحقق قبل عمليات الصرف

> اطلب كشف الحيوية أو التحقق من الهوية قبل إنشاء الحساب، وأعد التحقق قبل عمليات الصرف، واحصل على مطالبات موثّقة في الرموز عبر Didit.

يطلب التحقق من الهوية في Didit Authentication من الأشخاص إثبات هوياتهم في اللحظات التي تختارها: قبل إنشاء حساباتهم، ومرة أخرى قبل أي إجراء حساس مثل صرف دفعة.
يتلقى تطبيقك النتيجة والسمات الموثّقة التي اخترتها، مثل `over_18` أو الاسم الموثّق، داخل tokens الخاصة بالشخص، ولا يتلقى أبدًا مستنداته أو صوره.

يمكنك إعداده في Business Console ضمن **Authentication > Verified identity**، أو عبر API باستخدام [`verified/`](#الإعداد-عبر-api).

![صفحة Verified identity في Didit Business Console، وفيها مستويات التحقق عند التسجيل وأسعارها، وقواعد التحقق الإضافي قبل الإجراءات الحساسة](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: التحقق عند التسجيل والقواعد قبل الإجراءات الحساسة.

## كيف يعمل

تُنفَّذ كل عملية فحص كجلسة تحقق خاصة بتطبيقك، وتُنشأ باستخدام `vendor_data` الخاص بالشخص.
وهذا يعني أنها تظهر في عمليات التحقق لديك، وترتبط بالشخص نفسه إلى جانب عمليات تسجيل الدخول والمعاملات الخاصة به، وتُحال إلى المراجعة اليدوية كأي عملية تحقق أخرى، وتُحتسب بسعر عملية التحقق تلك.

| الفحص | ما يفعله الشخص | السعر المعلن |
| - | - | - |
| كشف الحيوية | يلتقط صورة سيلفي واحدة، تُفحص للتأكد من الحيوية. | \$0.10 |
| تسجيل الدخول بصورة السيلفي | يلتقط صورة سيلفي يطابقها Didit مع الوجه المحفوظ لديه للشخص. | \$0.10 |
| التحقق الكامل من الهوية | يمسح مستندَ هوية ويلتقط صورة سيلفي: التحقق من المستند، وكشف الحيوية، ومطابقة الوجه. | \$0.33 |

يُشغّل Didit كل فحص بمسار سير العمل الافتراضي الخاص به، أو بأحد سير العمل الخاصة بك التي تختارها لذلك الفحص.
راجع [الأسعار](https://docs.didit.me/ar/getting-started/pricing.md) للاطلاع على سعر كل عملية تحقق.

## عند التسجيل

اختر المستوى الذي يجب أن يجتازه الشخص قبل إنشاء حسابه:

| المستوى | القيمة | المعنى |
| - | - | - |
| بدون تحقق | `none` | يمكن لأي شخص يملك بريدًا إلكترونيًا أو رقم هاتف أو مفتاح مرور أن يسجّل. وهذا هو الافتراضي. |
| كشف الحيوية | `liveness` | يسجّل شخص حقيقي فقط: صورة سيلفي واحدة تُفحَص لكشف الحيوية. |
| الهوية الكاملة | `full_id` | مستند وكشف حيوية ومطابقة الوجه، قبل أن يُنشأ الحساب. |

ينطبق المستوى الجديد على الأشخاص الذين يسجّلون من تلك اللحظة فصاعدًا فقط، ولا ينطبق أبدًا على الحسابات الموجودة.

في الصفحات المستضافة، يوجّه Didit الشخص عبر التحقق أثناء التسجيل.
أما في شاشاتك الخاصة، فيُرجع استدعاء التسجيل الاستجابة `verification_required` مع `verification_url` صالح لمدة 30 دقيقة: وجّه الشخص إليه.
لا يُصدر Didit رمز تسجيل الدخول إلا بعد قبول التحقق.

## خطوة التحقق الإضافي قبل الإجراءات الحساسة

خطوة التحقق الإضافي تطلب من الشخص أن يتحقق مرة أخرى، ولكن فقط عندما يكون الإجراء محفوفًا بالمخاطر بدرجة كافية.
تفعّل القواعد، ويسأل تطبيقك Didit قبل كل إجراء حساس عمّا إذا كانت إحدى القواعد تنطبق عليه.

![هاتف يعرض خطوة تحقق إضافي تطلب من الشخص تأكيد هويته بصورة سيلفي](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

ما يراه الشخص عندما تطلب خطوة التحقق الإضافي صورة سيلفي.

| القاعدة | تُطبَّق عندما | الفحص الافتراضي |
| - | - | - |
| `payout` | يكون السحب أو التحويل أعلى من حدّك، مثلًا 500 بعملتك. يُفحص دائمًا أي صرف بعملة أخرى. | تسجيل الدخول بصورة سيلفي |
| `device` | يتم الصرف في جلسة على جهاز لم تُجرَ عليه أي من جلسات الشخص السابقة. | تسجيل الدخول بصورة سيلفي |
| `bank` | يضيف الشخص حسابًا بنكيًا أو يغيّره. | التحقق الكامل من الهوية |
| `contact` | يغيّر الشخص بريده الإلكتروني أو رقم هاتفه. | كشف الحيوية |

يمكنك تغيير الفحص لكل قاعدة إلى كشف الحيوية أو تسجيل الدخول بصورة سيلفي أو التحقق الكامل من الهوية.
عندما تنطبق عدة قواعد، يطلب Didit أقوى فحص بينها.
عندما لا يملك Didit بعدُ بيانات وجه للشخص، يتحول تسجيل الدخول بصورة سيلفي إلى تحقق كامل من الهوية.

### طلب خطوة تحقق إضافي

يستدعي تطبيقك `POST {issuer}/step-up/` باستخدام رمز الوصول الخاص بالشخص، أو طريقة `stepUp()` في حزم SDK:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| الحقل | القاعدة |
| - | - |
| `action` | `payout` أو `bank` أو `contact`. يطبّق الصرف أيضًا قاعدة `device`. |
| `amount` | مطلوب لـ `payout`، بما يصل إلى منزلتين عشريتين. |
| `currency` | رمز ISO 4217. يكون افتراضيًا عملة قاعدة الصرف لديك. |
| `return_to` | الوجهة التي يعود إليها الشخص بعد التحقق. عندما تنطبق قاعدة، يجب أن تكون أحد [عناوين URL لإعادة التوجيه](https://docs.didit.me/ar/authentication/overview.md#عناوين-إعادة-التوجيه) المسجلة لديك. |

* `200 {"required": false}`: لا تنطبق أي قاعدة، فيمكنك المضي قدمًا.
* `201` مع `verification_url`: أرسل الشخص إليه. تبقى خطوة التحقق الإضافي مفتوحة لمدة 30 دقيقة (`expires_in: 1800`).

### قراءة النتيجة في الخادم الخلفي

يعود الشخص إلى `return_to` مع إضافة `step_up=<id>&status=approved`، لكن هذا الاستعلام لا يثبت شيئًا.
يقرأ الخادم الخلفي خطوة التحقق الإضافي عبر `GET {issuer}/step-up/{step_up_id}/` باستخدام رمز وصول من الجلسة نفسها، ولا يتصرف إلا عندما تكون `status` هي `approved`.

| الحالة | المعنى |
| - | - |
| `pending` | لم ينهِ الشخص الفحص بعد. |
| `approved` | اجتاز الشخص الفحص. تابع الإجراء. |
| `review` | الفحص ينتظر مراجعة فريقك. |
| `declined` | لم يجتز الشخص الفحص. لا تُعدّ النتيجة نهائية ما دام `verification_url` يعمل: يمكنه المحاولة مرة أخرى، وتعود خطوة التحقق الإضافي إلى `pending`. |
| `expired` | انقضت الـ 30 دقيقة. أنشئ خطوة تحقق إضافي جديدة. |
| `superseded` | حلّ فحص آخر محلّها، أو أن النتيجة لا تخص خطوة التحقق الإضافي هذه. أنشئ خطوة جديدة. |

لا يسمح التحقق الإضافي أبدًا بالمرور عند الفشل: عندما يكون التحقق غير متاح، يبقى الإجراء محجوبًا.
تعرض أدلة [JavaScript](https://docs.didit.me/ar/authentication/quickstarts/javascript.md#رفع-مستوى-التحقق-وإعادة-المصادقة) و[Next.js](https://docs.didit.me/ar/authentication/quickstarts/nextjs.md#التحقق-الإضافي-قبل-الإجراءات-الحساسة) و[iOS](https://docs.didit.me/ar/authentication/quickstarts/ios.md#التحقق-الإضافي-قبل-الإجراءات-الحساسة) جانب SDK، ويتضمن [مرجع API](https://docs.didit.me/ar/authentication/api-reference/create-step-up.md) العقد الكامل.

## ما الذي يتلقاه تطبيقك

اختر الادعاءات الموثّقة التي تُدرج في tokens الخاصة بالشخص:

| الادعاء | القيمة |
| - | - |
| `over_18`, `over_21` | ما إذا كان عمر الشخص 18 عامًا على الأقل أو 21 عامًا على الأقل، استنادًا إلى تاريخ الميلاد الموثّق. |
| `given_name`, `family_name` | الاسم الأول والاسم الأخير الموثّقان. |
| `birthdate` | تاريخ الميلاد من المستند، بصيغة `YYYY-MM-DD`. |
| `nationality` | رمز ISO 3166-1 alpha-2. |
| `country` | رمز ISO 3166-1 alpha-2 لدولة المستند. |
| `document_verified` | هل تم التحقق من مستند هوية. |
| `liveness` | هل اجتاز الشخص فحص الحيوية. |

يحمل access token وID token هذه الادعاءات ضمن `verified`، مع `level`، وهو أعلى مستوى اجتازه الشخص: `liveness` أو `liveness_face_match` أو `full_id`.
يكون `{}` عندما لا يكون الشخص قد اجتاز أيًا من هذه المستويات، ويعيد `GET /session/` القيمة `null` بدلًا من ذلك.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* يصل الفحص المقبول أثناء الجلسة إلى tokens عند التجديد التالي، خلال 5 دقائق.
* يمكن لأي جهة تملك token قراءة هذه الادعاءات، بما فيها الواجهة الأمامية لتطبيقك، لذا اختر الادعاءات الشخصية التي يحتاجها تطبيقك فقط.
* يتلقى تطبيقك الادعاءات فقط، ولا يتلقى المستند ولا صورة السيلفي ولا بيانات الوجه أبدًا.

## الإعداد عبر API

تقرأ `GET` و`PATCH` على `verified/` في [واجهة API لإدارة المصادقة](https://docs.didit.me/ar/authentication/set-up-by-api.md) الخاصة بتطبيقك الإعدادات نفسها الموجودة في وحدة التحكم وتعدّلها:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| الحقل | القيم |
| - | - |
| `signup_level` | `none` أو `liveness` أو `full_id`. |
| `rules` | إدخال واحد لكل قاعدة تغيّرها: `rule` (`payout` أو `device` أو `bank` أو `contact`)، و`enabled`، و`method` (`liveness` أو `selfie` أو `full_id`)، وبالنسبة إلى `payout` فقط، `threshold` و`currency`. |
| `claims` | المطالبات التي تُضاف إلى token، من الجدول أعلاه. |
| `workflows` | اختياري: معرّف سير العمل الخاص بك لـ `liveness` أو `selfie` أو `full_id`، أو `null` للإعداد الافتراضي من Didit. |

القاعدة التي لا تُدرجها في الطلب تحتفظ بإعداداتها الحالية.


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