MakePay Magento الوحدة النمطية

ملخص

تضيف وحدة MakePay Magento الرسمية طريقة تشفير مستضافة checkout إلى متاجر Magento مفتوحة المصدر وAdobe Commerce 2.4.x. يقوم Magento بإنشاء الطلب، ويقوم MakePay بإنشاء رابط الدفع المستضاف، ويقوم webhooks الموقع بتحديث الطلب بعد تغيير حالة الدفع.

استخدم Connect MakePay للإعداد العادي. تظل بيانات اعتماد مفتاح API اليدوية متاحة كبديل.

قبل أن تبدأ

• Magento مفتوح المصدر أو Adobe Commerce 2.4.x
• PHP 8.1 أو أحدث
• وصول المسؤول إلى المتاجر > التكوين > المبيعات > طرق الدفع
• شركة MakePay حيث يمكنك إدارة إعدادات الدفع

تثبيت الوحدة

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

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

قم باستخراج الحزمة بحيث توجد الوحدة في:

app/code/MakePay/Payment

قم بتمكينه من جذر Magento:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

قم بتوصيل MakePay

افتح المتاجر > التكوين > المبيعات > طرق الدفع > MakePay وحدد Connect MakePay. الوحدة:

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

قم بتكوين MakePay

بعد انتهاء الاتصال، احتفظ بطريقة الاتصال مضبوطة على وضع الاتصال الافتراضي. تمكين طريقة الدفع والمراجعة:

• اسم طريقة الدفع
• تجربة الخروج
• عملة التسوية
• انتهاء صلاحية رابط الدفع
• حالات الطلب المعلقة، والمدفوعة، والفاشلة، والملغاة، والمستردة

يتطلب الرجوع اليدوي لمفتاح API معرف شركة MakePay، ومعرف مفتاح API، وسر المفتاح API، وسر webhook.

تدفق الخروج

عندما يختار العميل MakePay، فإن Magento يضع الطلب في انتظار الدفع، ثم يفتح تجربة MakePay checkout المحددة. إعادة التوجيه المستضافة هي الخيار الافتراضي الموصى به؛ يعرض checkout المضمن صفحة iframe MakePay آمنة مع رابط احتياطي مستضاف.

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

المجال	الغرض
source=magento	يحدد التكامل
orderId=magento_order_<id>	خرائط نشاط MakePay تعود إلى Magento
incrementId	رقم الطلب Magento الذي يمكن قراءته بواسطة الإنسان
magentoOrderAdminUrl	يتيح لـ MakeCrypto ربط المسؤولين مرة أخرى بترتيب Magento
moduleVersion	تم تثبيت إصدار الوحدة النمطية MakePay
magentoVersion	إصدار وقت التشغيل Magento أو Adobe Commerce

ترتيب الدول

نقطة النهاية webhook هي /makepay/webhook/index. يقوم بالتحقق من رأس X-MakePay-Signature قبل تحديث الطلب.

حالة MakePay	حالة Magento
paid، completed، confirmed، succeeded	معالجة
failed، expired	تم الإلغاء
cancelled، canceled	تم الإلغاء
refunded	مغلق
حالات أخرى	في انتظار الدفع

يكتب كل webhook تعليقًا خاصًا لسجل الطلب مع حالة الدفع، وMakePay العام checkout URL، ولوحة التحكم MakeCrypto URL، ومعرفات MakePay المتاحة.

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

تقوم الوحدة بتخزين تفاصيل الاتصال في التكوين المشفر Magento. اجعل وصول المسؤول إلى Magento مقتصراً على المشغلين الموثوقين، وافصل المتجر في MakeCrypto إذا تم الكشف عن حساب مسؤول أو نسخة احتياطية للخادم.

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

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

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

إذا تعذر بدء تشغيل Connect MakePay، فتأكد من أن قاعدة Magento URL هي HTTPS ويمكن الوصول إليها بشكل عام. إذا فشلت عمليات إعادة التوجيه checkout، فتأكد من تمكين الوحدة وأن MakePay لديه إما اتصال محفوظ أو بيانات اعتماد احتياطية يدوية لمفتاح API. إذا لم يتم تحديث الطلبات، قارن رد الاتصال webhook URL في إعدادات MakePay مع Magento /makepay/webhook/index URL وقم بتدوير السر webhook.