MakePay Invision Community البوابة

ملخص

يضيف تطبيق MakePay Invision Community الرسمي التشفير المستضاف checkout إلى Invision Community 5 Commerce. تقوم التجارة بإنشاء الفاتورة والمعاملة، وتقوم MakePay بإنشاء رابط الدفع المستضاف، وتقوم webhooks الموقعة بتحديث المعاملة بعد أحداث الدفع.

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

قبل أن تبدأ

• Invision Community 5.0 أو الأحدث
• تم تثبيت تطبيق التجارة
• PHP 8.1 أو أحدث
• مجتمع HTTPS URL
• شركة MakePay حيث يمكنك إدارة إعدادات الدفع

تثبيت التطبيق

قم بتنزيل أحدث حزمة TAR:

https://plugins.makecrypto.io/downloads/invision-community/latest.tar

قم بتثبيته من مدير تطبيق Invision AdminCP.

قم بتوصيل MakePay

افتح إعدادات الدفع التجارية وأضف MakePay كطريقة دفع. اختر توصيل MakePay. التطبيق:

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

قم بتكوين MakePay

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

• توفر طريقة الدفع
• معرف الشركة MakePay
• رد الاتصال Webhook URL
• تسجيل التصحيح/الطلب
• بيانات الاعتماد الاحتياطية لمفتاح API اليدوية

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

تدفق الخروج

عندما يختار أحد الأعضاء MakePay، يقوم Invision بإنشاء معاملة تجارية ويقوم التطبيق بإنشاء رابط دفع MakePay مع بيانات تعريف الفاتورة.

المجال	الغرض
source=invision	يحدد التكامل
externalId=invision_invoice_<id>	خرائط نشاط MakePay تعود إلى التجارة
invoiceId	معرف فاتورة Invision Commerce
transactionId	معرف معاملة Invision Commerce
moduleVersion	تم تثبيت إصدار تطبيق MakePay

تتم إعادة توجيه العضو إلى MakePay checkout المستضاف ويعود إلى المجتمع بعد الدفع أو الإلغاء.

دول التجارة

تتحقق نقطة النهاية webhook من X-MakePay-Signature قبل تغيير حالة المعاملة التجارية.

حالة MakePay	حالة المعاملة Invision
paid، completed، confirmed، succeeded	تمت الموافقة عليه
failed، expired	رفض
cancelled، canceled	رفض
refunded	مستردة
حالات أخرى	في انتظار

يكتب كل webhook رسالة فاتورة خاصة بالحالة MakePay والدفعة UID والدفعة المستضافة URL عند توفرها.

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

يقوم التطبيق بتخزين تفاصيل الاتصال في إعدادات Invision المشفرة. اجعل وصول AdminCP مقتصراً على المشغلين الموثوقين، وافصل البوابة في 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، فتأكد من أن قاعدة المجتمع URL هي HTTPS ويمكن الوصول إليها بشكل عام. إذا فشلت عمليات إعادة التوجيه checkout، فتأكد من تثبيت Commerce وأن MakePay لديه إما اتصال محفوظ أو بيانات اعتماد احتياطية يدوية لمفتاح API. إذا لم يتم تحديث الفواتير، فقارن رد الاتصال MakePay webhook URL مع المجتمع webhook URL وقم بتدوير سر webhook.