Skip to main content

​
المقدمة

تضيف إضافة Dodo Payments for WooCommerce خدمة Dodo Payments كطريقة دفع إلى صفحة الدفع في متجرك. يدفع العملاء في صفحة الدفع الخاصة بـ Dodo Payments، التي تعرض طرق الدفع المتاحة لموقعهم وعملتهم وجهازهم، مثل البطاقات والمحافظ الرقمية وUPI. ثم تعمل webhooks من Dodo Payments على تحديث حالة الطلب في WooCommerce.
تتطلب الإضافة WordPress 6.1 أو إصدارًا أحدث، وPHP 7.4 أو إصدارًا أحدث، وWooCommerce 7.9 أو إصدارًا أحدث. ولبيع الاشتراكات، تحتاج أيضًا إلى إضافة WooCommerce Subscriptions.
تعمل الإضافة مع صفحة الدفع التقليدية في WooCommerce. ولا تدعم صفحة الدفع القائمة على الكتل أو شحن المنتجات المادية، كما تقبل رمز خصم واحدًا فقط من نوع النسبة المئوية لكل طلب.

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

  1. نزّل dodo-payments-for-woocommerce.zip من أحدث إصدار على GitHub.

    Download Plugin

    احصل على أحدث إصدار من إضافة Dodo Payments for WooCommerce
    يمكنك أيضًا تثبيت الإضافة من دليل إضافات WordPress. في صفحة Add Plugins، ابحث عن Dodo Payments for WooCommerce، ثم انقر على Install Now، وبعد ذلك انقر على Activate، وتابع إلى دليل الإعداد.

    WordPress Plugin Directory

    ثبّت Dodo Payments for WooCommerce من WordPress.org
  2. سجّل الدخول إلى موقع WordPress بصفتك مسؤولًا. يجب تثبيت WooCommerce وتفعيله.
  3. انتقل إلى Plugins → Add New Plugin.
    WordPress admin sidebar with the Plugins menu open
  4. انقر على Upload Plugin. سيظهر نموذج للرفع.
    Add Plugins page with the Upload Plugin button
    Plugin upload form with a Browse button and an Install Now button
  5. انقر على Browse… وحدد ملف zip الذي نزّلته.
  6. انقر على Install Now.
    Plugin upload form with the plugin zip file selected and the Install Now button
  7. عند اكتمال التثبيت، انقر على Activate Plugin. ويمكنك أيضًا تفعيل الإضافة لاحقًا من Plugins → Installed Plugins.
    Plugin installed successfully message with the Activate Plugin button
  8. تم تثبيت الإضافة، لكنها لم تُعدّ بعد. تابع إلى دليل الإعداد أدناه.

​
دليل الإعداد

​
إعداد API Keys وWebhooks

