PesaBridge
توثيق المطورين

ابنِ باستخدام واجهة PesaBridge البرمجية.

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

العنوان الأساسي

https://pesa-bridge.com/api/bridgepay/v1

POST/oauth/token
POST/partner/stk
GET/partner/status
POST/partner/b2c
POST/checkout/create
POST/partner/webhooks/endpoints

53 نقطة نهاية · OpenAPI 3 · JSON عبر HTTPS

مرجع الواجهة البرمجية

واجهة صغيرة يمكن التنبّؤ بها.

POST/oauth/tokenبادل بيانات اعتماد العميل برمز حامل.
POST/partner/stkادفع رسوماً (الدفع بالإشعار) إلى عميل.
GET/partner/statusاستعلم عن حالة رسوم.
GET/partner/balanceاستعلم عن رصيد حساب تحصيل.
POST/biz/requestطلب دفع من التاجر.
POST/ussdاستدعاء بوابة قائمة USSD.

القنوات المالية والتكاملات

اربط فقط ما يحتاجه سوقك.

القنوات المالية محوّلات قابلة للتوصيل بواجهة واحدة — تحصيل وصرف ورصيد واستدعاءات عائدة — فالموصّل الجديد لا يمسّ النواة أبداً.

البنوك

تسوية RTGS / ACH / SWIFT / SEPA وإدارة حسابات النوسترو.

الأموال عبر الهاتف

مشغّلو الأموال عبر الهاتف في كل سوق، عبر محوّلات القنوات المالية.

البطاقات ومزوّدو خدمات الدفع

قبول بطاقات الشبكات الكبرى وتكاملات المعالجين.

جهات الفواتير وشركات الاتصالات

المرافق والتلفزيون والحكومة والرسوم الدراسية وشحن رصيد الاتصال.

مصمّمة للأموال

واجهة برمجية تتصرّف كنظام مدفوعات.

معظم الواجهات تنقل بيانات. هذه تنقل أموالاً — لذا فهي مقاومة للتكرار وموقّعة ومبنية حول دورة حياة رسوم يمكنك الوثوق بها.

المصادقة هي بيانات اعتماد عميل OAuth2: تبادل مفتاحاً وسرّاً برمز حامل قصير الأجل. كل استدعاء يغيّر الحالة يحمل مفتاح مقاومة للتكرار، فتُسوّى إعادة المحاولة الشبكية مرة واحدة تماماً — أهمّ خاصية على الإطلاق حين تكون أموال حقيقية على المحك.

التحصيل هو رسوم. تدفعها إلى رقم العميل؛ يظهر إشعار دفع على هاتفه؛ يؤكّده برمز PIN. تنتقل الرسوم عبر معلّقة ← مُصرّح بها ← مكتملة (أو مرفوضة / منتهية / فاشلة)، وتعرف النتيجة بطريقتين: استعلام نقطة الحالة، أو — والأفضل — استقبال إشعار ويب لحظة تغيّرها.

الإشعارات موقّعة بـ HMAC-SHA256 مقابل سرّ لا تعرفه إلا أنت وPesaBridge، ومُعاد إرسالها بتراجع تدريجي حتى تُقرّها نقطتك — فتبني عليها دون خوف من حدث فائت أو مزيّف. نقاط الرصيد والمعاملات تُغلق حلقة المطابقة، وتُشغّل بيئة الاختبار العقد نفسه، فتُطلق بثقة.

دورة حياة الرسوم

pendingauthorisedcompleteddeclinedexpiredfailed
webhook · charge.completed
{
  "event": "charge.completed",
  "charge_ref": "STK9F2A",
  "amount": 250.00,
  "currency": "KES",
  "state": "completed",
  "signature": "hmac-sha256…"
}

الأمان والامتثال

الثقة هي المنتج.

الخدمات المالية تحيا أو تموت على الصحّة والتحكّم. تُدمج PesaBridge كليهما في النواة.

قيد مزدوج بالتصميم

كل حركة تسجّل مدينات ودائنات متوازنة — تتوازن الدفاتر إلى الصفر، دائماً.

رمز PIN ومعرفة العميل والحدود

مستويات معرفة عميل قابلة للضبط، وحدود لكل معاملة وحدود يومية، ومحاولات PIN وقفل المحفظة.

مقاومة للتكرار وقابلة للاسترجاع

مفاتيح مقاومة التكرار توقف الخصم المزدوج؛ ومحرّك استرجاع موحّد يعكس أي قسم.

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

توقيعات HMAC-SHA256 وإعادة إرسال ليثق نظام الشريك بكل استدعاء عائد.

سجل تدقيق كامل

قيود دفتر ومعاملات غير قابلة للتعديل للجهات الرقابية والنزاعات.

امتثال لكل دولة

أنواع الهوية وقواعد معرفة العميل والتعرفات تتبدّل مع السوق، من الإعداد.

هل تواجه صعوبة؟

يجيب مهندسونا عن أسئلة الربط. أرسل إلينا مرجع الطلب وسنجد الاستدعاء بالضبط.