> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# إضافة WooCommerce

> دمج مدفوعات دودي بسلاسة مع متجرك WooCommerce لقبول المدفوعات العالمية من خلال UPI، والبطاقات، والمزيد.

## المقدمة

تقدم إضافة مدفوعات دودي لـ WooCommerce تكاملًا سلسًا مع متجرك، مما يمكنك من قبول المدفوعات من خلال طرق متعددة بما في ذلك UPI، والبطاقات، والخدمات المصرفية عبر الإنترنت، والمحافظ الرقمية. ستوجهك هذه الدليل الشامل خلال عملية التثبيت والتكوين.

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

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

   <Card title="Download Plugin" icon="download" href="https://github.com/dodopayments/dodo-woocommerce/releases">
     احصل على أحدث إصدار من إضافة WooCommerce الخاصة بنا
   </Card>

   بدلاً من ذلك، يمكنك التثبيت مباشرة من دليل إضافات WordPress:

   <Card title="WordPress Plugin Directory" icon="wordpress" href="https://wordpress.org/plugins/dodo-payments-for-woocommerce/">
     قم بتثبيت Dodo Payments لـ WooCommerce من WordPress.org
   </Card>

2. سجِّل الدخول إلى موقع WordPress الخاص بك كمسؤول (نفترض أنك قد أعددت WooCommerce بالفعل)

3. انتقل إلى **Plugins → Add New Plugin**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/1.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=f26041db02cf678f4785a8d72631d0e2" alt="Dodo Payments for WooCommerce Plugin" width="447" height="136" data-path="images/woocommerce/1.webp" />
   </Frame>

4. انقر فوق زر **Upload Plugin** وسيظهر مربع حوار لاختيار الملف

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/2.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f20388bab236d046cbff312646dcd98" alt="Dodo Payments for WooCommerce Plugin" width="433" height="75" data-path="images/woocommerce/2.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/3.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=c9cdccfe01ceda93932c9feea5ee5e65" alt="Dodo Payments for WooCommerce Plugin" width="1313" height="356" data-path="images/woocommerce/3.webp" />
   </Frame>

5. انقر على **Browse…** وحدد ملف zip الذي قمت بتنزيله

6. انقر على زر **Install Now** لبدء عملية التثبيت

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/4.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=3a785b07a5c0f47318893a73059875b5" alt="Dodo Payments for WooCommerce Plugin" width="1024" height="307" data-path="images/woocommerce/4.webp" />
   </Frame>

7. بعد اكتمال التثبيت، انقر على **Activate Plugin** أو قم بتفعيله من قسم **Installed Plugins**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/5.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=d7a144b16abd059e81a694585f3d6923" alt="Dodo Payments for WooCommerce Plugin" width="897" height="289" data-path="images/woocommerce/5.webp" />
   </Frame>

8. الإضافة مُثبتة الآن، لكن لا يزال يلزم إجراء إعدادات. تابع دليل الإعداد أدناه.

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/2.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f20388bab236d046cbff312646dcd98" alt="إضافة مدفوعات دودي لـ WooCommerce" width="433" height="75" data-path="images/woocommerce/2.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/3.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=c9cdccfe01ceda93932c9feea5ee5e65" alt="إضافة مدفوعات دودي لـ WooCommerce" width="1313" height="356" data-path="images/woocommerce/3.webp" />
   </Frame>

9. انقر على **استعراض…** واختر ملف zip الذي قمت بتنزيله

10. انقر على زر **تثبيت الآن** لبدء عملية التثبيت

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/4.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=3a785b07a5c0f47318893a73059875b5" alt="إضافة مدفوعات دودي لـ WooCommerce" width="1024" height="307" data-path="images/woocommerce/4.webp" />
    </Frame>

11. بعد اكتمال التثبيت، انقر على **تفعيل الإضافة** أو قم بتفعيلها من قسم **الإضافات المثبتة**

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/5.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=d7a144b16abd059e81a694585f3d6923" alt="إضافة مدفوعات دودي لـ WooCommerce" width="897" height="289" data-path="images/woocommerce/5.webp" />
    </Frame>

12. الإضافة الآن مثبتة، ولكن لا يزال يتعين تكوينها. تابع إلى دليل الإعداد أدناه.

## دليل التكوين

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

1. انتقل إلى **WooCommerce → Settings → Payments** أو انقر على زر **Payments** في الشريط الجانبي الأيسر أسفل عنصر قائمة WooCommerce

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/6.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=292552cc453ac05b4a0a368cd0d2adb8" alt="Dodo Payments for WooCommerce Plugin" width="1887" height="958" data-path="images/woocommerce/6.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/7.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=e289459e7a2c95082504229293c0863e" alt="Dodo Payments for WooCommerce Plugin" width="234" height="242" data-path="images/woocommerce/7.webp" />
   </Frame>

2. فعِّل مزود الدفع **Dodo Payments** إذا لم يكن مفعلًا بالفعل، ثم انقر على **Manage** لتكوين الإضافة

3. سترى خيارات إعداد مختلفة، كل منها مع نص توضيحي مفيد. ابدأ بإعداد مفتاح API الخاص بالوضع الفعلي

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/8.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=0cad2f1d5bbba36d54e1d54e8ffb8961" alt="Dodo Payments for WooCommerce Plugin" width="1658" height="867" data-path="images/woocommerce/8.webp" />
   </Frame>

