ملحق OpenCart

ملخص

يتيح MakePay لـ OpenCart للتجار قبول مدفوعات العملات المشفرة من خلال MakePay المستضاف checkout دون جمع تفاصيل الدفع داخل OpenCart. يظهر الامتداد كطريقة دفع OpenCart، وينشئ رابط دفع MakePay لكل طلب، ويعيد توجيه المتسوق إلى MakePay، ويقبل webhooks الموقع لتحديث حالة طلب OpenCart.

قبل أن تبدأ

• OpenCart 4.x
• PHP 8.0 أو أحدث
• HTTPS على الواجهة الأمامية للمتجر
• شركة MakeCrypto مع تمكين MakePay
• مستخدم MakeCrypto يمكنه الاتصال بالشركة المستقبلة
• اختياري: تكامل MakePay API للرجوع اليدوي لمفتاح API

يقوم OpenCart بتخزين إعدادات الامتداد في قاعدة البيانات الخاصة به. يقتصر الوصول إلى مشرف OpenCart على المشغلين الموثوق بهم لأنه يتم تخزين تفاصيل الاتصال وأسرار webhook وبيانات الاعتماد الاحتياطية لمفتاح API الاختيارية في إعدادات امتداد الدفع.

قم بإعداد MakeCrypto

أكمل إعداد التاجر قبل توصيل OpenCart.

1. افتح الصفحة الرئيسية > التاجر > إعدادات الدفع وتأكد من تمكين MakePay.
2. افتح الصفحة الرئيسية > عمليات التكامل > عمليات التكامل API.
3. تأكد من أن المستخدم الذي يتصل بـ OpenCart يمكنه إدارة عمليات التكامل لذلك شركة.
4. احتياطي اختياري: قم بإنشاء أو تحديد تكامل API، ثم انسخ ملف معرف الشركة ومعرف المفتاح API وسر المفتاح API.

قم بتثبيت الامتداد

المصدر الموصى به هو القائمة الرسمية لسوق OpenCart:

افتح في OpenCart ملحق Explorer

للتثبيت اليدوي، قم بتنزيل أحدث حزمة OpenCart مباشرة:

تنزيل دليل OCMOD ZIP

ثم قم بتثبيته في OpenCart:

1. في مشرف OpenCart، افتح الامتدادات > المثبت.
2. تحميل makepay.ocmod.zip.
3. افتح الامتدادات > الامتدادات واختر المدفوعات.
4. ابحث عن MakePay وانقر على تثبيت.
5. افتح تحرير لتكوين طريقة الدفع.

يحتوي جذر الحزمة على install.json، وadmin/، وcatalog/، بما يتوافق مع تخطيط مثبت الامتداد OpenCart 4.

قم بتوصيل MakePay

في الامتدادات > الدفعات > MakePay، استخدم Connect MakePay. التمديد:

1. يفتح MakeCrypto في علامة تبويب المتصفح.
2. يطلب منك تسجيل الدخول واختيار الشركة التي يجب أن تتلقى المدفوعات.
3. يعرض الأذونات التي يحتاجها ملحق OpenCart.
4. يعيدك إلى OpenCart بعد الموافقة.
5. يحفظ اتصال المتجر ومعرف الشركة.
6. تكوين سر رد الاتصال MakePay webhook URL وwebhook.

يطلب الاتصال هذه الأذونات:

company:read
makepay:payment-links:read
makepay:payment-links:write
makepay:customers:read
makepay:customers:write
makepay:settings:read
makepay:settings:write

يحتوي URI لإعادة التوجيه على هذا الشكل:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.oauth

قم بتكوين MakePay

في الامتدادات > الدفعات > MakePay، قم بتكوين:

المجال	القيمة
الحالة	ممكّن
اسم طريقة الدفع	ملصق checkout الموجه للمتسوقين
طريقة الاتصال	قم بتوصيل MakePay أو مفتاح احتياطي API اليدوي
معرف الشركة MakePay	تم ملؤه بعد الاتصال، أو تم إدخاله يدويًا لمفتاح API الاحتياطي
معرف المفتاح API	معرف مفتاح التكامل API للرجوع فقط
API سر المفتاح	سر التكامل API للرجوع فقط
Webhook سر	يتم تعيينه أثناء الاتصال، أو يتم إدخاله يدويًا كإجراء احتياطي
API قاعدة URL	https://www.makecrypto.io
عملة التسوية	أصل التسوية الافتراضي، على سبيل المثال USDT
انتهاء صلاحية رابط الدفع	على سبيل المثال 12h
تجربة الخروج	إعادة التوجيه المستضاف أو checkout المضمن مع إطار iframe آمن وارتباط احتياطي مستضاف

اسم طريقة الدفع الافتراضية هو:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

