واجهة البي البرمجية (API)

من نظامك إلى دفعة موثّقة

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

  • واجهة مجانية، بالأرصدة نفسها التي في التطبيق
  • المرسل لا يدفع شيئاً
  • إشعارات موقّعة يُعاد إرسالها تلقائياً
ما تقدّمه الواجهة

كل ما يفعله المستلم، من نظامك

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

إنشاء روابط الدفع

اختم ما ستسلّمه وأين، واختر من يمكنه الانضمام، واحصل على الرابط لترسله إلى المرسل.

متابعة كل خطوة

اطّلع على كل دفعة تستلمها: من انضمّ إليها، وهل تطابقت الصفقة، ورقم المعاملة.

إشعارات Webhook موقّعة

كل حدث موقّع بسرّك، ويُعاد إرساله إن لم يردّ خادمك.

تأكيد التحويلات التي تحقّقت منها

متى رأيت التحويل في سجل بريدي موب، أكّده من أدواتك الخاصة. يصدر الوصل فوراً.

أرصدة تحت السيطرة

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

استخدام واضح أمامك

الطلبات والأخطاء وأزمنة الاستجابة وإرسال الإشعارات، يوماً بيوم، في صفحة API بحسابك.

البداية

جاهز في أربع خطوات

بلا عقد ولا رسوم تفعيل: حساب موثّق ومفتاح.

  1. 1

    وثّق حسابك

    ارفع وثيقة رسمية من صفحة حسابك. الواجهة متاحة للحسابات الموثّقة بوثيقة رسمية.

  2. 2

    أنشئ مفتاحك

    مفتاح واحد لكل حساب، يظهر مرة واحدة. لا يحتفظ البي إلا ببصمة منه.

  3. 3

    أنشئ دفعتك الأولى

    طلب واحد بالمبلغ وبما ستسلّمه. أرسل الرابط الذي تتلقّاه في الرد.

  4. 4

    انتظر رقم المعاملة

    يُبلغك إشعار بوصوله. تحقّق من سجل بريدي موب، ثم أكّد.

افتح دليل البداية السريعة
POST /api/v1/payments
curl -X POST https://el-b.com/api/v1/payments \
  -H "Authorization: Bearer $ELB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_dzd": 45000,
    "deliverable": "iPhone 13, 128 GB",
    "fulfillment_target": "Bab Ezzouar, Algiers",
    "label": "Order #1042"
  }'
HTTP/1.1 201 Created

{
  "data": {
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "status": "open",
    "credit_state": "held"
  }
}
حالات الاستخدام

مصمّمة للمستلمين الذين يبيعون كل يوم

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

المتاجر الإلكترونية

تحصل كل طلبية على رابط دفع خاص بها عند إتمام الطلب، ورقمها كوصف للدفعة.

بوتات المحادثة

يرسل بوت Messenger أو Telegram أو WhatsApp الرابط، ويُعلن بنفسه عن كل خطوة تالية.

الأنظمة الداخلية

اربط كل رقم معاملة بطلبية، وأغلقها لحظة تأكيد التحويل.

مقدّمو الخدمات

يرسل المستقلّون والوكالات رابطاً موثّقاً لكل فاتورة، ويبدؤون العمل بعد تأكيد التحويل.

الخصوصية من الأساس

ما لا تشاركه الواجهة أبداً

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

  • رقم RIP يبقى بعيداً

    لا يظهر أبداً في ردود الواجهة ولا في الإشعارات. يراه المرسل في متصفّحه فقط، بعد تطابق الوصفين.

  • الصفقة تبقى مختومة

    تعرف اسم المرسل وهل حسابه موثّق، ولا ترى أبداً وصفه هو للصفقة.

  • المفاتيح بصمات

    يظهر مفتاحك مرة واحدة ويُحفظ كبصمة. جدّده أو أوقفه متى شئت.

  • لا أموال في المنتصف

    لا يحتفظ البي بأي أموال: يحوّل المرسل عبر بريدي موب، مباشرة إلى حسابك.

أسئلة

أسئلة المطوّرين

لديك سؤال آخر؟ راسلنا من صفحة الاتصال.

هل الواجهة مجانية؟

نعم. الطلبات مجانية. تكلّف الدفعة المُنشأة عبر الواجهة الأرصدة نفسها التي تكلّفها في التطبيق، والمرسل لا يدفع شيئاً.

من يمكنه الحصول على مفتاح API؟

الحسابات الموثّقة بوثيقة رسمية والتي لديها رقم RIP. لكل حساب مفتاح واحد، يُنشأ من صفحة API في الحساب.

هل يستلم البي الأموال أو يحتفظ بها؟

لا. البي شاهد رقمي، وليس بنكاً ولا محفظة ولا وسيط دفع. يحوّل المرسل عبر بريدي موب، مباشرة إلى حسابك.

هل يستطيع نظامي تأكيد التحويلات وحده؟

يستطيع نظامك استدعاء مسار التأكيد، لكنك وحدك من يمكنه مراجعة سجل بريدي موب: لا تؤكّد الدفعة إلا بعد أن ترى التحويل فيه. وإن لم تردّ، تتأكّد الدفعة تلقائياً بعد 72 ساعة.

هل يمرّ رقم RIP عبر الواجهة؟

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

بأي لغة كُتب التوثيق؟

بالإنجليزية، مع أمثلة بلغات cURL وPHP وJavaScript وPython. أما هذه الصفحة فمتاحة بالعربية والفرنسية والإنجليزية.

رابط دفعتك الأولى على بُعد طلب واحد

أنشئ مفتاحك من حسابك، ثم اتّبع دليل البداية السريعة.