4. سجِّل الدخول إلى لوحة Dodo Payments في **Live Mode**، ثم انتقل إلى **Dodo Payments (Live Mode) > Developer > API Keys** أو قم بزيارة [هذا الرابط المباشر](https://app.dodopayments.com/developer/api-keys) وانقر على **Add API Key**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/9.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=baa03ad325826db734456fd30e30363c" alt="Dodo Payments for WooCommerce Plugin" width="1876" height="991" data-path="images/woocommerce/9.webp" />
   </Frame>

5. امنح مفتاح API اسمًا وصفيًا وانقر على **Create**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/10.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=af89376b00b5265c1d375dcc6fa218f3" alt="Dodo Payments for WooCommerce Plugin" width="549" height="365" data-path="images/woocommerce/10.webp" />
   </Frame>

6. انسخ مفتاح API المُنشأ والصقه في حقل **Live API Key** في إعدادات إضافة WooCommerce الخاصة بك

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/11.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=bd998ae7bb40791d2193b807813521cb" alt="Dodo Payments for WooCommerce Plugin" width="570" height="491" data-path="images/woocommerce/11.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/12.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=dd3f751317c6be0401c50bde584705e2" alt="Dodo Payments for WooCommerce Plugin" width="1395" height="115" data-path="images/woocommerce/12.webp" />
   </Frame>

7. بعد ذلك، قم بإعداد مفتاح توقيع الويب هوك لتمكين تزامن حالة الدفع بين Dodo Payments وWooCommerce

8. انتقل إلى أسفل صفحة إعدادات الإضافة وقم بنسخ عنوان URL لويب هوك المعروض هناك

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/13.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=becfefe5c5e04aeecefb8b8d126ff571" alt="Dodo Payments for WooCommerce Plugin" width="1062" height="239" data-path="images/woocommerce/13.webp" />
   </Frame>

9. ارجع إلى لوحة Dodo Payments الخاصة بك وانتقل إلى **Dodo Payments (Live Mode) > Developer > Webhooks** وانقر على **Add Webhook**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/14.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=fda4e9a992317218190c439b9addb6d3" alt="Dodo Payments for WooCommerce Plugin" width="1884" height="994" data-path="images/woocommerce/14.webp" />
   </Frame>

10. الصق عنوان URL الذي نسخته في الخطوة 8 داخل مربع الحوار وانقر على **Add Webhook**

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/15.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=da9541f69ffaa9e37f4135c6163329c0" alt="Dodo Payments for WooCommerce Plugin" width="542" height="417" data-path="images/woocommerce/15.webp" />
    </Frame>

11. بعد إنشاء الويب هوك، انقر على أيقونة العين بجانب **Signing Key** المحجوب لعرضه ونسخه

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/16.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f342ef95be984773dd065c0fd46f1a4" alt="Dodo Payments for WooCommerce Plugin" width="1527" height="356" data-path="images/woocommerce/16.webp" />
    </Frame>

12. الصق مفتاح التوقيع في حقل **Live Webhook Signing Key** في إعدادات الإضافة واحفظ التغييرات

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/17.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=2cfee72402218b0170d63c2b136d9de9" alt="Dodo Payments for WooCommerce Plugin" width="1608" height="155" data-path="images/woocommerce/17.webp" />
    </Frame>

13. راجع الإعدادات المتبقية مثل **Global Tax Category** و**All Prices are Tax Inclusive**، إذ تحدد هذه الخيارات كيفية مزامنة المنتجات من WooCommerce إلى Dodo Payments. لاحظ أن **Test API Key** و**Test Webhook Signing Key** مطلوبان فقط إذا كنت تخطط لاستخدام وضع الاختبار

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/18.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=746184a19efe5bfb14febfc6955c4c8e" alt="Dodo Payments for WooCommerce Plugin" width="1612" height="677" data-path="images/woocommerce/18.webp" />
    </Frame>

## كل شيء جاهز!

تم دمج متجرك WooCommerce الآن مع مدفوعات دودي! يمكن للعملاء اختيار مدفوعات دودي عند الخروج للوصول إلى جميع طرق الدفع المدعومة.

<Frame>
  <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/19.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=958daded5beb84eb4e54e02c267d7ecc" alt="Dodo Payments checkout option in WooCommerce" width="1864" height="913" data-path="images/woocommerce/19.webp" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/20.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=a78bd2b289d9cc8df8d36da9db540c14" alt="Dodo Payments checkout page" width="1887" height="1006" data-path="images/woocommerce/20.webp" />
</Frame>

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

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

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

### مشكلات شائعة

1. **فشل معالجة المدفوعات**
   * تحقق من تكوين مفاتيح API بشكل صحيح
   * تأكد من إعداد عنوان URL الخاص بـ webhook بشكل صحيح
   * تحقق من أن شهادة SSL الخاصة بك صالحة

2. **مشكلات مزامنة Webhook**
   * تأكد من تطابق مفتاح توقيع webhook
   * راجع سجلات الخادم للبحث عن أخطاء محتملة
   * تحقق من أن خادمك يمكنه استقبال طلبات webhook الواردة

### موارد الدعم

للحصول على مساعدة إضافية:

* اتصل بنا على [support@dodopayments.com](mailto:support@dodopayments.com)
* راجع [وثائقنا الشاملة](https://docs.dodopayments.com)

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

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