كيف تربط Paymob بمتجر مِرفقي في مصر

Paymob يشغّل مدفوعات البطاقات والمحافظ وميزة وفاليو لآلاف المتاجر المصرية. ربطه بمِرفقي يستغرق دقائق بعد موافقة طلب التاجر — بلا خادم مخصص. اتبع هذه الخطوات بالترتيب لتتجنب تفعيل مفاتيح الإنتاج قبل اختبار شحن ناجح.

الخطوة 1: أكمل حساب تاجر Paymob

سجّل في بوابة تاجر Paymob بالسجل التجاري (أو وثائق المؤسسة الفردية) وحساب بنكي للتسوية بالجنيه وهوية المفوض. الموافقة من نفس اليوم للشركات القائمة إلى عدة أيام عمل للكيانات الجديدة.

أثناء التسجيل صرّح بفئة نشاطك بدقة — التناقض يؤخر التفعيل أو يطلق مراجعة إضافية للفئات عالية المخاطر.

ستحصل على لوحة تحكم ومعرفات تكامل ومفاتيح اختبار وإنتاج منفصلة. احتفظ بمفاتيح الاختبار في مِرفقي حتى تنجح معاملة إنتاج بجنيه واحد.

الخطوة 2: انسخ بيانات API إلى مِرفقي

في إدارة مِرفقي، اذهب إلى الإعدادات → المدفوعات → Paymob. الصق مفتاح API ومعرف التكامل ومعرف iframe أو الدفع الموحد كما في لوحة Paymob — مسافات زائدة تكسر المصادقة بصمت.

اختر مصر كدولة المتجر إن كنت تدير locales متعددة. البيانات لكل كيان قانوني؛ لا تعيد استخدام مفاتيح شركة أخرى.

احفظ واستخدم زر اختبار الاتصال إن وُجد. الحالة الخضراء تعني أن مِرفقي يصل لـ Paymob؛ لا تعني بعد تحريك أموال.

الخطوة 3: فعّل البطاقات والمحافظ وميزة وفاليو

فعّل كل طريقة يدعمها عقدك. البطاقات وميزة أساس؛ المحافظ تجذب مشتري الموبايل؛ فاليو يحتاج موافقة Paymob إضافية للأقساط.

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

ترتيب العرض في الدفع قابل للتعديل في مِرفقي — ضع الأعلى تحويلاً لجمهورك أولاً (غالباً بطاقات ثم محافظ ثم فاليو).

الخطوة 4: اضبط الويبهوك ومزامنة الطلبات

Paymob يرسل حالات الدفع إلى رابط webhook مِرفقي في إعدادات التكامل. انسخ الرابط إلى إعدادات callback في Paymob ليُعلَّم الطلب مدفوعاً تلقائياً — حاسم في العروض السريعة.

فشل callback يترك الطلبات معلقة. راقب قائمة الطلبات بعد الإطلاق وطابق أي اختلاف خلال 24 ساعة.

مِرفقي يسجّل أحداث webhook لتجار Pro؛ مستخدمو Starter يتحققون من الحالة في لوحة Paymob في أسابيع الحجم المنخفض.

الخطوة 5: اختبر وأطلق

شغّل وضع الاختبار: أنشئ طلباً بأرقام بطاقة اختبار Paymob، تأكد تحديث حالة الطلب، وتحقق من بريد تأكيد العميل بالعربية.

انتقل لمفاتيح الإنتاج، اشحن بطاقتك بجنيه واحد على منتج اختبار مخفي، ثم استرد عبر لوحة Paymob للتحقق من رؤية التسوية.

أعلن طرق الدفع على السوشيال بعد نجاح الاختبار الحي. اربط Paymob مع COD في مِرفقي لمن يتركون إدخال البطاقة.

التطبيق العملي على مِرفقي

خصص ساعة بعد موافقة Paymob على حساب التاجر: افتح مِرفقي الإعدادات → المدفوعات → Paymob على Starter، الصق مفتاح API ومعرف التكامل كما في لوحة Paymob (بلا مسافات زائدة)، وشغّل اختبار الاتصال. فعّل البطاقات وميزة أولاً — المحافظ وفاليو لاحقاً حين يعمل مسار البطاقة الأساسي.

انسخ رابط webhook مِرفقي إلى إعدادات callback في Paymob قبل أول بيع حقيقي. أنشئ طلباً حياً بجنيه واحد على منتج اختبار مخفي، تأكد أن الطلب يُعلَّم مدفوعاً تلقائياً، وتحقق من وصول بريد التأكيد العربي. اربط Paymob مع COD من نفس اللوحة لمن يتركون إدخال البطاقة.

بعد عشر طلبات Paymob حية، راجع التسوية في لوحة Paymob مقابل تصدير طلبات مِرفقي — مستخدمو Starter يطابقون يدوياً؛ تجار Pro يحصلون على سجلات webhook تلتقط المدفوعات المعلقة في الحملات. أضف فوري من لوحة المدفوعات حين ترى انسحاباً عند الدفع من محافظات ضعيفة انتشار البطاقات، لا في اليوم الأول.

مع ربط Paymob، متجر مِرفقي يقبل طرق الدفع التي يتوقعها المتسوق المصري. اجمعها مع فوري وCOD من نفس لوحة المدفوعات، ثم راقب التحويل حسب الطريقة في لوحتك مع نمو الطلبات.