ERP Cloud Systems - ربط M-Pesa

ربط M-Pesa

يتيح ربط M-Pesa معالجة المعاملات من خلال مزود بوابة الدفع M-Pesa.
يُسهل هذا الربط عملية الدفع بين تطبيق M-Pesa ونظام ERPNext، ويُستخدم حصريًا مع نقطة البيع (POS) لتسهيل عمليات الدفع.

ملاحظة: هذا الربط لا يعمل مع متجر التسوق الإلكتروني (Shopping Cart).

للإعداد، انتقل إلى:

الربط > المدفوعات > إعدادات M-Pesa

1. كيفية الحصول على بيانات اعتماد M-Pesa

لتفعيل بيانات اعتماد واجهة برمجة التطبيقات (API Credentials):

1. قم بتسجيل الدخول إلى حسابك في M-Pesa.
2. افتح قسم Go Liveفي التطبيق واتبع الخطوات المطلوبة للحصول على موافقة التطبيق.
3. بعد اجتياز جميع حالات الاختبار بنجاح ومطابقة النتائج المتوقعة مع النهائية، قدّم المستندات المطلوبة واتبع الخطوات للحصول على بيانات الاعتماد النهائيةلتطبيقك.
4. استخدم التفاصيل الموجودة في قسم Production URL and Credentialsضمن إعدادات M-Pesa في

2. إعداد M-Pesa

لتفعيل M-Pesa Express، يجب إدخال جميع المعاملات الإلزامية التي حصلت عليها من M-Pesa.وإذا كنت ترغب في تجربة الإعداد أولًا، يمكنك اختيار بيئة Staging واستخدام بيانات الاعتماد الخاصة بها بعد إنشاء تطبيق منفصل في M-Pesa.

عند تفعيل الخدمة، سيقوم النظام تلقائيًا بانشاء سجل Payment Gateway وحساب في دليل الحسابات (Chart of Accounts) بنوع حساب Bank.

إنشاء وضع دفع (Mode of Payment) بنفس اسم الحساب الذي تم إنشاؤه في بوابة الدفع.

إضافة حقول مخصصة في إعدادات POS لمعالجة مدفوعات نقاط البيع.

3. مدفوعات M-Pesa في نقطة البيع (POS)

عند إعداد ملف تعريف POS باستخدام وضع الدفع M-Pesa، سيظهر قسم جديد يسمى معلومات إضافية (Additional Information) في شاشة الدفع.

يحتوي هذا القسم على حقلين تمت إضافتهما تلقائيًا عند تفعيل إعدادات M-Pesa.

بمجرد إدخال رقم هاتف العميل، يمكن لمستخدم POS إرسال طلب دفع مباشر إلى تطبيق M-Pesa الخاص بالعميل.

يتلقى العميل إشعارًا في تطبيق M-Pesa لتأكيد الدفع.

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

4. رصيد حساب M-Pesa

يمكنك التحقق من رصيد حساب M-Pesa المرتبط من خلال الضغط على زر Get Account Balance.
سيعرض النظام تفاصيل الرصيد في لوحة المعلومات الخاصة بالحساب داخل ERPNext.

5. العملات المدعومة

يعمل ربط M-Pesa فقط مع الشركات التي تستخدم KSH (الشلن الكيني) كعملة رئيسية للشركة.