الدفع الإلكتروني عبر باي موب

ما هو تكامل باي موب؟

باي موب (Paymob) بوابة دفع تتيح لعملاء متجرك الإلكتروني الدفع أونلاين بالبطاقة والمحفظة الإلكترونية وطرق دفع محلية أخرى في مصر والإمارات والسعودية وعُمان. بعد الربط، يظهر خيار الدفع الإلكتروني عند إتمام الطلب: ينتقل العميل إلى صفحة دفع آمنة من باي موب، يدفع، ويتحدد الطلب كمدفوع تلقائياً. لن تحتاج لتأكيد هذه المدفوعات يدوياً أبداً.

قبل أن تبدأ

تحتاج حساب تاجر في باي موب مع هذه القيم من لوحة تحكم باي موب تحت Settings > API Keys و Settings > Payment Integrations:

ربط باي موب بمتجر

1. اذهب إلى الإعدادات > التكاملات في بوابة الأعمال.
2. في بطاقة باي موب اضغط ربط Paymob.
3. اختر المتجر الذي تريد ربطه.
4. اختر دولة Paymob لحسابك. تظهر فقط الدول المطابقة لعملة متجرك: مصر (EGP)، الإمارات (AED)، السعودية (SAR)، أو عُمان (OMR).
5. الصق API Key و Secret Key و Public Key و HMAC Secret.
6. أضف أرقام التكامل (Integration IDs)، إدخال لكل طريقة دفع.
7. اختيارياً حدد رسوم الطلب (انظر أدناه).
8. احفظ. نختبر مفاتيحك مباشرة مع باي موب قبل حفظ أي شيء. لو في مفتاح غلط، الحفظ يترفض مع سبب واضح، فصحّح المفتاح واحفظ من جديد. نفس الفحص المباشر يتكرر مع كل تعديل على المفاتيح أو الإعدادات لاحقاً.

أضف رابط الاستجابة في باي موب

بعد الحفظ، تعرض صفحة التكامل رابط الاستجابة (Callback URL) مع زر نسخ. ضع هذا الرابط في لوحة تحكم باي موب حتى يخطرنا باي موب لحظة حدوث أي عملية دفع:

1. في لوحة باي موب افتح Settings > Payment Integrations وحرّر كل تكامل تستخدمه.
2. الصق الرابط في حقلي معالجة التكامل (Transaction processed callback) و استجابة المعاملة (Transaction response callback).
3. احفظ.

رسوم الدفع (اختياري)

يمكنك إضافة رسوم أو خصم يُطبق فقط عندما يدفع العميل إلكترونياً:

تظهر الرسوم كسطر مستقل في إجماليات إتمام الطلب قبل أن يؤكد العميل، وتدخل ضمن المبلغ الذي يحصّله باي موب.

تفعيل الدفع الإلكتروني لواجهة المتجر

بعد تفعيل ربط باي موب:

1. اذهب إلى الإعدادات > المتاجر، افتح المتجر، واختر تبويب المدفوعات ثم قسم واجهة المتجر.
2. فعّل الدفع الإلكتروني واحفظ.

سيظهر خيار الدفع الإلكتروني الآن في إتمام الطلب. قبل ربط بوابة دفع يبقى مفتاح الدفع الإلكتروني معطّلاً ويظهر بدلاً منه زر إعداد بوابة الدفع. كما لا يمكنك تعطيل البوابة أو حذفها والدفع الإلكتروني ما زال مفعّلاً.

سلوك الطلبات المدفوعة إلكترونياً

مدفوعات البوابة يديرها النظام من البداية للنهاية:

• يبدأ الطلب بحالة قيد الانتظار بينما يدفع العميل في صفحة باي موب.
• يتم تأكيد الدفع مع باي موب مباشرة، ثم يتحول الطلب إلى مدفوع تلقائياً. تعرض صفحة الطلب البوابة ورقم معاملة باي موب والبطاقة أو المحفظة المستخدمة.
• إجراءات الدفع اليدوية معطّلة لهذه الطلبات: لا تسجيل مدفوعات يدوياً، ولا تعديل مبالغ، ولا استردادات يدوية. هذا يبقي سجلاتك مطابقة تماماً لباي موب.
• إذا فشلت محاولة دفع، يستطيع العميل المحاولة مرة أخرى من المتجر. كل محاولة تُسجل على الطلب.
• الطلب غير المدفوع الذي لا يكتمل دفعه يُلغى تلقائياً بعد ساعات قليلة، فلا تتراكم الطلبات المهجورة كطلبات معلّقة.

الاستردادات للطلبات المدفوعة إلكترونياً

استردادات مدفوعات البوابة تتم دائماً عبر باي موب ودائماً بكامل المبلغ المدفوع:

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

حل المشكلات

صفحات ذات صلة

• طرق الدفع لواجهة المتجر: تفعيل وترتيب خيارات الدفع عند إتمام الطلب
• رحلة إتمام الطلب: رحلة العميل كاملة
• مدفوعات الطلبات: كيف تظهر المدفوعات على الطلبات