MakePay XenForo مزود الدفع

ملخص

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

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

قبل أن تبدأ

• XenForo 2.3 أو أحدث
• PHP 8.1 أو أحدث مع تمكين OpenSSL
• منتدى/مجتمع HTTPS
• وصول المشرف إلى ملفات تعريف الدفع
• شركة MakePay حيث يمكنك إدارة إعدادات الدفع

قم بتثبيت الوظيفة الإضافية

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

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

قم بتثبيته من خلال مثبت أرشيف الوظيفة الإضافية XenForo أو قم بتحميل محتويات دليل upload/ إلى جذر XenForo. معرف الوظيفة الإضافية هو MakePay/Payment، والمصدر مثبت على:

src/addons/MakePay/Payment

قم بتوصيل MakePay

انتقل إلى الخيارات > مزودي الخدمة > ملفات تعريف الدفع > إضافة ملف تعريف الدفع واختر MakePay. احفظ ملف التعريف مرة واحدة، وأعد فتحه، ثم اختر Connect MakePay. الوظيفة الإضافية:

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

قم بتكوين MakePay

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

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

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

تدفق الخروج

أضف ملف تعريف الدفع MakePay إلى ترقية مستخدم XenForo أو المورد المدفوع أو تدفق آخر قابل للشراء يدعم ملفات تعريف الدفع. عندما يختار أحد الأعضاء MakePay، تقوم الوظيفة الإضافية بإنشاء رابط دفع MakePay مع البيانات التعريفية XenForo.

المجال	الغرض
source=xenforo	يحدد التكامل
orderId=xenforo_purchase_<requestKey>	خرائط نشاط MakePay تعود إلى XenForo
requestKey	XenForo مفتاح طلب الشراء
purchasableTypeId	XenForo النوع القابل للشراء
moduleVersion	تم تثبيت إصدار الوظيفة الإضافية MakePay
xenforoVersion	إصدار وقت التشغيل XenForo

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

دول الدفع

يرسل MakePay ردود اتصال موقعة إلى:

https://your-forum.example/payment_callback.php?_xfProvider=makepay

حالة MakePay	نتيجة رد الاتصال XenForo
paid، completed، confirmed، succeeded	تم استلام المبلغ
failed، expired	تم عكس الدفع
cancelled، canceled	تم عكس الدفع
refunded	تم عكس الدفع
حالات أخرى	في انتظار

يسجل XenForo سجل موفر الدفع باستخدام MakePay للدفع UID ومفتاح طلب الشراء والدفع URL عند توفره وحمولة رد الاتصال.

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

تقوم الوظيفة الإضافية بتخزين تفاصيل الاتصال في خيارات ملف تعريف الدفع. اجعل وصول المسؤول إلى XenForo مقتصراً على المشغلين الموثوقين، وافصل المجتمع في 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، فتأكد من أن لوحة XenForo URL هي HTTPS ويمكن الوصول إليها بشكل عام. إذا كان زر Connect MakePay مفقودًا، فاحفظ ملف تعريف الدفع مرة واحدة وأعد فتحه. إذا لم تكتمل عمليات الشراء، فقارن رد الاتصال MakePay webhook URL مع XenForo payment_callback.php?_xfProvider=makepay URL وقم بتدوير السر webhook.