MakePay WHMCS البوابة

ملخص

تضيف بوابة MakePay WHMCS الرسمية التشفير المستضاف checkout إلى فواتير WHMCS. يعرض WHMCS زر دفع على الفاتورة، ويقوم MakePay بإنشاء رابط الدفع المستضاف، ويحدد رد الاتصال الموقع الفاتورة المدفوعة بعد تسوية الدفع.

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

قبل أن تبدأ

• WHMCS 8.13 LTS أو WHMCS 9.x
• PHP 8.1 أو أحدث مع تمكين OpenSSL
• HTTPS WHMCS النظام URL
• وصول المسؤول WHMCS إلى بوابات الدفع
• شركة MakePay حيث يمكنك إدارة إعدادات الدفع

تثبيت البوابة

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

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

قم باستخراج ملف ZIP وتحميل دليل modules إلى جذر WHMCS. تقوم الحزمة بتثبيت هذه الملفات:

modules/gateways/makepay.php
modules/gateways/makepay/checkout.php
modules/gateways/makepay/oauth.php
modules/gateways/makepay/lib/*.php
modules/gateways/callback/makepay.php

في WHMCS، افتح إعدادات النظام > بوابات الدفع، وقم بتنشيط MakePay، ثم احفظ إعدادات البوابة.

قم بتوصيل MakePay

افتح إعدادات بوابة MakePay واختر Connect MakePay. البوابة:

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

قم بتكوين MakePay

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

• معرف الشركة MakePay
• أصول التسوية
• انتهاء الدفع
• حالة الاتصال MakePay
• Webhook سر التوقيع

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

تدفق الخروج

عندما يفتح العميل فاتورة WHMCS غير مدفوعة، تعرض بوابة MakePay زر دفع. يقوم معالج checkout بالتحقق من صحة حمولة النموذج الموقع، وتحميل الفاتورة من خلال مساعدي API المحليين، وإنشاء رابط دفع MakePay، وإعادة توجيه العميل إلى MakePay checkout المستضاف.

المجال	الغرض
source=whmcs	يحدد التكامل
orderId=whmcs_invoice_<invoiceId>	خرائط نشاط MakePay تعود إلى WHMCS
invoiceId	معرف الفاتورة WHMCS
clientId	معرف العميل WHMCS
moduleVersion	تم تثبيت إصدار بوابة MakePay
whmcsVersion	إصدار وقت التشغيل WHMCS

يقوم المشتري بإرجاع فاتورة WHMCS الأصلية بعد الدفع أو الإلغاء.

حالات الفاتورة

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

https://billing.example.com/modules/gateways/callback/makepay.php

حالة MakePay	سلوك WHMCS
paid، completed، confirmed، succeeded	يستدعي addInvoicePayment ويسجل معرف المعاملة
failed، expired	يسجل رد الاتصال ويترك الفاتورة غير مدفوعة
cancelled، canceled	يسجل رد الاتصال ويترك الفاتورة غير مدفوعة
refunded	يسجل رد الاتصال للمراجعة اليدوية
حالات أخرى	تم تسجيله وتجاهله

تتضمن سجلات المعاملات WHMCS حمولة رد الاتصال MakePay حتى تتمكن فرق الدعم من تتبع الدفع UID وبيانات تعريف الفاتورة والمبلغ والحالة.

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

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