انتقل إلى المحتوى الرئيسي

باي موب (Paymob)

باي موب بوابة دفع في منطقة الشرق الأوسط وشمال أفريقيا تدعم البطاقات والمحافظ ومنتجات التقسيط حسب التكاملات المفعّلة في حسابك لديها.

تحوّل TakeTheme المشترين إلى Unified Checkout الخاصة بباي موب، ويُنشأ الطلب عند تأكيد باي موب للدفع.

الربط​

الإعدادات ← المدفوعات ← باي موب.

البياناتمطلوبةملاحظات
المفتاح السري (Secret Key)نعميبدأ بـ sk_test_… أو sk_live_…
المفتاح العام (Public Key)نعميُستخدم للتحويل إلى Unified Checkout
معرّف التكامل (Integration ID)نعمتكامل باي موب الخاص بطريقة الدفع التي تريد قبولها
مفتاح API—مفتاح قديم؛ لا يلزم إلا لمسارات باي موب السابقة
معرّف الـ iFrame—إطار البطاقات القديم؛ لا يلزم إلا لمسارات باي موب السابقة

معرّف التكامل هو ما يحدد فعليًا ما يستطيع المشتري الدفع به. فإذا أردت البطاقات والمحافظ معًا، فعّلهما في باي موب واستخدم التكامل الذي يغطيهما.

الإعدادات​

الإعدادالافتراضيالوظيفة
إرسال بريد تأكيد الدفعمفعّليرسل بريدًا للعميل عند نجاح الدفع
التنبيه عند فشل الدفع (عناوين بريد)فارغينبّه فريقك عند فشل عملية دفع لدى البوابة
تعليم الطلبات كمدفوعة تلقائيًامفعّلغير مُفعَّل حاليًا — أي دفع مؤكَّد يجعل الطلب مدفوعًا على أي حال

مسار الدفع​

  1. يختار المشتري باي موب ويؤكد الشراء.
  2. تُنشئ TakeTheme نية دفع لدى باي موب وتحوّله إلى Unified Checkout.
  3. يدفع المشتري.
  4. تستدعي باي موب عنوان TakeTheme، ويُنشأ الطلب هناك وهو مدفوع بالفعل.
  5. يعود المشتري إلى صفحة نجاح الطلب.
POST https://<your-api-host>/api/v1/payment/webhook/paymob

ترسل باي موب توقيع HMAC كمعامل ضمن رابط الاستدعاء.

التحقق من HMAC معطّل ما لم يُضبط مفتاح

تتحقق TakeTheme من توقيع استدعاء باي موب فقط عند وجود مفتاح hmac محفوظ لحسابك. وهذا الحقل ليس ضمن نموذج بيانات الاعتماد المعتاد، لذا يُقبل الاستدعاء في معظم المتاجر دون فحص التوقيع.

إذا كان حسابك لدى باي موب يوفّر مفتاح HMAC، فاطلب من الدعم حفظه — فذلك يغلق الثغرة التي قد تسمح لاستدعاء مزوَّر بتعليم طلب كمدفوع. جميع البوابات الأخرى على المنصة تتحقق من التوقيع افتراضيًا.

الاستدعاءات آمنة التكرار: أي إعادة إرسال لعملية دفع ناجحة مسجّلة تُقبل وتُتجاهل.

الاسترداد​

يُسجَّل الاسترداد في TakeTheme فقط — ولا يصل أي طلب استرداد إلى باي موب. نفّذه من لوحة تحكم باي موب وسجّله هنا. راجع الاسترداد.

حل المشكلات​

يرى المشترون "لا توجد طريقة دفع متاحة" في صفحة باي موب. معرّف التكامل لديك لا يغطي الطريقة التي اختاروها، أو أن هذا التكامل غير مفعّل في باي موب. راجعه في لوحة تحكم باي موب.

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

مدفوعات الاختبار تنجح والمباشرة لا. غالبًا ما زلت تستخدم sk_test_…. أعد إدخال المفتاح السري المباشر كاملًا.

اقرأ أيضًا​