إعداد M-PESA كوسيلة دفع
يتيح النظام للحسابات الموجودة في كينيا تفعيل M-PESA كوسيلة دفع للفواتير من خلال ربط بيانات اعتماد Safaricom Daraja الخاصة بها. بمجرد الانتهاء من الإعداد، يصبح M-PESA متاحًا كخيار دفع على الفواتير مستقبلاً.
ملاحظة: تتوفر خدمة M-PESA فقط للحسابات التي تم فيها تحديد كينيا كدولة للحساب. إذا لم تظهر بطاقة M-PESA في صفحة وسائل الدفع، يُرجى التواصل مع مسؤول الحساب.
قبل البدء
- يجب أن تمتلك صلاحية “تعديل خيارات الدفع” للوصول إلى صفحة وسائل الدفع وكافة إعدادات M-PESA. المستخدمون الذين لا يملكون هذه الصلاحية لن يظهر لهم عنصر قائمة وسائل الدفع.
- جهّز بيانات اعتماد Safaricom Daraja الخاصة بك قبل بدء الإعداد: مفتاح المستهلك (Consumer Key)، والسر الخاص بالمستهلك (Consumer Secret)، ورمز الحساب التجاري (Business Shortcode)، ومفتاح المرور (Passkey). يتم الحصول على هذه البيانات من بوابة Daraja ومن Safaricom مباشرة.
الجزء الأول: تفعيل M-PESA
- من القائمة الرئيسية، انتقل إلى “وسائل الدفع” ضمن “إعدادات” الحساب.
- حدد موقع بطاقة M-PESA في القائمة.
- فعّل M-PESA — يفتح نموذج بيانات الاعتماد فورًا في نفس الدرج (drawer) لإكمال الإعداد.
لا يُعتبر M-PESA مفعّلًا ولن يظهر على الفواتير حتى يتم حفظ بيانات الاعتماد بنجاح. إذا أغلقت الدرج قبل الحفظ، ستظهر على بطاقة M-PESA علامة تحذير بعنوان “الإعداد مطلوب”. انقر على رابط الإعدادات الموجود على البطاقة للعودة وإكمال الإعداد.
الجزء الثاني: إعداد بيانات اعتماد Daraja (الإعداد الأولي)
بمجرد فتح درج بيانات الاعتماد، املأ الحقول التالية — جميع الحقول مطلوبة:
- البيئة (مطلوب): اختر “الإنتاج” (Production) للمعاملات الفعلية، أو “التجربة” (Sandbox) للاختبار. يكون الخيار الافتراضي عند التحميل الأول هو “الإنتاج”.
- بيئة الإنتاج تستخدم الرابط الأساسي: https://api.safaricom.co.ke
- بيئة التجربة تستخدم الرابط الأساسي: https://sandbox.safaricom.co.ke
- مفتاح المستهلك (مطلوب): يوجد في بوابة Daraja ضمن “تطبيقاتي” (My Apps).
- سر المستهلك (مطلوب): يوجد في بوابة Daraja ضمن “تطبيقاتي” (My Apps).
- رمز الحساب التجاري (مطلوب): رقم الـ Paybill أو الـ Till المسجّل لدى Safaricom.
- مفتاح المرور (مطلوب): يُرسَل من Safaricom عبر البريد الإلكتروني بعد الموافقة على تطبيقك لبيئة الإنتاج.
اختبار الاتصال قبل الحفظ:
انقر على “اختبار الاتصال” للتحقق من صحة بيانات الاعتماد مقابل نقطة نهاية Safaricom OAuth، باستخدام القيم المُدخلة حاليًا (وليس المحفوظة بعد):
- عند النجاح: تظهر الرسالة “تم الاتصال بنجاح.”
- عند الفشل: تظهر الرسالة “فشل الاتصال. يُرجى التحقق من بيانات الاعتماد والمحاولة مرة أخرى.”
انقر على “حفظ” — عند نجاح الحفظ، ستتم إعادة توجيهك إلى صفحة وسائل الدفع وتظهر الرسالة: “تم حفظ إعدادات M-PESA بنجاح.” يصبح M-PESA الآن مفعّلاً ومتاحًا كخيار دفع على الفواتير.
الجزء الثالث: تحديث بيانات الاعتماد بعد الإعداد
- من صفحة وسائل الدفع، انقر على أيقونة الترس (⚙) الموجودة على بطاقة M-PESA.
- تفتح صفحة الإعدادات معروضًا فيها بيانات الاعتماد المحفوظة:
- مفتاح المستهلك: يُعرض كاملاً.
- سر المستهلك: يُعرض مُخفيًا على شكل ••••••••[آخر 4 أحرف] — في حقل غير قابل للتعديل.
- رمز الحساب التجاري: يُعرض كاملاً.
- مفتاح المرور: يُعرض مُخفيًا على شكل ••••••••[آخر 4 أحرف] — في حقل غير قابل للتعديل.
- البيئة: تُعرض حسب الاختيار الحالي.
- انقر على أي حقل مُخفي لتفعيله للتعديل.
- عدّل الحقول التي ترغب في تحديثها.
- انقر على “اختبار الاتصال” إذا لزم الأمر، للتحقق من بيانات الاعتماد الجديدة قبل الحفظ.
- انقر على “حفظ” — تظهر الرسالة: “تم تحديث إعدادات M-PESA بنجاح.” وتبقى في صفحة الإعدادات.
تحديث بيانات الاعتماد يؤثر فقط على المدفوعات المستقبلية. تبقى جميع سجلات مدفوعات M-PESA السابقة دون تغيير.
الجزء الرابع: تعطيل M-PESA
- من صفحة وسائل الدفع، أوقف تفعيل M-PESA.
- يظهر مربع حوار للتأكيد — أكّد للمتابعة.
- تتم إزالة M-PESA من جميع خيارات الدفع على الفواتير مستقبلاً. تظهر الرسالة: “تم تعطيل M-PESA بنجاح.”
تبقى جميع مدفوعات M-PESA السابقة سليمة ولا تتأثر بعملية التعطيل.
ملاحظات أمنية
- يتم تشفير مفتاح المستهلك، وسر المستهلك، ومفتاح المرور في قاعدة البيانات، ولا يتم عرضها أبدًا في السجلات (logs)، أو استجابات الـ API، أو في أي مكان بواجهة الاستخدام.
- يتم تخزين آخر 4 أحرف فقط من الحقول المُخفية لأغراض العرض.
- يقتصر الوصول إلى صفحة الإعدادات على المستخدمين الذين يمتلكون صلاحية “تعديل خيارات الدفع”. محاولة الوصول إليها دون هذه الصلاحية تعرض الرسالة: “ليس لديك صلاحية الوصول إلى هذه الصفحة.”