دليل شامل لمدفوعات M-PESA

يتيح لك النظام قبول مدفوعات M-PESA على فواتيرك مباشرة — يستلم العميل طلب STK Push على هاتفه، ويُدخل رقمه السري لإتمام الدفع، ويقوم النظام بالتحديث تلقائيًا بمجرد تأكيد Safaricom للمعاملة. يغطي هذا الدليل سير العمل الكامل: من التفعيل وإعداد بيانات الاعتماد، مرورًا بتنفيذ عملية الدفع، وصولًا إلى التعامل مع الأخطاء.

قبل البدء

• تأكد من امتلاكك لصلاحية “تعديل خيارات الدفع” للوصول إلى إعدادات M-PESA. المستخدمون الذين لا يملكون هذه الصلاحية لن يظهر لهم عنصر قائمة وسائل الدفع.
• لتفعيل M-PESA، ستحتاج إلى بيانات اعتماد Daraja التالية، والتي يتم الحصول عليها من Safaricom: مفتاح المستهلك وسر المستهلك (من بوابة Daraja ضمن “تطبيقاتي”)، ورمز الحساب التجاري (رقم الـ Paybill أو الـ Till المسجّل لدى Safaricom)، ومفتاح المرور (يُرسَل إليك من Safaricom عبر البريد الإلكتروني بعد الموافقة على تطبيقك لبيئة الإنتاج).

لتفعيل M-PESA، ينتقل مسؤول الحساب إلى “وسائل الدفع” ويقوم بتفعيل M-PESA — يفتح نموذج بيانات الاعتماد فورًا. يتطلب النموذج بيانات اعتماد Daraja المذكورة أعلاه، إلى جانب اختيار بيئة التشغيل:

• الإنتاج (Production): للمدفوعات الفعلية — يستخدم الرابط https://api.safaricom.co.ke. 
• التجربة (Sandbox): للاختبار فقط — يستخدم الرابط https://sandbox.safaricom.co.ke.

يتوفر زر “اختبار الاتصال” في النموذج للتحقق من بيانات الاعتماد قبل الحفظ. بمجرد الحفظ بنجاح، يصبح M-PESA مفعّلاً ويظهر كخيار دفع على الفواتير.

إذا تم إغلاق النموذج قبل الحفظ، ستظهر على بطاقة M-PESA علامة تحذير بعنوان “الإعداد مطلوب” — انقر على رابط الإعدادات الموجود على البطاقة لإكمال الإعداد. لن يظهر M-PESA على الفواتير حتى يكتمل الإعداد.

يمكن تحديث بيانات اعتماد Daraja في أي وقت من خلال أيقونة الإعدادات (⚙) الموجودة على بطاقة M-PESA في صفحة وسائل الدفع. تُعرض الحقول الحساسة (سر المستهلك ومفتاح المرور) بشكل مُخفٍ على هيئة ••••••••[آخر 4 أحرف]، ولا تُفعَّل للتعديل إلا عند النقر عليها. تحديث بيانات الاعتماد يؤثر فقط على المدفوعات المستقبلية ولا يؤثر على السجلات السابقة.

يمكن إيقاف تفعيل M-PESA في أي وقت من خلال إيقافه من صفحة “وسائل الدفع” بعد تأكيد الطلب المنبثق. عند التعطيل، تتم إزالة M-PESA من جميع خيارات الدفع المستقبلية على الفواتير، بينما تبقى سجلات المدفوعات السابقة سليمة وغير متأثرة.

•  افتح الفاتورة التي ترغب في دفعها وانقر على “إضافة دفعة“.

•  اختر M-PESA من بين خيارات الدفع المتاحة.

•  تظهر نافذة منبثقة — أدخل رقم هاتف الدافع المسجّل في M-PESA بالصيغة 254XXXXXXXXX (مثال: 254712345678).

يجب إدخال رقم الهاتف يدويًا في كل مرة — لا يتم تعبئته مسبقًا من بيانات العميل. إذا كانت الصيغة غير صحيحة، تظهر الرسالة: “يُرجى إدخال رقم هاتف M-PESA صالح بالصيغة 254XXXXXXXXX.”

4.  راجع التعليمات المعروضة على الشاشة: “ستصلك رسالة طلب من M-PESA على هاتفك. أدخل رقمك السري لإتمام الدفع.”
5. انقر على “إرسال” — تُغلَق النافذة المنبثقة ويُرسَل طلب الدفع إلى Safaricom.
6.  تظهر شاشة انتظار تحتوي على عداد تنازلي وحالة “جارٍ الانتظار…” — أبقِ هذه الشاشة مفتوحة.
7. على هاتف الدافع، تظهر رسالة طلب STK Push — يُدخل رقمه السري الخاص بـ M-PESA لتفويض الدفع.
8. بمجرد تأكيد Safaricom للدفع، تُعاد توجيه الشاشة إلى صفحة نجاح الدفع التي تعرض رقم إيصال M-PESA.

يُحدَّد مبلغ الدفع تلقائيًا بالرصيد الكامل المستحق على الفاتورة، مقربًا لأعلى إلى أقرب شلن كيني كامل (مثال: KES 1,500.50 يُرسَل كـ KES 1,501). لا يدعم التدفق القياسي المدفوعات الجزئية.

تتغيّر حالة الفاتورة إلى “مدفوعة” ويتم إنشاء سجل دفعة يحتوي على رقم إيصال M-PESA، ورقم هاتف الدافع المُخفى جزئيًا (مثال: 254•••••••78)، والمبلغ المدفوع بعملة الشلن الكيني (KES)، وتوقيت الدفع، ووسيلة الدفع. تظهر الدفعة في تبويب “سجل المدفوعات” الخاص بالفاتورة، ويتم إنشاء قيد محاسبي وفق نفس القواعد المُتّبعة مع جميع وسائل الدفع الأخرى.

تبقى شاشة الانتظار مفتوحة بينما يتحقق النظام من حالة الدفع. إذا لم يصل أي تأكيد خلال 60 ثانية، يستعلم النظام تلقائيًا من Safaricom، وتتحدّث الشاشة إلى “جارٍ التحقق…” — مع إعادة المحاولة كل 10 ثوانٍ، بحد أقصى 3 محاولات.

في معظم حالات الفشل — بما في ذلك الإلغاء، أو انتهاء المهلة، أو عدم كفاية الرصيد، أو وجود جلسة USSD نشطة على الهاتف، أو عدم توفر الخدمة مؤقتًا — تظهر رسالة توضيحية إلى جانب زر “المحاولة مرة أخرى” الذي يعيدك إلى خطوة إدخال رقم الهاتف.

هناك حالتان لا يتوفر فيهما خيار إعادة المحاولة: عند إدخال الرقم السري بشكل خاطئ عدة مرات (يُرجى التواصل مع Safaricom كما هو موضح في الرسالة)، وعند تعذّر تأكيد حالة الدفع بعد استنفاد جميع المحاولات. في هذه الحالة الأخيرة، تبقى الفاتورة بحالة “معلّقة” وتظهر الرسالة: “لم نتمكن من تأكيد حالة دفعتك. يُرجى مراجعة رسائل M-PESA الخاصة بك. في حال تم خصم المبلغ، يُرجى التواصل مع الدعم مع ذكر رقم الإيصال.” لا تحاول دفع الفاتورة مرة أخرى قبل التحقق مع Safaricom مما إذا كان المبلغ قد خُصم.