قم بتكوين webhooks

انسخ webhook URL الموضح في صفحة إعدادات OpenCart MakePay. ولها هذا الشكل:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.webhook

يقوم Connect MakePay بتكوين رد الاتصال هذا تلقائيًا. بالنسبة للرجوع اليدوي لمفتاح API، أضفه إلى إعدادات MakePay webhook بنفس سر webhook الذي تم إدخاله في OpenCart.

يتحقق الامتداد من X-MakePay-Signature قبل أن يقوم بتحديث الطلب. يستخدم التوقيع تنسيق HMAC ذو الطابع الزمني:

t=1760000000,v1=<hex-hmac>

تدفق الخروج

عندما يختار المتسوق MakePay:

1. يقوم OpenCart بالتحقق من صحة الطلب النشط وطريقة الدفع المحددة.
2. يستدعي الامتداد شريك MakePay API لإنشاء رابط دفع.
3. يتم نقل الأمر إلى الحالة المعلقة التي تم تكوينها.
4. يفتح المتسوق تجربة MakePay checkout المحددة.
5. يقوم webhook الموقع بتحديث أمر OpenCart بعد تغيير حالة الدفع.

يتضمن رابط الدفع البيانات الوصفية:

البيانات الوصفية	الغرض
source=opencart	يحدد التكامل
orderId	معرف الطلب OpenCart
storeId	معرف المتجر OpenCart
storeName	اسم المتجر
storeUrl	واجهة المتجر URL
opencartOrderId	معرف طلب OpenCart للوحة القيادة ومطابقة webhook
opencartOrderAdminUrl	أمر المشرف URL المستخدم بواسطة إجراء MakeCrypto إظهار الطلب
storeOrderAdminUrl	أمر إداري عام URL احتياطي للمتاجر المتصلة
moduleVersion	نسخة التمديد MakePay OpenCart
opencartVersion	إصدار وقت التشغيل OpenCart

دول النظام

قم بتكوين تعيين الحالة في إعدادات الامتداد.

حالة MakePay	حالة OpenCart
paid، completed، confirmed، succeeded	الحالة المدفوعة
failed، expired، chargeback	حالة فاشلة
cancelled، canceled	الحالة الملغاة
refunded	حالة الاسترداد
أي حالة قيد التقدم	الحالة في انتظار

يضيف الملحق تعليق سجل الطلب الذي يحتوي على حالة MakePay والدفعة UID أو المعرف والمبلغ والأصل وcheckout المستضافة URL عند وجودها في حمولة webhook. يتضمن إدخال سجل checkout الأولي أيضًا الدفع العام URL ورابط دفع لوحة المعلومات MakeCrypto عندما توفر استجابة API واحدًا.

ملاحظات أمنية

• استخدم HTTPS لـ checkout وwebhook URLs.
• إبقاء وصول المسؤول OpenCart مقيدًا لأن تفاصيل الاتصال واختيارية يتم تخزين بيانات اعتماد API في إعدادات OpenCart.
• قم بإلغاء التطبيق المتصل OpenCart من MakeCrypto إذا كان حساب مسؤول OpenCart تم اختراقه.
• قم بتدوير المفتاح MakePay API إذا تم الكشف عن بيانات الاعتماد الاحتياطية اليدوية لمفتاح API.
• اجعل سر webhook مختلفًا عن سر مفتاح API.
• تعامل مع حالات فشل توقيع webhook غير المتوقعة على أنها عدم تطابق في بيانات الاعتماد أو محاولة انتحال محتملة.

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

إذا لم تكن طريقة الدفع مرئية، فتأكد من تمكين MakePay، وأن إجمالي سلة التسوق يلبي الحد الأدنى الذي تم تكوينه، ويتطابق عنوان العميل مع المنطقة الجغرافية التي تم تكوينها.

إذا فشل Connect MakePay، فتأكد من أن مخزن OpenCart URL هو HTTPS وسيعود المتصفح إلى رد الاتصال URL الموضح أعلاه.

إذا لم يقوم checkout بإعادة التوجيه، فتأكد من اتصال المتجر. بالنسبة للرجوع اليدوي، قم بتأكيد معرف الشركة ومعرف مفتاح API وسر المفتاح API وأذونات التكامل API الأساسية URL وMakePay API.

إذا لم يتم تحديث الطلبات بعد الدفع، فتأكد من أن webhook URL يمكن الوصول إليه بشكل عام عبر HTTPS وأن سر webhook في MakePay يطابق السر المحفوظ في OpenCart.

إذا أبلغ OpenCart عن خطأ في التثبيت، فتأكد من أن الملف الذي تم تنزيله ينتهي بـ .ocmod.zip ويحتوي على install.json وadmin/ وcatalog/ في جذر ZIP.