تحتاج الإضافة إلى قيمتين من كل وضع من أوضاع Dodo Payments: API key لإنشاء صفحات الدفع، وwebhook signing key للتحقق من webhooks التي تحدّث طلباتك. تعمل هذه الخطوات على إعداد الوضع المباشر.
  1. انتقل إلى WooCommerce → Settings → Payments، أو انقر على Payments ضمن WooCommerce في الشريط الجانبي.
    WooCommerce payment settings with Dodo Payments active and a Manage button
    WooCommerce sidebar menu with Payments highlighted
  2. فعّل Dodo Payments إذا لم يكن مفعّلًا، ثم انقر على Manage.
  3. تُفتح إعدادات الإضافة، مع وصف أسفل كل خيار. تأكد من تحديد Enable Dodo Payments، ثم ابدأ باستخدام Live API Key.
    Dodo Payments plugin settings with the Enable/Disable, Title, Description, Instructions, Test Mode, and Live API Key fields
  4. في لوحة تحكم Dodo Payments، فعّل مفتاح Live Mode في الشريط الجانبي. انتقل إلى Developer → API Keys، أو استخدم هذا الرابط المباشر، ثم انقر على Add API key.
    Dodo Payments API Keys page with no keys and an Add API key button
  5. أدخل اسمًا للمفتاح، مثل WooCommerce Plugin، ثم انقر على Create.
    Create New API dialog with the key name WooCommerce Plugin and a Create button
  6. انقر على Copy API Key. تعرض لوحة التحكم المفتاح مرة واحدة فقط. الصقه في Live API Key ضمن إعدادات الإضافة.
    New API key dialog with the Copy API Key and Close buttons
    Live API Key field in the plugin settings
  7. بعد ذلك، أعد إعداد مفتاح توقيع webhook. يرسل Dodo Payments تحديثات الدفع إلى متجرك عبر webhook، وتستخدم الإضافة المفتاح للتحقق من أن كل webhook مصدره Dodo Payments.
  8. في أسفل إعدادات الإضافة، ضمن Webhook Endpoint، انسخ عنوان URL. ويكون بالشكل https://your-store.com/?wc-api=dodo_payments.
    Webhook Endpoint URL at the bottom of the plugin settings, above the Save changes button
  9. في لوحة تحكم Dodo Payments، ومع بقائك في الوضع المباشر، انتقل إلى Developer → Webhooks وانقر على Add endpoint.
    Webhooks page in live mode with no endpoints and an Add endpoint button
  10. الصق عنوان URL من الخطوة 8 في Endpoint URL. اترك Subscribed events فارغًا لتلقي كل الأحداث، أو حدد أحداث الدفع واسترداد الأموال والاشتراكات فقط، وهي الأحداث التي تتعامل معها الإضافة. ثم انقر على Create endpoint.
    Add endpoint dialog with the WooCommerce webhook URL in Endpoint URL
  11. تُفتح علامة التبويب Overview الخاصة بنقطة النهاية. ضمن Signing secret، انقر على رمز العين لإظهار السر، ثم انقر على رمز النسخ.
    Endpoint Overview tab with the hidden signing secret, the reveal and copy icons, and Rotate secret
  12. الصق السر في Live Webhook Signing Key ضمن إعدادات الإضافة، ثم انقر على Save changes.
    Live Webhook Signing Key field in the plugin settings
  13. راجع Global Tax Category وAll Prices are Tax Inclusive. تطبّقهما الإضافة عند إنشاء منتج في Dodo Payments، ويحدث ذلك في المرة الأولى التي يُجري فيها العميل عملية شراء للمنتج. بعد ذلك، يحتفظ المنتج بإعدادات الضرائب الموجودة له في لوحة تحكم Dodo Payments، حيث يمكنك تغييرها لكل منتج. لا يلزم استخدام Test API Key وTest Webhook Signing Key إلا في Test Mode.
    Test API Key, Test Webhook Signing Key, Global Tax Category, and All Prices are Tax Inclusive settings
ضمن Checkout Feature Flags، يمكنك أيضًا التحكم في خيارات صفحة الدفع الخاصة بـ Dodo Payments، مثل Allow Currency Selection وAllow Discount Codes. لا يتم إرسال العلم الذي يظل مضبوطًا على Default، لذلك يطبّق Dodo Payments الإعداد الافتراضي الخاص به.
لإجراء عمليات دفع تجريبية، فعّل Test Mode ضمن إعدادات الإضافة. تستخدم الإضافة حينها Test API Key وTest Webhook Signing Key، وتتصل ببيئة الاختبار في Dodo Payments. يحتوي وضع الاختبار على مفاتيح API ونقاط نهاية webhook خاصة به. للحصول عليها، عطّل مفتاح Live Mode في لوحة التحكم، واتبع الخطوات من 4 إلى 12 في وضع الاختبار، ثم الصق القيم في حقول الاختبار. عطّل Test Mode قبل الانتقال إلى الوضع المباشر.

​
لقد أتممت الإعداد!

يمكن للعملاء الآن اختيار Dodo Payments عند الدفع.
WooCommerce checkout page with the billing form and the Place order button
عندما يُجري العميل طلبًا، ترسله الإضافة إلى صفحة الدفع في Dodo Payments لإتمام الدفع. بعد الدفع، يرسل Dodo Payments webhook، وتحدّث الإضافة حالة الطلب.
Dodo Payments checkout page with card, UPI QR code, and UPI ID payment options

