MakePay VirtueMart البرنامج المساعد

ملخص

يضيف المكون الإضافي MakePay VirtueMart طريقة دفع تشفير مستضافة إلى متاجر Joomla التي تستخدم VirtueMart. يختار العملاء MakePay في checkout، ويدفعون على صفحة MakePay checkout، ويعودون إلى المتجر بينما يحتفظ VirtueMart بسجل الطلب.

تعمل إشعارات الدفع الموقعة على تحديث طلب VirtueMart بعد الدفع، حتى يتمكن فريق المتجر من مواصلة إدارة الطلبات داخل VirtueMart.

قبل أن تبدأ

• Joomla مع تثبيت VirtueMart
• PHP 7.4 أو أحدث مع تمكين OpenSSL وcURL
• واجهة متجر HTTPS عامة
• الوصول إلى تثبيت ملحق Joomla وطرق الدفع VirtueMart
• شركة MakePay تم تكوين التسوية والعلامة التجارية لها

تثبيت البرنامج المساعد

قم بتنزيل أحدث ملف مضغوط:

https://plugins.makecrypto.io/downloads/virtuemart/latest.zip

في Joomla، افتح النظام > الملحقات، وقم بتحميل ملف ZIP، ثم قم بتمكين VM Payment - MakePay Crypto Payment Gateway من مدير البرنامج الإضافي.

في VirtueMart، افتح طرق الدفع، وأنشئ طريقة دفع، واختر مكون الدفع MakePay الإضافي، واحفظه مرة واحدة حتى يقوم VirtueMart بتعيين معرف طريقة الدفع.

قم بتوصيل MakePay

بعد حفظ طريقة الدفع، افتح الاتصال URL من واجهة المتجر. استبدل PAYMENT_METHOD_ID بمعرف طريقة الدفع VirtueMart:

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

يطلب منك MakePay تسجيل الدخول واختيار الشركة التي يجب أن تتلقى المدفوعات والموافقة على الاتصال. بعد الموافقة، يقوم البرنامج الإضافي بتخزين الاتصال على طريقة الدفع VirtueMart ويقوم بتكوين رد الاتصال MakePay URL.

إعدادات البوابة

قم بمراجعة هذه الحقول قبل تمكين طريقة الدفع بشكل عام:

الإعداد	الغرض
طريقة الاتصال	استخدم Connect MakePay للإعداد العادي، أو مفاتيح API اليدوية كبديل
معرف الشركة MakePay	تم ملؤه بعد الاتصال، أو تم إدخاله يدويًا للرجوع
عملة التسوية	أصول التسوية المفضلة، مثل USDT
انتهاء الدفع	إلى متى يظل رابط checkout المستضاف مستحق الدفع
Webhook سر	يستخدم للتحقق من إشعارات الدفع MakePay
حالات الطلب	حالات VirtueMart للمدفوعات المعلقة والمدفوعة والفاشلة ومنتهية الصلاحية والملغاة والمستردة

تدفق الخروج

عندما يختار المتسوق MakePay، يقوم البرنامج الإضافي بإنشاء رابط دفع MakePay مع:

المجال	الغرض
source=virtuemart	يحدد التكامل
orderId=virtuemart_order_<id>	خرائط نشاط MakePay تعود إلى VirtueMart
orderNumber	VirtueMart رقم الطلب الموضح للتاجر
pluginVersion	تم تثبيت إصدار البرنامج المساعد MakePay
virtuemartVersion	إصدار وقت التشغيل VirtueMart عند توفره

تتم إعادة توجيه المتسوق إلى checkout المستضاف. يقوم MakePay بعد ذلك بإرسال إشعار موقع إلى نقطة نهاية إشعار البرنامج المساعد VirtueMart.

ترتيب الدول

حالة MakePay	سلوك VirtueMart
paid، completed، confirmed، succeeded	ينقل الطلب إلى الحالة المدفوعة التي تم تكوينها
expired	ينقل الطلب إلى الحالة منتهية الصلاحية التي تم تكوينها
failed	ينقل الطلب إلى الحالة الفاشلة التي تم تكوينها
cancelled، canceled	ينقل الطلب إلى حالة الإلغاء التي تم تكوينها
refunded	ينقل الطلب إلى حالة الاسترداد التي تم تكوينها
حالات أخرى	يتم التجاهل حتى وصول حالة الدفع النهائية

يكتب كل تحديث تعليقًا خاصًا على الطلب يتضمن معاملة MakePay والمبلغ والأصل والدفع URL عند وجود هذه الحقول.

دليل API-مفتاح احتياطي

إذا تعذر استخدام تدفق الاتصال، فاضبط طريقة الاتصال على الرجوع اليدوي لمفتاح API وأدخل:

• معرف الشركة MakePay
• معرف المفتاح API
• API السر الرئيسي
• Webhook سر

استخدم هذا فقط عند الحاجة، واحتفظ بوصول مسؤول Joomla مقتصراً على المشغلين الموثوق بهم.

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

إذا تعذر بدء تشغيل checkout، فتأكد من أن طريقة الدفع بها اتصال بالشركة أو إعدادات مفتاح API اليدوية. إذا فشل الاتصال URL، فتأكد من أن واجهة المتجر عامة HTTPS وأن قيمة pm تشير إلى طريقة الدفع MakePay المحفوظة.

إذا لم يتم تحديث الطلبات، فقارن رد الاتصال MakePay URL مع إشعار البرنامج المساعد VirtueMart URL وقم بتدوير سر webhook من إعدادات طريقة الدفع.