كيف تقبل الدفع الإلكتروني في متجر WooCommerce من العراق
— MEGA PAY
بوابات الدفع العالمية لا تدعم الحسابات العراقية — إليك طريقتان لتحصيل المدفوعات بالدينار العراقي في WooCommerce عبر MEGA PAY: روابط الدفع، أو ربط تلقائي بالـ API.
لماذا يتعطّل الدفع في متاجر WooCommerce العراقية؟
WooCommerce هو الخيار الأول للمشاريع الصغيرة والمتوسطة في العراق لأنه مجاني ومرن على WordPress. لكنّ إضافات الدفع الجاهزة (Stripe، PayPal، وغيرها) لا تقبل الحسابات العراقية، فينتهي المتجر بخيار «الدفع عند الاستلام» فقط — وهذا يرفع نسبة الطلبات الملغاة ويحرمك من البيع خارج مدينتك.
MEGA PAY يعمل كطبقة تحصيل محلية: العميل يدفع بالدينار العراقي ببطاقة Visa أو Mastercard أو ماستركارد الرافدين، ويظهر المبلغ الصافي بعد استقطاع العمولة في لوحة التاجر مع تفاصيل التسوية.
الطريقة الأولى: روابط الدفع (بدون برمجة)
- أنشئ طريقة دفع يدوية في WooCommerce باسم «الدفع الإلكتروني عبر MEGA PAY».
- عند وصول الطلب، أنشئ رابط دفع بمبلغ الطلب ورقمه من لوحة التاجر.
- فعّل «رابط لمرة واحدة» وتاريخ انتهاء قصير (24 ساعة)، وأرسله عبر واتساب.
- بعد إشعار نجاح الدفع، حوّل حالة الطلب في WooCommerce.
لرفع معدّل الإتمام راجع أفضل ممارسات روابط الدفع.
الطريقة الثانية: ربط تلقائي بالـ API
عند إنشاء الطلب، استدعِ مسار إنشاء الدفع من الخادم (لا من المتصفح) حتى يبقى المفتاح السري محمياً:
في WordPress ضع هذا الاستدعاء داخل خطّاف woocommerce_checkout_order_processed ، واحفظ رمز الرابط في بيانات الطلب (order meta)، ثم أعِد توجيه العميل إلى رابط الدفع. للتحقّق من الحالة استخدم مسار payment-status بنفس الترويسات قبل تعليم الطلب كمدفوع. الأمثلة الكاملة موجودة في توثيق الـ API.
العملة والحدود والعمولة
- الدينار العراقي عملة أساسية مع إظهار المعادل بالدولار للعملاء الدوليين.
- الحد الأدنى 1,000 د.ع ولا يوجد حد أعلى.
- العمولة تُحسب في الخادم حسب موقع العميل، وتظهر تفاصيل الاستقطاع والصافي في لوحة التاجر.
نصائح تشغيلية
- لا تضع المفتاح السري في كود JavaScript أو في إضافة WordPress عامة.
- اقفل استخدام الـ API على نطاق متجرك فقط من إعدادات الحساب.
- أضف رقم الطلب في وصف الدفعة لتسهيل التسوية والمطابقة المحاسبية.
- تابع محاولات الدفع الفاشلة وسبب الرفض من لوحة التاجر وأعد إرسال الرابط.
تبيع على منصّة أخرى؟ راجع دليل ربط Shopify أو دليل ZainCash للتجار.
الخطوات
- فعّل حسابك في MEGA PAY: أكمل طلب الخدمة وتوقيع العقد لتحصل على لوحة التاجر ومفاتيح الربط.
- انسخ مفاتيح الربط: من لوحة التاجر خُذ معرّف التاجر والمفتاح السري X-Api-Key.
- أضف طريقة دفع في WooCommerce: WooCommerce ← Settings ← Payments ← أضف «الدفع الإلكتروني عبر MEGA PAY» مع تعليمات واضحة.
- أنشئ رابط الدفع تلقائياً: استخدم خطّاف إنشاء الطلب لاستدعاء مسار create-payment بمبلغ الطلب ورقمه.
- وجّه العميل للدفع: أعِد توجيه العميل إلى رابط الدفع، أو أرسله عبر واتساب مع رقم الطلب.
- حدّث حالة الطلب: بعد التحقّق من حالة الدفعة، حدّث الطلب إلى Processing/Completed وأرسل الإيصال.
الأسئلة الشائعة
هل يمكن ربط WooCommerce ببوابة دفع عراقية؟
نعم. WooCommerce يدعم إضافة طرق دفع مخصّصة، ويمكن ربطه مع MEGA PAY عبر روابط الدفع أو عبر الـ API ليدفع العميل بالدينار العراقي ببطاقة Visa أو Mastercard أو ماستركارد الرافدين.
ما أسرع طريقة للبدء دون برمجة؟
استخدم طريقة «التحويل/الدفع اليدوي» في WooCommerce ثم أرسل رابط دفع MEGA PAY للعميل عبر واتساب، وعند نجاح الدفع حوّل حالة الطلب إلى Processing أو Completed.
كيف أربط الدفع تلقائياً بالـ API؟
استخدم خطّاف WooCommerce عند إنشاء الطلب (woocommerce_checkout_order_processed) لاستدعاء مسار إنشاء رابط الدفع في MEGA PAY، ثم وجّه العميل إلى الرابط، وتحقّق من حالة الدفعة عبر مسار payment-status قبل تحديث الطلب.
ما وسائل الدفع المتاحة للزبون في صفحة الدفع؟
بطاقات Visa وMastercard المحلية والدولية، ومنها ماستركارد الرافدين، في صفحة دفع واحدة دون إضافات منفصلة. أما زين كاش فمتاحة للتاجر لاستلام أرباحه.
من يتحمّل الالتزامات الأمنية لبيانات البطاقة؟
بيانات البطاقة تُدخل على صفحة الدفع المستضافة على البوابة ولا تمرّ عبر متجر WordPress/WooCommerce، وهذا يقلّل متطلبات الامتثال على متجرك بشكل كبير.