إضافة WooCommerce

​

المقدمة

​

دليل التثبيت خطوة بخطوة

1. قم بتنزيل أحدث ملف zip لإضافة الدفع WooCommerce.
   Download Plugin

   احصل على أحدث إصدار من إضافة WooCommerce الخاصة بنا
   بدلاً من ذلك، يمكنك التثبيت مباشرة من دليل إضافات WordPress:
   WordPress Plugin Directory

   قم بتثبيت Dodo Payments لـ WooCommerce من WordPress.org
2. سجِّل الدخول إلى موقع WordPress الخاص بك كمسؤول (نفترض أنك قد أعددت WooCommerce بالفعل)
3. انتقل إلى Plugins → Add New Plugin
   
4. انقر فوق زر Upload Plugin وسيظهر مربع حوار لاختيار الملف
   
   
5. انقر على Browse… وحدد ملف zip الذي قمت بتنزيله
6. انقر على زر Install Now لبدء عملية التثبيت
   
7. بعد اكتمال التثبيت، انقر على Activate Plugin أو قم بتفعيله من قسم Installed Plugins
   
8. الإضافة مُثبتة الآن، لكن لا يزال يلزم إجراء إعدادات. تابع دليل الإعداد أدناه.
   
   
9. انقر على استعراض… واختر ملف zip الذي قمت بتنزيله
10. انقر على زر تثبيت الآن لبدء عملية التثبيت
    
11. بعد اكتمال التثبيت، انقر على تفعيل الإضافة أو قم بتفعيلها من قسم الإضافات المثبتة
    
12. الإضافة الآن مثبتة، ولكن لا يزال يتعين تكوينها. تابع إلى دليل الإعداد أدناه.

​

دليل التكوين

​

إعداد مفاتيح API و Webhooks

1. انتقل إلى WooCommerce → Settings → Payments أو انقر على زر Payments في الشريط الجانبي الأيسر أسفل عنصر قائمة WooCommerce
   
   
2. فعِّل مزود الدفع Dodo Payments إذا لم يكن مفعلًا بالفعل، ثم انقر على Manage لتكوين الإضافة
3. سترى خيارات إعداد مختلفة، كل منها مع نص توضيحي مفيد. ابدأ بإعداد مفتاح API الخاص بالوضع الفعلي
   
4. سجِّل الدخول إلى لوحة Dodo Payments في Live Mode، ثم انتقل إلى Dodo Payments (Live Mode) > Developer > API Keys أو قم بزيارة هذا الرابط المباشر وانقر على Add API Key
   
5. امنح مفتاح API اسمًا وصفيًا وانقر على Create
   
6. انسخ مفتاح API المُنشأ والصقه في حقل Live API Key في إعدادات إضافة WooCommerce الخاصة بك
   
   
7. بعد ذلك، قم بإعداد مفتاح توقيع الويب هوك لتمكين تزامن حالة الدفع بين Dodo Payments وWooCommerce
8. انتقل إلى أسفل صفحة إعدادات الإضافة وقم بنسخ عنوان URL لويب هوك المعروض هناك
   
9. ارجع إلى لوحة Dodo Payments الخاصة بك وانتقل إلى Dodo Payments (Live Mode) > Developer > Webhooks وانقر على Add Webhook
   
10. الصق عنوان URL الذي نسخته في الخطوة 8 داخل مربع الحوار وانقر على Add Webhook
    
11. بعد إنشاء الويب هوك، انقر على أيقونة العين بجانب Signing Key المحجوب لعرضه ونسخه
    
12. الصق مفتاح التوقيع في حقل Live Webhook Signing Key في إعدادات الإضافة واحفظ التغييرات
    
13. راجع الإعدادات المتبقية مثل Global Tax Category وAll Prices are Tax Inclusive، إذ تحدد هذه الخيارات كيفية مزامنة المنتجات من WooCommerce إلى Dodo Payments. لاحظ أن Test API Key وTest Webhook Signing Key مطلوبان فقط إذا كنت تخطط لاستخدام وضع الاختبار
    

​

كل شيء جاهز!

​

الميزات الرئيسية

• تجربة دفع سلسة: إعادة توجيه العملاء إلى صفحة دفع آمنة ومحسّنة
• طرق دفع متعددة: دعم لخيارات الدفع المحلية والدولية المتنوعة
• تحديثات حالة فورية: مزامنة فورية لحالة الطلب عبر webhooks
• سجلات معاملات مفصلة: تاريخ شامل للمدفوعات في لوحة معلومات WooCommerce الخاصة بك
• دعم متعدد العملات: قبول المدفوعات بعملات متعددة

​

استكشاف الأخطاء وإصلاحها

​

مشكلات شائعة

1. فشل معالجة المدفوعات
   • تحقق من تكوين مفاتيح API بشكل صحيح
   • تأكد من إعداد عنوان URL الخاص بـ webhook بشكل صحيح
   • تحقق من أن شهادة SSL الخاصة بك صالحة
2. مشكلات مزامنة Webhook
   • تأكد من تطابق مفتاح توقيع webhook
   • راجع سجلات الخادم للبحث عن أخطاء محتملة
   • تحقق من أن خادمك يمكنه استقبال طلبات webhook الواردة

​

موارد الدعم

• اتصل بنا على support@dodopayments.com
• راجع وثائقنا الشاملة

​

أفضل ممارسات الصيانة

1. قم بتحديث الإضافة بانتظام للحصول على تصحيحات الأمان والميزات الجديدة
2. اختبر جميع تدفقات الدفع في وضع الصندوق الرملي قبل معالجة المعاملات الحية
3. حافظ على تحديث WordPress وWooCommerce إلى أحدث الإصدارات
4. نفذ نسخ احتياطية منتظمة للموقع
5. راقب سجلات المعاملات لأي نشاط غير عادي
6. قم بتخزين مفاتيح API بشكل آمن ولا تشاركها علنًا