الانتقال إلى المحتوى الرئيسي

المطوّرون والأتمتة

واجهة REST API وWebhooks وتوقيع إلكتروني للأنظمة المحيطة بمحفظة قروضك

استخدم واجهة API لقراءة المقترضين والقروض والأقساط وكتابتها من برامجك أنت، وWebhooks لتعرف بالتغييرات لحظة حدوثها، والتوقيع الإلكتروني المدمج لتوقيع مستندات القروض دون خدمة توقيع منفصلة.

ابدأ التجربة المجانيةاقرأ مرجع API
اعرض أول 20 مقترضاًbash
curl "https://api.lendbox.io/borrowers?page=1&limit=20" \
  -H "Authorization: Bearer live_your_api_key"
الحالة
مدمج
الخطط
واجهة API في خطط Business وGrowth وEnterprise
البيئات
بيئة الاختبار وبيئة الإنتاج
التوثيق
api.lendbox.io/docs

بداية سريعة

أربع خطوات من الصفر إلى أول استجابة.

  1. 1أنشئ مفتاحاًفي لوحة التحكم، افتح API Integration → REST API واختر Generate New API Key. احفظه في مكان آمن. إنشاء مفتاح جديد يوقف المفتاح القديم عن العمل، لذا غيّره كلما غادر شخص لديه صلاحية الوصول.
  2. 2اختر البيئةبيئة الاختبار وبيئة الإنتاج منفصلتان، ولكلٍّ منهما عنوان URL أساسي ومفاتيح وبيانات خاصة: https://sandbox-api.lendbox.io وhttps://api.lendbox.io. تبدأ مفاتيح الاختبار بـ sandbox_ ومفاتيح الإنتاج بـ live_. ابنِ على بيئة الاختبار أولاً.
  3. 3أرسل المفتاح مع كل طلبمرّره كرمز bearer في ترويسة Authorization. ورموز الاستجابة التي تعيدها الواجهة مدرجة في صفحة لوحة التحكم نفسها.
  4. 4اعمل انطلاقاً من المرجعكل نقطة نهاية ومعامل وشكل استجابة موجود في التوثيق العام على api.lendbox.io/docs. فقائمة المقترضين، مثلاً، تُقسَّم إلى صفحات بالمعاملين page وlimit.
صفحة REST API مع بطاقة مفتاح API وترويسة Authorization وعنواني URL الأساسيين للاختبار والإنتاج

مفتاح واحد لكل مساحة عمل، معروض مع الترويسة التي يُرسَل فيها وعنواني URL الأساسيين.

ما تبنيه الفرق عليها

تندرج معظم التكاملات تحت واحد من أربعة أنماط. وكلٌّ منها يستخدم نقاط نهاية موجودة في المرجع العام اليوم.

  • استقبال العملاء من تطبيقك أنت

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

  • قيد الأقساط من قناة أخرى

    حين يصل المال إلى مكان لا يتصل به Lendbox، مثل حساب مصرفي أو دورة رواتب، قيّد القسط على قرضه بطلب واحد من النظام الذي رأى الدفعة.

  • تغذية تقاريرك أنت

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

  • إطلاق مسارات عملك الخاصة

    استخدم حدث إنشاء قسط (repayment created) لإرسال رسالة شكر من نظام CRM لديك، أو حدث إنشاء قرض (loan created) لفتح ملف في نظام المستندات لديك.

كيف تعمل مفاتيح API

  • مفتاح واحد لكل مساحة عمل. وهو يعمل بصلاحيات مالك مساحة العمل، فعامله ككلمة مرور المالك واحفظه على خادمك، لا في متصفح أو تطبيق أبداً.
  • لا تنتهي صلاحية المفاتيح من تلقاء نفسها. أعد إنشاء المفتاح من لوحة التحكم لإلغائه.
  • الاطلاع على صفحة API وإدارتها صلاحية مستقلة للموظفين، فتستطيع حصرها في من يبنون التكاملات.
  • الوصول إلى API متضمَّن في خطط Business وGrowth وEnterprise.

Webhooks: اعرف بالتغييرات لحظة حدوثها

أضف Webhook من API Integration → Webhooks: أدخل عنوان URL لنقطة نهاية تتحكم فيها، وحدّد الأحداث التي يجب أن تستقبلها. يرسل Lendbox طلب POST بصيغة JSON إلى ذلك العنوان في كل مرة يقع فيها أحدها.

أحداث Webhooks في Lendbox، حسب السجل ونوع التغيير
السجلإنشاءتحديثحذف
القرضنعمنعمنعم
المقترضنعمنعمنعم
القسطنعمنعمنعم
المستثمرنعمنعمنعم
منتج المستثمرنعمنعمنعم
حساب المستثمرنعمنعمنعم
الترويسات في كل إرسالhttp
POST /your/webhook/endpoint
Content-Type: application/json
X-LendBox-Event: <event name>
X-LendBox-Webhook-ID: <your webhook's id>
X-LendBox-Event
أي حدث وقع، لتستطيع نقطة نهاية واحدة معالجة عدة أحداث.
X-LendBox-Webhook-ID
أي Webhook من Webhooks لديك أرسل هذا الإرسال.

