قائمة سريعة (النقاط التي سنستعرضها)
توصيل Stripe و Paymob.
تهيئة بوابات الدفع داخل WooCommerce.
إدارة عمليات الدفع الفاشلة.
تنفيذ عمليات الاسترداد (Refunds) بأمان.
1) توصيل Stripe بـ WooCommerce
يُعد Stripe من أكثر بوابات الدفع موثوقية وانتشارًا.
إعداد
من لوحة تحكم ووردبريس: Plugins → Add New
ابحث عن “WooCommerce Stripe Payment Gateway”
ثبّت الإضافة ثم فعِّلها.
الإعداد
انتقل إلى WooCommerce → Settings → Payments → Stripe
فعِّل Stripe ثم انقر Setup أو Complete Setup
انقر Create or connect an account
سجّل الدخول إلى حساب Stripe (أو أنشئ حسابًا جديدًا)
من Stripe Dashboard → Developers → API Keys انسخ Publishable Key وSecret Key
ألصقهما في إعدادات Stripe داخل WooCommerce ثم Save changes.
اختياريًا:
فعِّل Test Mode لاختبار المعاملات قبل الإطلاق الفعلي.
اضبط Webhook endpoints (تظهر ضمن شاشة إعداد Stripe) لتحديثات الدفع الفورية.
نصيحة: اختبر مدفوعات Stripe في وضع الاختبار قبل الانتقال للوضع المباشر.
2) إعداد بوابات الدفع داخل WooCommerce
يدعم WooCommerce عدة طرق للدفع: يدوية (مثل الدفع عند الاستلام، التحويل البنكي) وعبر الإنترنت (Stripe، Paymob، PayPal… إلخ).
الوصول إلى إعدادات الدفع
اذهب إلى WooCommerce → Settings → Payments
ستجد قائمة بالبوابات المتاحة.
بدّل زر التفعيل/التعطيل لكل طريقة ثم انقر Manage لتكوين التفاصيل.
طرق مضمّنة شائعة
الدفع عند الاستلام (Cash on Delivery) — خيار بسيط للطلبات المحلية.
التحويل البنكي المباشر (BACS) — يعرض تفاصيل الحساب للتحويل اليدوي.
الشيكات (Check Payments) — استخدام محدود.
PayPal Standard — إعداد سريع عبر بريد PayPal.
تلميح: أبقِ طريقة دفع عبر الإنترنت وأخرى أوفلاين فعّالتين لتوفير مرونة للعميل.
3) توصيل Paymobبـ WooCommerce
Paymob بوابة دفع شائعة في مصر ومنطقة الشرق الأوسط وشمال أفريقيا.
الإعداد
من لوحة التحكم: Plugins → Add New
ابحث عن “Paymob for WooCommerce” (الإضافة الرسمية أو عبر المتجر)
ثبّت الإضافة ثم فعّلها.
الإعداد
اذهب إلى WooCommerce → Settings → Payments → Paymob
فعِّل البوابة ثم انقر Manage
سجّل الدخول إلى لوحة Paymob
انسخ بيانات الاعتماد التالية:
API Key
Integration ID
Iframe ID
HMAC Secret Key
ألصقها في إعدادات Paymobداخل WooCommerce ثم Save changes.
اختياريًا:
فعِّل وضع الاختبار (sandbox) للتجربة.
حدّد أنواع البطاقات المقبولة (Visa، MasterCard، Meeza… إلخ).
تلميح: تأكّد أن عملة متجرك مدعومة من Paymob.
4) إدارة المدفوعات الفاشلة
قد تفشل المدفوعات لأسباب متعددة—بطاقات منتهية، تعطل مؤقت في البوابة، أو أخطاء إعداد. فيما يلي أشهر الحالات وكيفية التعامل معها:
المشكلة | السبب المحتمل | الحل |
بوابة الدفع لا تظهر عند الدفع | غير مُفعّلة أو مقيّدة بحسب الدولة | راجع WooCommerce → Settings → Payments وAllowed countries |
ظهور “Payment failed” بعد الدفع | مفاتيح API خاطئة أو وضع الاختبار مفعّل | تحقّق من بيانات الوضع المباشر (Live) |
الطلب عالق على “Pending payment” | لم يصل تأكيد من البوابة | تحقّق من إعداد webhooks |
تم خصم المبلغ لكن الطلب لم يكتمل | تأخير/انقطاع في الـ webhook | أكّد يدويًا من لوحة Stripe/Paymob وحدّث حالة الطلب |
مهم: افحص دائمًا WooCommerce → Status → Logs للاطّلاع على تفاصيل الأخطاء.
5) معالجة الاستردادات (Refunds) في WooCommerce
يمكنك إصدار استرداد كامل أو جزئي من صفحة الطلب مباشرة.
استرداد يدوي (أوفلاين)
WooCommerce → Orders
افتح الطلب → Refund
أدخل المبلغ والملاحظة
انقر Refund manually.
استرداد تلقائي (عبر Stripe أو Paymob)
إذا كانت البوابة تدعم الاسترداد التلقائي:
افتح الطلب
انقر Refund via [اسم البوابة]
سيُنفَّذ الاسترداد من مزوّد الدفع مباشرة.
ملاحظة: قد يستغرق ظهور الاسترداد على بطاقة/حساب العميل عدة أيام عمل.
6) استكشاف أخطاء شائعة ونصائح
البوابة لا تظهر: تحقّق من تفعيلها وتوافق العملة.
فشل الاسترداد: تأكّد أن البوابة تدعم الاستردادات التلقائية.
حالة الدفع لا تتحدّث: راجع إعدادات webhooks.
تعدّد العملات: استخدم إضافة متعدد العملات متوافقة مع بوابات الدفع لديك.
7) أسئلة سريعة (FAQ)
س: هل يمكن استخدام أكثر من بوابة دفع؟
ج: نعم. يدعم WooCommerce تعدد البوابات ويختار العميل ما يناسبه عند الدفع.
س: كيف أختبر المعاملات بأمان؟
ج: فعِّل Test Mode في Stripe أو Paymob واستخدم أرقام بطاقات الاختبار.
س: هل أحتاج إلى شهادة SSL؟
ج: نعم—الاتصال الآمن HTTPS مطلوب لجميع عمليات الدفع الحية (Live).