​
الميزات الأساسية

  • Hosted Checkout: يدفع العملاء في صفحة دفع تابعة لـ Dodo Payments، ثم يعودون إلى صفحة تأكيد الطلب في متجرك.
  • Multiple Payment Methods: تعرض صفحة الدفع طرق الدفع المتاحة لموقع كل عميل وعملته وجهازه.
  • Order Status Sync: تعمل webhooks على ضبط حالة الطلب على Completed أو Processing أو Failed أو Cancelled مع تغيّر حالة الدفع. وتعيد عمليات الدفع الفاشلة والملغاة المنتجات إلى المخزون.
  • Refunds: أجرِ عمليات استرداد الأموال من لوحة تحكم Dodo Payments. عند نجاح استرداد الأموال، تضبط الإضافة حالة الطلب على Refunded.
  • Subscriptions: باستخدام WooCommerce Subscriptions، تتم مزامنة تغيّرات الحالة في كلا الاتجاهين، بما في ذلك عند إلغاء الاشتراك أو تعليقه أو إعادة تفعيله. لا تتم مزامنة التغييرات على تواريخ الاشتراك في WooCommerce.
  • Order Notes: تضيف الإضافة ملاحظات للطلب لكل جلسة دفع وتغيير في الحالة وخطأ، كي تتمكن من متابعة كل عملية دفع من صفحة الطلب.
  • Multi-currency Support: تتم مزامنة المنتجات مع Dodo Payments باستخدام عملة متجر WooCommerce. يتحكم علم Allow Currency Selection في إمكانية تغيير العملاء للعملة عند الدفع.

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

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

  1. فشل معالجة الدفع
    • تحقق من تطابق مفتاح API مع وضع الإضافة. عند إيقاف Test Mode، تستخدم الإضافة Live API Key، الذي يجب أن يكون مصدره لوحة التحكم في الوضع المباشر. وعند تشغيل Test Mode، تستخدم Test API Key.
    • تحقق من ملاحظات الطلب. عندما يتعذر على الإضافة إنشاء عملية دفع، تضيف ملاحظة تحتوي على الخطأ، مثل خطأ يبدأ بـ Dodo Payments Error:.
    • إذا لم يظهر Dodo Payments عند الدفع، فتحقق من أن صفحة الدفع تستخدم الدفع الكلاسيكي، وليس كتلة Checkout.
    • إذا كان الطلب يحتوي على رمز خصم، فتحقق من أنه رمز نسبة مئوية واحد.
    • تبدأ عمليات الدفع المباشرة بعد اجتياز حسابك التحقق من الحساب.
  2. مشكلات مزامنة webhook
    • تحقق من أن Endpoint URL هو عنوان URL المطابق تمامًا للعنوان الموجود ضمن Webhook Endpoint في إعدادات الإضافة.
    • تحقق من أن مفتاح التوقيع في الإضافة يطابق Signing secret الخاص بنقطة النهاية، وأن كليهما مصدره الوضع نفسه.
    • تحقق من سجل أخطاء PHP بحثًا عن أسطر تبدأ بـ Dodo Payments:، مثل Dodo Payments: Could not verify webhook event. في الوضع المباشر، تعيد الإضافة 200 حتى عند فشل التحقق، لذلك تعرض سجلات Dodo Payments عملية التسليم على أنها ناجحة. وفي Test Mode، تعيد 401.
    • تحقق من أن موقعك يحتوي على شهادة SSL صالحة. يقبل Endpoint URL عناوين HTTPS فقط.
    • تحقق من أن الخادم وجدار الحماية وإضافات الأمان لديك تقبل طلبات POST إلى عنوان URL الخاص بـ webhook من عناوين IP الخاصة بـ Dodo Payments.
    • افتح علامة التبويب Logs ضمن Developer → Webhooks لعرض كل عملية تسليم واستجابة موقعك.

​
موارد الدعم

لمزيد من المساعدة:

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

  1. حدّث الإضافة عند إصدار نسخة جديدة للحصول على إصلاحات الأمان والميزات الجديدة.
  2. اختبر جميع مسارات الدفع في Test Mode قبل إجراء عمليات دفع مباشرة.
  3. حافظ على تحديث WordPress وWooCommerce.
  4. أنشئ نسخًا احتياطية من موقعك بانتظام.
  5. راقب طلباتك ولوحة تحكم Dodo Payments بحثًا عن أي نشاط غير معتاد.
  6. خزّن مفاتيح API بأمان، ولا تشاركها علنًا أبدًا.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