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

# وثائق Sahl

> التمويل المفتوح للبنوك والمقرضين في المغرب وأفريقيا الناطقة بالفرنسية: الربط البنكي، والتعرف الضوئي على الوثائق (OCR)، والتحقق، وتقييم المخاطر، والتصنيف.

<div className="mx-auto max-w-5xl px-5 pt-16 pb-20 sm:px-8">
  <section className="max-w-2xl">
    <p className="mb-4 text-sm font-medium text-[#1B5E3B] dark:text-[#06DC7F]">التوثيق</p>
    <h1 className="text-4xl font-semibold tracking-tight text-gray-950 dark:text-white sm:text-5xl">التمويل المفتوح للبنوك والمقرضين</h1>
    <p className="mt-5 text-lg leading-relaxed text-gray-600 dark:text-gray-400">تربط Sahl الحسابات البنكية، وتقرأ الوثائق المالية، وتتحقق من العملاء، وتقيّم المخاطر، لصالح البنوك والمقرضين في المغرب وأفريقيا الناطقة بالفرنسية. والربط البنكي أولاً. وتبدأ مساحات العمل الجديدة في بيئة الاختبار (sandbox) على بيانات تجريبية.</p>

    <div className="mt-8 flex flex-wrap gap-3">
      <a href="/ar/quickstart" className="sahl-btn inline-flex items-center bg-[#1B5E3B] px-5 py-2.5 text-sm font-medium text-white hover:bg-[#02A45E]">البدء السريع</a>
      <a href="/api-reference/introduction" className="sahl-btn inline-flex items-center border border-gray-300 px-5 py-2.5 text-sm font-medium text-gray-900 hover:border-[#02A45E] dark:border-gray-700 dark:text-gray-100">مرجع Partner API</a>
      <a href="/console-api/overview" className="sahl-btn inline-flex items-center border border-gray-300 px-5 py-2.5 text-sm font-medium text-gray-900 hover:border-[#02A45E] dark:border-gray-700 dark:text-gray-100">مرجع Console API</a>
      <a href="https://sahlfinancial.com/use-cases" className="sahl-btn inline-flex items-center border border-[#02A45E] px-5 py-2.5 text-sm font-medium text-[#1B5E3B] hover:bg-[#02A45E] hover:text-white dark:text-[#06DC7F]">الترقية للحصول على ربط بنكي حقيقي</a>
    </div>
  </section>

  <section className="mt-14 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
    <a href="/ar/quickstart" className="sahl-card sahl-reveal block p-5 no-underline">
      <h3 className="text-base font-semibold text-gray-950 dark:text-white">البدء السريع</h3>
      <p className="mt-2 text-sm leading-relaxed text-gray-600 dark:text-gray-400">اقرأ وثيقة واحصل على حكم، بلغات cURL وJavaScript وPython.</p>
    </a>

    <a href="/guides/open-banking" className="sahl-card sahl-reveal block p-5 no-underline">
      <h3 className="text-base font-semibold text-gray-950 dark:text-white">الربط البنكي</h3>
      <p className="mt-2 text-sm leading-relaxed text-gray-600 dark:text-gray-400">ما هو الربط، وحالاته، والمعاملات، والتحليل، ومحاكاة بيئة الاختبار.</p>
    </a>

    <a href="/bank-coverage" className="sahl-card sahl-reveal block p-5 no-underline">
      <h3 className="text-base font-semibold text-gray-950 dark:text-white">التغطية البنكية</h3>
      <p className="mt-2 text-sm leading-relaxed text-gray-600 dark:text-gray-400">المؤسسات التي تدرجها Sahl، بحسب البلد.</p>
    </a>

    <a href="/ar/test-in-sandbox" className="sahl-card sahl-reveal block p-5 no-underline">
      <h3 className="text-base font-semibold text-gray-950 dark:text-white">الاختبار في بيئة sandbox</h3>
      <p className="mt-2 text-sm leading-relaxed text-gray-600 dark:text-gray-400">أنشئ مفتاحاً ونفّذ كل استدعاء من هذا الموقع. 15 دقيقة.</p>
    </a>
  </section>

  <section className="mt-16">
    <h2 className="text-2xl font-semibold tracking-tight text-gray-950 dark:text-white">ما الذي تغطيه Sahl</h2>

    <div className="mt-5 overflow-x-auto border border-gray-200 dark:border-gray-800" style={{borderRadius: "0.25rem"}}>
      <table className="w-full text-left text-sm">
        <thead className="bg-gray-100/70 text-gray-700 dark:bg-white/5 dark:text-gray-300">
          <tr><th className="px-4 py-3 font-medium">القدرة</th><th className="px-4 py-3 font-medium">ماذا تفعل</th><th className="px-4 py-3 font-medium">التوفر</th><th className="px-4 py-3 font-medium">أين</th></tr>
        </thead>

        <tbody className="text-gray-700 dark:text-gray-300">
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">Sahl Connect: الربط البنكي</td><td className="px-4 py-3">يمنح العميل الإذن لدى بنكه؛ بيانات الحساب والرصيد والمعاملات.</td><td className="px-4 py-3">محاكاة في بيئة الاختبار حالياً. وحدة التحكم، وعبر مفتاح API المسار <code>/v1/partner/bank-connections</code> (النطاقان <code>bank:read</code> و<code>bank:write</code>). خطة Growth، وتفعّلها Sahl لكل مساحة عمل. وإلى حينه يجيب الإنتاج بالرمز 409.</td><td className="px-4 py-3"><a href="/guides/open-banking">دليل الربط البنكي</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">Sahl Connect: المحافظ الرقمية وشركات التقنية المالية</td><td className="px-4 py-3">الأموال عبر الهاتف المحمول والمحافظ الرقمية خارج البنوك.</td><td className="px-4 py-3">قيد الإعداد</td><td className="px-4 py-3">لا يوجد مسار</td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">لوحة الموافقات، وأداة مضمَّنة جاهزة، وإعادة الربط التلقائية</td><td className="px-4 py-3">يرى العميل الأذونات ويسحبها؛ ومسار ربط قابل للتضمين.</td><td className="px-4 py-3">قيد الإعداد</td><td className="px-4 py-3">لا يوجد مسار منشور</td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">الوثائق المالية (Sahl OCR)</td><td className="px-4 py-3">تقرأ كشوف الرواتب وكشوف الحسابات البنكية ووثائق الهوية وتحوّلها إلى حقول، مع فحوص لكل وثيقة.</td><td className="px-4 py-3">Partner API بمفتاح، ووحدة التحكم</td><td className="px-4 py-3"><code>POST /v1/kyc/extract</code>, <a href="/ar/guides/ocr-documents">الدليل</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">التحقق: الهوية</td><td className="px-4 py-3">حكم على ملف العميل ووثائقه.</td><td className="px-4 py-3">Partner API بمفتاح</td><td className="px-4 py-3"><code>POST /v1/kyc/verify</code>, <a href="/ar/guides/verification">الدليل</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">التحقق: الدخل من المعاملات</td><td className="px-4 py-3">استخلاص الدخل والتوظيف من المعاملات البنكية.</td><td className="px-4 py-3">قيد الإعداد</td><td className="px-4 py-3">يتطلب بيانات بنكية حية</td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">eID</td><td className="px-4 py-3">فحص الهوية عن بُعد وصورة السيلفي، مع الحالة وتقرير PDF. للعملاء الكنديين فقط حالياً.</td><td className="px-4 py-3">Partner API بمفتاح</td><td className="px-4 py-3"><code>POST /v1/kyc/eid</code>, <a href="/ar/guides/eid">الدليل</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">Insights: تحليل التدفق النقدي</td><td className="px-4 py-3">معاملات مصنّفة، وانتظام الدخل، وعلامات المخاطر، ومعدل الادخار، ونسبة الدين.</td><td className="px-4 py-3">وحدة التحكم، على بيانات بيئة الاختبار</td><td className="px-4 py-3"><code>GET /v1/bank-connections/{"{id}"}/analysis</code></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">تقييم المخاطر</td><td className="px-4 py-3">الحكم مع تحمّل المخاطر والقدرة ومخاطر الامتثال والملاءمة.</td><td className="px-4 py-3">Partner API بمفتاح</td><td className="px-4 py-3"><code>POST /v1/kyc/assess</code>, <a href="/ar/guides/risk-assessment">الدليل</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">التصنيف وسياسات التصنيف</td><td className="px-4 py-3">درجة ائتمانية لحالة، والسياسات التي تحددها.</td><td className="px-4 py-3">وحدة التحكم. عبر مفتاح API: قيد الإعداد</td><td className="px-4 py-3"><a href="/ar/guides/scoring">التصنيف</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">الحالات (Cases)</td><td className="px-4 py-3">تجمع الوثائق والروابط والقرارات الخاصة بمتقدّم واحد.</td><td className="px-4 py-3">وحدة التحكم</td><td className="px-4 py-3"><a href="/console-api/overview">مرجع Console API</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">Webhooks</td><td className="px-4 py-3">أحداث موقّعة تُرسَل إلى عنوانك. وتُدار النقاط الطرفية في وحدة التحكم.</td><td className="px-4 py-3">الاستقبال: Partner API بمفتاح. الإدارة: وحدة التحكم</td><td className="px-4 py-3"><a href="/ar/guides/webhooks">الدليل</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">مفاتيح API</td><td className="px-4 py-3">إنشاء المفاتيح وتحديد نطاقها وإبطالها.</td><td className="px-4 py-3">وحدة التحكم</td><td className="px-4 py-3"><a href="/ar/authentication">المصادقة</a></td></tr>
          <tr className="border-t border-gray-200 dark:border-gray-800"><td className="px-4 py-3 font-medium">Ask Sahl</td><td className="px-4 py-3">مساعد داخل وحدة التحكم.</td><td className="px-4 py-3">وحدة التحكم</td><td className="px-4 py-3">لا يوجد مسار في Partner API</td></tr>
        </tbody>
      </table>
    </div>

    <p className="mt-4 text-sm text-gray-600 dark:text-gray-400">التوفر مستخلص من شيفرة API. «Partner API بمفتاح» تعني أن مفتاح API ذا النطاق المناسب يستدعيها. و«وحدة التحكم» تعني أن عضواً مسجَّل الدخول يستخدمها في وحدة التحكم. و«قيد الإعداد» تعني أنه لا يوجد مسار ينفّذها بعد. لا يوجد حالياً مزوّد بيانات بنكية حية موصول بـ API، ولذلك فإن البيانات البنكية في وحدة التحكم محاكاة في بيئة الاختبار. ويوثّق <a href="/console-api/overview" className="underline">مرجع Console API</a> مسارات وحدة التحكم للاطلاع فقط: فهي تتطلب جلسة تسجيل دخول لا مفتاح API. راجع أيضاً <a href="/bank-coverage" className="underline">التغطية البنكية</a> و<a href="/coverage" className="underline">التغطية</a>.</p>
  </section>

  <section className="mt-16">
    <h2 className="text-2xl font-semibold tracking-tight text-gray-950 dark:text-white">نفّذ أول استدعاء لك</h2>
    <p className="mt-2 text-gray-600 dark:text-gray-400">اضبط SAHL\_API\_KEY على مفتاح sandbox، ثم اقرأ بطاقة تعريف وطنية مغربية تجريبية (CIN).</p>

    <div className="mt-5">
      ```bash cURL theme={null}
      curl -X POST https://app.sahlfinancial.com/api/v1/kyc/extract \
        -H "Authorization: Bearer $SAHL_API_KEY" \
        -F "files=@cin-test.jpg" \
        -F "doc_type=national_id" \
        -F "reference=client-0001" \
        -F "environment=sandbox" > extracted.json
      ```
    </div>
  </section>

  <section className="mt-16 flex flex-wrap gap-x-8 gap-y-3 border-t border-gray-200 pt-8 text-sm dark:border-gray-800">
    <a href="/changelog">سجل التغييرات</a>
    <a href="/postman">Postman</a>
    <a href="/ar/go-live">قائمة التحقق قبل الإنتاج</a>
    <a href="mailto:contact@sahlfinancial.com">دعم المطورين: [contact@sahlfinancial.com](mailto:contact@sahlfinancial.com)</a>
  </section>
</div>


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