دليل تفصيلي: كيفية ربط بوابة الدفع Moyasar بـ WooCommerce
تعد بوابة الدفع Moyasar واحدة من أشهر بوابات الدفع في منطقة الشرق الأوسط، حيث تتيح قبول المدفوعات بطريقة آمنة وفعّالة. من خلال دمج Moyasar مع WooCommerce، يمكنك تقديم تجربة دفع سلسة لعملائك على متجر الووردبريس الخاص بك. إليك دليلًا تفصيليًا لعملية الربط.
الخطوة 1: المتطلبات الأساسية
قبل البدء، تأكد من توفر التالي:
- موقع ووردبريس جاهز: تأكد من أن موقع ووردبريس الخاص بك يعمل بشكل صحيح.
- تنصيب WooCommerce: يجب تثبيت وتفعيل إضافة WooCommerce على موقعك. إذا لم تكن مثبتة:
- اذهب إلى الإضافات > أضف جديد في لوحة تحكم ووردبريس.
- ابحث عن “WooCommerce” وقم بالتثبيت والتفعيل.
- حساب Moyasar: قم بإنشاء حساب على Moyasar إذا لم يكن لديك حساب بالفعل.
- مفاتيح API الخاصة بـ Moyasar:
- قم بتسجيل الدخول إلى حسابك على Moyasar.
- اذهب إلى الإعدادات > مفاتيح API.
- انسخ مفتاح Publishable Key ومفتاح Secret Key — ستحتاجهما في الإعدادات لاحقًا.
الخطوة 2: تثبيت إضافة Moyasar
الطريقة الأولى: التثبيت من مكتبة ووردبريس
- قم بتسجيل الدخول إلى لوحة تحكم ووردبريس.
- انتقل إلى الإضافات > أضف جديد.
- ابحث عن
Moyasar WooCommerce Payment Gateway. - اضغط على تثبيت الآن، ثم اضغط على تفعيل بعد اكتمال التثبيت.
الطريقة الثانية: التثبيت اليدوي
- قم بتنزيل إضافة Moyasar من الموقع الرسمي أو من صفحة GitHub الخاصة بهم (إذا كانت متوفرة).
- قم بالدخول إلى لوحة تحكم ووردبريس.
- اذهب إلى الإضافات > أضف جديد > رفع إضافة.
- ارفع ملف الإضافة بصيغة
.zipواضغط على تثبيت الآن. - بعد التثبيت، قم بتفعيل الإضافة.
الخطوة 3: إعداد بوابة الدفع Moyasar
- من لوحة تحكم ووردبريس، اذهب إلى WooCommerce > الإعدادات.
- اضغط على تبويب المدفوعات. ستظهر لك قائمة بطرق الدفع المتوفرة.
- ابحث عن Moyasar Payment Gateway واضغط على خيار إعداد أو إدارة.
الخطوة 4: إدخال بيانات API
في صفحة إعدادات Moyasar:
- قم بلصق مفتاح Publishable Key ومفتاح Secret Key اللذين قمت بنسخهما من حسابك على Moyasar في الحقول المخصصة لهما.
- قم بضبط الإعدادات الإضافية:
- وضع الاختبار (Test Mode): استخدم وضع الاختبار لتجربة المعاملات أثناء عملية الإعداد دون تنفيذ عمليات دفع حقيقية.
- اسم طريقة الدفع: أدخل اسمًا يعبر عن البوابة مثل “الدفع عبر Moyasar” (سيظهر للعملاء في صفحة الدفع).
- الوصف: يمكنك كتابة وصف بسيط مثل “الدفع الآمن باستخدام Mada وبطاقات الائتمان”.
- اضغط على حفظ التغييرات.
الخطوة 5: تفعيل وضع الاختبار
قبل الانتقال للعمل بشكل مباشر، تأكد من اختبار الإعدادات:
- في إعدادات Moyasar، قم بتفعيل خيار وضع الاختبار (Test Mode).
- قم بإجراء طلب تجريبي على متجرك:
- أضف منتجًا إلى السلة وانتقل إلى صفحة الدفع.
- اختر “الدفع عبر Moyasar” كطريقة دفع.
- أكمل عملية الدفع باستخدام بيانات بطاقات الاختبار التي توفرها Moyasar (راجع وثائقهم للحصول على أرقام البطاقات).
- تحقق مما يلي:
- أن الطلب قد تم إنشاؤه بنجاح في WooCommerce (من قسم الطلبات).
- أن المعاملة تظهر في لوحة التحكم الخاصة بـ Moyasar ضمن معاملات الاختبار.
الخطوة 6: تفعيل الوضع المباشر
بعد نجاح الاختبار:
- عد إلى إعدادات Moyasar في WooCommerce.
- قم بإلغاء تفعيل خيار وضع الاختبار (Test Mode).
- اضغط على زر حفظ التغييرات.
الآن متجرك جاهز لقبول المدفوعات الحقيقية عبر Moyasar!
الخطوة 7: تخصيص تجربة الدفع
تحسين تجربة العميل
- قم بتعديل العنوان والوصف الخاص بطريقة الدفع في إعدادات WooCommerce لتناسب جمهورك.
- إذا كان متجرك متعدد اللغات، استخدم إضافات الترجمة مثل WPML أو Loco Translate لتخصيص النصوص.
تخصيص التصميم
- لتغيير مظهر بوابة الدفع في صفحة الدفع، يمكنك استخدام CSS مخصص أو إضافات WooCommerce المخصصة لتصميم واجهة الدفع.
الخطوة 8: حل المشاكل الشائعة
في حال واجهتك أي مشاكل، إليك بعض الحلول:
- أخطاء مفاتيح API: تأكد من أنك قمت بنسخ ولصق مفاتيح Publishable Key وSecret Key بشكل صحيح.
- شهادة SSL: تأكد من تفعيل شهادة SSL على موقعك — بوابات الدفع تتطلب اتصالاً آمنًا.
- التوافق مع الإضافات الأخرى: احرص دائمًا على تحديث WooCommerce وإضافة Moyasar لضمان التوافق.
- فشل المعاملات: إذا فشلت العمليات:
- تحقق من صحة بيانات API في الإعدادات.
- راجع لوحة تحكم Moyasar لمعرفة أي قيود أو أخطاء محتملة.
الأسئلة الشائعة
هل يمكنني قبول مدفوعات Mada؟
نعم، تدعم Moyasar مدفوعات Mada التي تُستخدم على نطاق واسع في المملكة العربية السعودية.
كيف يمكنني تتبع المعاملات؟
يمكنك متابعة جميع المعاملات مباشرة من لوحة تحكم Moyasar ضمن قسم “Payments”.
هل تدعم العملات المتعددة؟
تدعم Moyasar الريال السعودي (SAR) بشكل رئيسي، لكن تحقق من وثائقهم لمعرفة ما إذا كانت هناك تحديثات لدعم عملات أخرى.
ملحوظة أخيرة
يُعد دمج Moyasar مع WooCommerce عملية بسيطة إذا اتبعت الخطوات بدقة. بعد إكمال الإعداد، تأكد من مراجعة الطلبات والمعاملات بانتظام لضمان عمل البوابة بشكل سلس.
للمزيد من المساعدة:
- راجع وثائق Moyasar الرسمية
- استعن بمنتديات دعم WooCommerce
- تواصل مع فريق دعم Moyasar لحل أي مشكلات تقنية
إذا كنت بحاجة إلى مساعدة إضافية، لا تتردد في طلبها!