كيفية قبول مدفوعات العملات الرقمية على OpenCart باستخدام إضافة بوابة الدفع DV.net

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

المتطلبات المسبقة:

• موقع OpenCart نشط.
• صلاحية وصول كمسؤول إلى لوحة تحكم OpenCart.
• حساب DV.net نشط.

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

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

• انتقل إلى مستودع إضافة DV.net لـ OpenCart الرسمي: https://github.com/dv-net/dv-opencart.
• انتقل إلى صفحة Releases
• قم بتنزيل dv-opencart-vX.X.X.ocmod.zip

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

يستخدم OpenCart أداة Extension Installer للتعامل مع عمليات الرفع.

• سجّل الدخول إلى لوحة تحكم مسؤول OpenCart (مثلًا، yourdomain.com/admin).
• انتقل إلى Extensions > Installer من القائمة اليسرى.
• انقر على زر Upload.
• اختر ملف .zip الذي قمت بتنزيله في الخطوة 1
• انتظر حتى تكتمل عملية الرفع والتثبيت. ينبغي أن ترى رسالة نجاح.
• مهم: بعد التثبيت، اذهب إلى Extensions > Modifications وانقر على زر Refresh الأزرق في الزاوية العلوية اليمنى لضمان تعرّف النظام على التغييرات.
• من الجيد أيضًا مسح ذاكرة تخزين القالب المؤقتة. اذهب إلى Dashboard، انقر على أيقونة الترس الزرقاء للإعدادات في الزاوية العلوية اليمنى، ثم انقر على أزرار Refresh لكل من Theme Cache و SASS Cache.

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

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

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

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

الآن، قم بتهيئة طريقة الدفع داخل لوحة تحكم OpenCart.

• في لوحة تحكم OpenCart، اذهب إلى Extensions > Extensions.
• من القائمة المنسدلة المسمّاة "Choose the extension type"، اختر Payments.
• مرّر للأسفل حتى تجد "DV.net Gateway". انقر زر التثبيت الأخضر (+) إذا لم تكن مثبتة بالفعل، ثم انقر زر التعديل الأزرق (أيقونة القلم).
• سيؤدي ذلك إلى فتح صفحة إعدادات DV.net. املأ التفاصيل التالية:
• API URL: الصق عنوان API URL من الخطوة 3.
• API Key: الصق API Key من الخطوة 3.
• API Secret: الصق API Secret من الخطوة 3.

الخطوة 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/index.php?route=extension/payment/dv_gateway/callback) واضغط Create
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 على OpenCart قد اكتمل الآن! من الضروري إجراء معاملة اختبار.
• زر الواجهة الأمامية لمتجر OpenCart الخاص بك.
• أضف منتجًا إلى سلة التسوق.
• تابع عملية إتمام الشراء.
• عند اختيار طريقة الدفع، اختر "DV.net Gateway" (أو العنوان الذي قمت بإعداده، رغم أنه غالبًا ما يكون ثابتًا في إضافات OpenCart).
• أكّد الطلب. ينبغي أن يتم توجيهك إلى صفحة الدفع لدى DV.net.
• يُنصح بشدة: أكمل معاملة حقيقية صغيرة. بعد الدفع بنجاح على DV.net، ارجع إلى لوحة تحكم OpenCart > Sales > Orders. تحقّق من أن حالة طلب الاختبار قد تم تحديثها تلقائيًا من حالة 'Pending' إلى حالة 'Paid' (مثل 'Processing' أو 'Complete'). إذا تم تحديث حالة الطلب بشكل صحيح دون تدخل يدوي، فإن إعدادك ناجح! يمكن للعملاء الآن الدفع باستخدام العملات الرقمية عبر DV.net على متجر OpenCart الخاص بك.