> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sahlfinancial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# قائمة التحقق قبل الإطلاق

> بنود يجب التأكد منها قبل إرسال بيانات عملاء حقيقية. كل بند مدعوم بسلوك واجهة البرمجة أو بوحدة التحكم.

اتبع القائمة بالترتيب. يذكر كل بند أين تتحقق منه.

## الوصول

* [ ] **مساحة عملك مفعّلة لواجهة KYC للشركاء.** في **Settings, API Keys** يعرض نموذج المفتاح الجديد نطاقات `kyc:`. وإذا ذكر أن مساحة العمل غير مفعّلة، [فاطلب الوصول إلى بيئة الاختبار](https://sahlfinancial.com/contact?type=demo): يتم التفعيل لكل مساحة عمل من قِبل Sahl.
* [ ] **مفتاح واحد لكل نظام، بأقل النطاقات.** الخادم الذي يتحقق فقط يحتاج إلى `kyc:verify`. و`kyc:extract` وحده يستهلك القراءات.
* [ ] **المفاتيح محفوظة في مدير أسرار على خادمك.** لا مفتاح في متصفح أو تطبيق جوال أو مستودع شيفرة. انظر [المصادقة](/ar/authentication).
* [ ] **بدّلت مفتاحًا مرة واحدة في بيئة الاختبار.** بدّل مع فترة سماح، وانشر المفتاح البديل، وتأكد أن المفتاح القديم يُرجع 401 `API key expired` بعد انتهاء فترة السماح.
* [ ] **أُبطلت مفاتيح الاختبار.** المفاتيح التي لصقتها في ساحة التجربة أو في Postman للاختبار أُبطلت في قائمة المفاتيح.
* [ ] **اختياري: المفاتيح مرتبطة بحساب خدمة Google الخاص بك.** عندئذٍ يرسل كل استدعاء `X-Partner-Identity`.

## السياسة

* [ ] **توجد سياسة KYC لبيئة `production`** إن أردت قواعد غير الافتراضية. تُحفظ السياسة لكل نوع عميل ولكل بيئة، فلا تنتقل سياسة بيئة الاختبار. راجعها في **Settings, KYC policy**: العتبات والمستندات المطلوبة والبنود المقفلة.
* [ ] **تعرف المفاتيح المقفلة.** أرسل استدعاءً بـ `screen: false` في بيئة الاختبار واقرأ `policy.overrides_refused` في الاستجابة.
* [ ] **الإعداد المسبق للنظام التنظيمي هو ما تتوقعه.** يخبرك `policy.source` و`policy.regime` في الاستجابة بالسياسة التي طُبّقت.

## التكامل

* [ ] **كل استدعاء يحمل `reference` ثابتًا.** من 1 إلى 64 حرفًا من `A-Z a-z 0-9 _ . : -`، واحد لكل عميل، وهو نفسه في `/extract` و`/verify` و`/assess` و`/eid`. وبدونه لا يُحفظ شيء في مساحة عملك ولا يُرسل webhook.
* [ ] **تعيد إرسال عناصر `documents[]` دون تغيير.** انظر [كيف تترابط الاستدعاءات](/ar/guides/workflow).
* [ ] **تتفرع بحسب `critical_failures` و`flags`، لا بحسب `passed` فقط.** الملف الذي فيه تنبيهات تبقى قيمة `passed` فيه `true`.
* [ ] **تطابق الفحوص بحسب `id` لا بحسب `label`.**
* [ ] **تعالج `reader_unavailable: true`.** أعد المحاولة لاحقًا ولا تعامله كمستند فارغ.
* [ ] **تعالج أشكال الأخطاء الثلاثة جميعها**، بما فيها 422 التي يكون `detail` فيها قائمة. انظر [الأخطاء](/ar/errors).
* [ ] **لا تعيد محاولة 4xx** (باستثناء 429 لحد المعدل مع `Retry-After`)، وتعيد محاولة 5xx بتراجع زمني محدود السقف. لا يوجد مفتاح idempotency. انظر [إعادة المحاولة](/ar/errors).
* [ ] **تسجّل `X-Request-ID`** من كل استجابة، وتستطيع العثور على الاستدعاء في **Developers, Call log**.

## الحدود

* [ ] **تعرف حصة القراءة الشهرية لديك** (2,000 افتراضيًا) وتعالج 429 `kyc_extract_cap_reached`. وتُحتسب منها قراءات بيئة الاختبار أيضًا.
* [ ] **تبقى خوادمك دون 100 طلب في الدقيقة لكل IP للعميل.** الخوادم خلف عنوان واحد تتشارك الحد.
* [ ] **خطوة الرفع لديك تفرض قواعد الملفات قبل الإرسال:** من 1 إلى 5 ملفات، JPEG أو PNG أو WebP أو TIFF أو PDF، بحد 30 MB لكل ملف افتراضيًا.

## Webhooks، إن كنت تستخدمها

* [ ] **نقطة النهاية https وعامة.** أضفها في **Settings, Webhooks** واضغط **Test**.
* [ ] **تتحقق من `X-Sahl-Signature-V2` على الجسم الخام** وترفض الطوابع الزمنية القديمة. انظر [Webhooks](/ar/guides/webhooks).
* [ ] **معالجك idempotent** بالاعتماد على `X-Sahl-Delivery` أو `event_id`، ويرد بـ 2xx سريعًا.

## eID، إن كنت تستخدمه

* [ ] **لدى مساحة عملك حساب لدى مزوّد eID.** بدونه يُرجع `POST /v1/kyc/eid` الحالة 404.
* [ ] **عملاؤك كنديون.** الدول الأخرى تحصل على 422.
* [ ] **تستخدم `reference` و`environment` نفسيهما** في `/eid` وفي `/verify` اللاحق.
* [ ] **تتابع الفحص بالاستعلام الدوري حتى نهايته وتحفظ ملف PDF خلال نحو سبعة أيام.**

## وحدة التحكم

* [ ] **يستطيع موظفوك رؤية بيانات الإنتاج.** تعرض وحدة التحكم قضايا ومستندات الإنتاج في كل الخطط. تتيح خطة Free عشر (10) قضايا إنتاج شهريًا وتتطلب بريدًا إلكترونيًا مهنيًا موثّقًا (وليس Gmail أو Yahoo)؛ وتحصل Starter وما فوقها على حصة خطتها. وبيئة الاختبار غير محدودة في جميع الخطط.
* [ ] **أرسلت أول استدعاء إنتاج بعميل وهمي** ووجدت قضيته في **Cases** بالبيئة `production`.
* [ ] **المستندات الحقيقية تذهب إلى الإنتاج فقط.** استخدم بيانات وهمية في بيئة الاختبار.

## ليس في هذه القائمة

لا تنشر Sahl في هذه الوثائق رقمًا لوقت التشغيل (uptime)، ولا زمنًا لاستجابة الدعم، ولا رقمًا لزمن الاستجابة، ولا ادعاءً بشهادة اعتماد. اطلب ذلك من Sahl كتابةً.


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