قبول مدفوعات العملات المشفّرة على ووردبريس باستخدام إضافة DV.net لـ WooCommerce

يُعد دمج بوابة دفع للعملات المشفّرة في متجر التجارة الإلكترونية لديك طريقة ممتازة لتوسيع قاعدة عملائك وتقديم خيارات دفع حديثة وآمنة. توفر DV.net حلاً قويًا للتعامل مع هذه المعاملات، وتسهّل إضافتها المخصصة لـ WooCommerce عملية الدمج بشكل مباشر. سيرشدك هذا الدليل خطوة بخطوة لتثبيت وتهيئة إضافة DV.net لـ WooCommerce على موقع ووردبريس الخاص بك.

المتطلبات الأساسية:

• موقع ووردبريس فعّال.
• إضافة WooCommerce مُثبتة ومفعّلة.
• حساب DV.net فعّال.

الخطوة 1: الحصول على إضافة DV.net لـ WooCommerce

أول خطوة هي تنزيل ملفات الإضافة. على عكس الإضافات الموجودة في مستودع ووردبريس الرسمي، ستحصل على هذه الإضافة من صفحة GitHub الخاصة بـ DV.net.

انتقل إلى مستودع إضافة DV.net WooCommerce الرسمي: https://github.com/dv-net/dv-woocommerce (تم توفير هذا في ملفاتك).

• انقر على قسم Releases في القائمة اليمنى.
• اختر "Source code (zip)" من قائمة آخر إصدار.
• احفظ ملف .zip على جهازك. لا تقم بفك ضغطه.

الخطوة 2: تثبيت الإضافة على موقع ووردبريس الخاص بك

الآن ستقوم برفع ملف ZIP الذي تم تنزيله إلى لوحة تحكم ووردبريس.

1. سجّل الدخول إلى لوحة تحكم ووردبريس الخاصة بك (مثال: yourdomain.com/wp-admin).
2. من القائمة الجانبية، انتقل إلى Plugins > Add New.
3. في أعلى صفحة "Add Plugins"، انقر زر Upload Plugin.
4. انقر زر "Choose File" واختر ملف dv-woocommerce-main.zip الذي قمت بتنزيله للتو.
5. انقر Install Now.
6. بعد أن ينهي ووردبريس تثبيت الإضافة، انقر زر Activate Plugin. سترى الآن "DV.net WooCommerce Plugin" ضمن قائمة الإضافات المفعّلة لديك.

الخطوة 3: الحصول على بيانات اعتماد واجهة برمجة التطبيقات API من DV.net

لربط متجرك بـ DV.net، ستحتاج إلى API Key وAPI Secret وAPI URL.

• سجّل الدخول إلى لوحة تحكم حسابك في DV.net.
• ابحث عن مشروعك أو أنشئ مشروعًا جديدًا.
• انتقل إلى قسم API Keys عبر Projects -> زر Edit للمشروع المحدد (بالرجوع إلى obtaining-api-key-and-secret.md من ملفات التوثيق).
• ستجد مفتاح API والمفتاح السري. يمكنك إعادة توليدهما إذا لزم الأمر.
• في القسم أدناه، وفّر عناوين URL للـ Webhooks. بشكل أساسي ستحتاج إلى Webhook للدفع الناجح فقط.

الخطوة 4: تهيئة بوابة DV.net في WooCommerce

بعد حصولك على مفاتيح الـ API، يمكنك الآن ضبط إعدادات الإضافة داخل WooCommerce.

1. من لوحة تحكم ووردبريس، انتقل إلى WooCommerce > Settings.
2. انقر على تبويب Payments أعلى الصفحة.
3. سترى "DV.net" ضمن قائمة طرق الدفع. انقر زر Manage في الجهة اليمنى.
4. سيُفتح لك صفحة إعدادات DV.net. املأ الحقول التالية:
   1. Enable/Disable: ضع علامة على "Enable DV.net" لجعل طريقة الدفع هذه متاحة عند الدفع.
   2. Title: هذا النص الذي سيظهر للعملاء عند اختيار طريقة الدفع. على سبيل المثال: "Pay with Crypto via DV.net".
   3. Description: نص قصير يظهر تحت العنوان. على سبيل المثال: "Securely pay with cryptocurrency."
   4. API URL: الصق عنوان API URL.
   5. API Key: الصق API Key الذي حفظته في الخطوة 3.
   6. API Secret: الصق API Secret الذي حفظته في الخطوة 3.
5. انقر زر Save changes أسفل الصفحة.

الخطوة 5: تهيئة الـ Webhook في حساب DV.net الخاص بك

أصبح متجرك الآن معدًا لإرسال طلبات الدفع إلى DV.net. تبقى الخطوة الأخيرة وهي إعداد Webhook حتى تتمكن DV.net من إرسال تحديثات حالة الدفع (مثل "Paid" أو "Failed") إلى متجرك.

1. عُد إلى لوحة تحكم حسابك في DV.net.
2. انتقل إلى قسم Webhooks أو Developer.
3. أنشئ Webhook جديدًا.
4. Payload URL: هذا هو الجزء الأهم. عنوان الـ Webhook الخاص والفريد بمتجرك هو: https://example.com/wc-api/dv_gateway/ (تذكر استبدال example.com بعنوان موقعك الفعلي. تأكد من أنه يستخدم https://).
5. ضع عنوان الـ Webhook هنا (في Woo يكون تقريبًا بهذا الشكل https://example.com/?wc-api=dv_gateway)
6. Events: إذا طُلِب منك، اختر الأحداث التي يجب أن يستمع لها هذا الـ Webhook. ينبغي تفعيل جميع الأحداث المتعلقة بالدفع، مثل:
   1. Confirmed payment
   2. Unconfirmed payment (i.e when customer will send their payment via BTC and )
   3. Processing withdrawal (currently unsupported by this integration)
7. احفظ وفعّل الـ Webhook في لوحة تحكم DV.net.

الخطوة 6: أنت جاهز! (لا تنسَ الاختبار)

تهانينا! تم الآن دمج بوابة الدفع DV.net بالكامل مع متجر WooCommerce الخاص بك.

تبقى إجراء تجربة حية. أفضل طريقة للقيام بذلك:

1. انتقل إلى متجرك كما لو كنت عميلًا.
2. أضف منتجًا حقيقيًا إلى سلة التسوق.
3. انتقل إلى صفحة الدفع.
4. اختر "Pay with Crypto via DV.net" (أو العنوان الذي قمت بتعيينه).
5. أكمل الطلب وتأكد من أنه يتم إعادة توجيهك بشكل صحيح إلى صفحة الدفع لدى DV.net.
6. نوصي بشدة بإتمام معاملة اختبار صغيرة للتأكد من أن حالة الطلب يتم تحديثها تلقائيًا في قسم طلبات WooCommerce من "Pending payment" إلى "Processing" أو "Completed" بعد نجاح الدفع.

إذا تم تحديث حالة الطلب تلقائيًا، فإن التكامل لديك ناجح!