الهندسة · 11 دقيقة قراءة
واجهة المطوّرين
اجمع واصرف ببضعة استدعاءات.
واجهة نظيفة مصمّمة للهاتف المحمول: بيانات اعتماد عميل OAuth2، بيئة اختبار، الدفع بالإشعار وإشعارات موقّعة مُعاد إرسالها — ادمج التحصيل والصرف في بعد ظهيرة.
بالتفصيل
واجهة المطوّرين مبنية للأموال، لا للطلبات فقط. تبادل بيانات اعتماد العميل برمز قصير الأجل، ثم ادفع رسوماً إلى عميل؛ يؤكّدها في محفظته، فيصلك إشعار موقّع لحظة تصفيتها. كل استدعاء مقاوم للتكرار، فإعادة المحاولة بعد انقطاع الاتصال لا تُحصّل مرتين أبداً.
تنتقل الرسوم عبر دورة حياة واضحة — معلّقة، مُصرّح بها، مكتملة، مرفوضة أو منتهية — يمكنك استعلامها أو استقبالها عبر إشعار. الإشعارات موقّعة بـ HMAC-SHA256 ومُعاد إرسالها حتى الإقرار، فتثق أنظمتك بكل استدعاء عائد، ونقاط الرصيد والمعاملات تتيح لك المطابقة. تُشغّل بيئة الاختبار العقد نفسه كالإنتاج، والقنوات المالية مجرّدة خلف الواجهة، فتدمج مرة واحدة وتبدّل المزوّدين دون تغيير كودك.
لماذا يهمّ
مبنية لتكون جديرة بالثقة.
- بيانات اعتماد عميل OAuth2 بمفاتيح بيئة اختبار وإنتاج.
- الدفع بالإشعار (STK push) مع استعلام الحالة.
- إشعارات موقّعة بـ HMAC-SHA256 ومُعاد إرسالها تثق بها أنظمتك.
ما بالداخل
واجهة المطوّرين — بالتفصيل.
01
رموز OAuth2
بادل بيانات اعتماد العميل برمز حامل.
02
الرسوم والحالة
ادفع رسوماً واستعلم دورة حياتها.
03
الإشعارات
استدعاءات موقّعة لحظة تصفية الرسوم.
04
الرصيد والسجل
استعلم أرصدة التحصيل والمعاملات.
تدفّقات حقيقية
كيف تعمل عملياً.
بدّل بين الرحلات التي تتولّاها هذه القدرة. كل واحدة تفحص الرصيد والحدود، ثم تنتظر التصريح برمز PIN أو بصمة حيوية قبل تسجيل قيود متوازنة في الدفتر.
إشعار التاجر (STK)
يدفع التاجر رسوماً عبر دورة حياتها؛ ويوافق العميل على إشعار.
مُصرّح به بـ رمز PIN أو بصمة حيوية — لا يُسجَّل شيء في الدفتر حتى يؤكّد العميل.
- فحص الرصيد والحد أولاً
- بوابة التحقّق / التصريح
- تسجيل مدينات ودائنات متوازنة
العميل
النظام
01
النظاميدفع التاجر رسوماً
02
النظامأنشئ الرسوم · الحالة = معلّقة
العميليظهر الإشعار على الهاتف
03
04
النظام · يتحقّقتحقّق وافحص الرصيد
العميل · يتحقّقصرّح — برمز PIN أو بصمة حيوية
05
06
النظاماخصم الدافع، أضِف للتاجر
07
النظامالحالة = مكتملة
08
النظامإشعار موقّع + إعادة إرسال حتى الإقرار
النظام · تمّدُفع · عُرض الإيصال
خطوة التحقّق / رمز PIN مكتمل
190+
دول يمكنك الإطلاق فيها
6
تطبيقات أصلية، منصة واحدة
4
قنوات — تطبيق · USSD · ويب · واجهة برمجية
100%
قيد مزدوج، متوازن دائماً
المزيد من المنصة
نواة واحدة، كل قدرة.
أسئلة
واجهة المطوّرين: ما تسأل عنه الفرق قبل الإطلاق
كيف نُثبت هويتنا؟
باستخدام بيانات اعتماد العميل في OAuth2: استبدل معرّف العميل والسرّ برمز وصول من نوع bearer. وتستخدم بيئة الاختبار وبيئة الإنتاج مفاتيح منفصلة.
هل توجد بيئة اختبار؟
نعم. سجّل للحصول على مفاتيح بيئة الاختبار، واختبر عمليات التحصيل وحالاتها وإشعارات webhook قبل الإطلاق، بواجهة API نفسها المستخدمة في الإنتاج.
كيف نعرف أن الدفعة اكتملت؟
استعلم عن حالة عملية التحصيل، أو استقبل إشعار webhook لحظة اكتمالها. تُوقَّع الإشعارات بـ HMAC-SHA256، وأي إرسال لا يتلقى ردًا 2xx يُعاد حتى 10 مرات على مدى يومين تقريبًا.
هل يمكننا التحصيل والصرف عبر API؟
نعم. أرسل طلبات الدفع بالإشعار للتحصيل، واستعلم عن أرصدة التحصيل وسجل المعاملات لأغراض المطابقة.
أين نجد المرجع؟
يغطي توثيق المطورين كل نقطة نهاية وطلب واستجابة، مع أدلة لصفحة الدفع وإشعارات webhook والإطلاق.
جاهز لإطلاق محفظتك؟
احجز عرضاً توضيحياً وسنُنشئ علامتك ودولتك وقنواتك المالية — ونأخذك في جولة عبر التطبيقات والإدارة والواجهة البرمجية.
تفضّل التحدث؟ اتصل على +254 746 883809