بناء مستقبِل يصمد

  1. ردّ بسرعة

    ينتظر Lendbox عشر ثوانٍ حتى تجيب نقطة النهاية لديك. أكّد استلام الإرسال أولاً وأنجز العمل البطيء بعد ذلك.

  2. تعامل مع الإرسال كإشارة

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

  3. طابِق بشكل مجدول

    يُرسَل كل حدث مرة واحدة. والقراءة الليلية عبر واجهة API تلتقط أي شيء فات نقطة النهاية لديك أثناء توقفها، والمعالجات المتساوية الأثر (idempotent) تجعل التكرار غير ضار.

التوقيع الإلكتروني لمستندات القروض، مدمج

تُوقَّع اتفاقيات القروض وكشوف الحساب وجداول السداد داخل Lendbox، فتبقى النسخة الموقَّعة على القرض لا في حساب لدى خدمة أخرى.

  1. 1ابنِ القالب

    من Documents → Loan Templates، اكتب الاتفاقية في المحرر مع عناصر نائبة لبيانات المقترض والقرض، أو ارفع مستند Word يحتوي العناصر النائبة مسبقاً.

  2. 2حدّد أماكن التوقيع

    في قوالبك الخاصة، ضع حقول التوقيع والنص مرة واحدة، فيحصل كل قرض يستخدم ذلك القالب على مناطق التوقيع نفسها. ويأتي المستندان المدمجان Loan Statement (كشف الحساب) وRepayment Schedule (جدول السداد) بخانات التوقيع في مكانها.

  3. 3أرسل الروابط

    من تبويب Documents في القرض، اختر Send for Signature. وقّع بنفسك، وأرسل إلى المقترض رابطه بالبريد الإلكتروني، وأضف موظف القروض، وأضف موقّعين آخرين مثل أحد الأقارب.

  4. 4اجمع التوقيعات

    يرسم كل موقّع توقيعه على الشاشة ويحفظ. وكل توقيع ينتج نسخة جديدة من ملف PDF، فيعمل التوقيع المقابل وتبقى النسخ السابقة على القرض.

نافذة Signing Links على اتفاقية قرض مع خيارات المقترض وموظف القروض وموقّع إضافي

تذهب روابط التوقيع إلى المقترض وموظف القروض وأي شخص آخر تضيفه.

كل رابط توقيع يعمل مرة واحدة وتنتهي صلاحيته بعد سبعة أيام.

ما يحفظه سجل التوقيع

يُسجَّل

  • اسم الموقّع ودوره: مقترض، أو موظف قروض، أو غير ذلك
  • وقت التوقيع
  • كل نسخة من المستند، قبل كل توقيع وبعده

لا يُسجَّل

  • رمز لمرة واحدة: لا يُرسَل أي رمز، فحيازة الرابط المرسَل بالبريد الإلكتروني هي ما يحدد هوية الموقّع
  • عنوان IP للموقّع أو جهازه
  • شهادة إتمام منفصلة

يستطيع الموظفون حفظ توقيعهم من Settings → Admin → My signature، ثم ملء كل حقل مخصّص لهم بنقرة واحدة.

الأسئلة الشائعة

هل لدى Lendbox واجهة API عامة؟
نعم. إنها واجهة REST API بتوثيق عام على api.lendbox.io/docs، وببيئتي اختبار وإنتاج منفصلتين، ومصادقة برمز bearer بمفتاح تنشئه من لوحة التحكم.
أي الخطط تشمل الوصول إلى API؟
Business وGrowth وEnterprise. أما التوقيع الإلكتروني فمتضمَّن في كل خطة.
هل يستطيع Webhook إخباري عند قيد قسط؟
نعم. اشترك في حدث إنشاء قسط (repayment created). يرسل Lendbox إلى نقطة النهاية لديك عند إنشاء القسط، ثم تستطيع جلبه من واجهة API للحصول على السجل الكامل.
هل التوقيعات الإلكترونية في Lendbox ملزمة قانونياً؟
يعتمد ذلك على القانون حيث تُقرض وعلى المستند، فراجع مستشارك القانوني. يسجّل Lendbox من وقّع، وبأي دور، ومتى، ويحتفظ بكل نسخة من ملف PDF الموقَّع على القرض.
هل يستطيع المقترضون التوقيع على هواتفهم؟
نعم. يُفتح رابط التوقيع في متصفح الهاتف ويرسم المقترض توقيعه بإصبعه. لا يوجد ما يُثبَّت.
هل أستطيع ربط Lendbox ببرنامج محاسبة عبر واجهة API؟
تستطيع بناء ذلك. فواجهة API تقرأ المقترضين والقروض والأقساط، وWebhooks تعلن التغييرات، فيستطيع مطوّر دفعها إلى نظام آخر. ولا يوجد رابط جاهز لـ QuickBooks أو Xero.

تابع القراءة

ابنِ على Lendbox

ابدأ تجربة مجانية، واقرأ مرجع API، واربط بيئة الإنتاج حين تكون جاهزاً.

ابدأ التجربة المجانية

لا حاجة لبطاقة

اقرأ توثيق API