MakePay ClientExec البوابة

ملخص

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

تبقى الفواتير المتكررة داخل ClientExec. عندما يقوم ClientExec بإنشاء كل فاتورة تجديد، فإن نفس تدفق بوابة MakePay يسمح للعميل بدفع تلك الفاتورة.

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

قبل أن تبدأ

• ClientExec 6.8 أو الأحدث، بما في ذلك ClientExec 7.x
• PHP 7.4 أو أحدث مع تمكين OpenSSL وcURL
• HTTPS ClientExec URL
• وصول المسؤول ClientExec إلى معالجات الدفع
• شركة MakePay حيث يمكنك إدارة إعدادات الدفع

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

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

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

قم باستخراج ملف ZIP وتحميل المجلد makepay إلى:

ClientExec/plugins/gateways/makepay

تقوم الحزمة بتثبيت هذه الملفات:

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

في ClientExec، افتح الإعدادات > المكونات الإضافية > معالجات الدفع، وحدد MakePay، واحفظ إعدادات معالج الدفع.

قم بتوصيل MakePay

افتح إعدادات معالج الدفع MakePay وانسخ Connect MakePay URL إلى متصفحك. البوابة:

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

قم بتكوين MakePay

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

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

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

تدفق الخروج

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

المجال	الغرض
source=clientexec	يحدد التكامل
orderId=clientexec_invoice_<invoiceId>	خرائط نشاط MakePay تعود إلى ClientExec
invoiceId	رقم الفاتورة ClientExec
clientId	معرف العميل ClientExec عندما يكون متاحًا
moduleVersion	تم تثبيت إصدار بوابة MakePay
clientexecVersion	إصدار وقت التشغيل ClientExec عند توفره

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

الفواتير المتكررة

تظل ClientExec مسؤولة عن المنتجات المتكررة وتواريخ التجديد والضرائب وإنشاء الفواتير ورسائل البريد الإلكتروني للعملاء. لا يقوم MakePay بإنشاء جدول اشتراك منفصل في الإصدار 1.

بالنسبة لكل فاتورة متكررة تنشئها ClientExec، تتصرف بوابة MakePay بنفس سلوك الفاتورة لمرة واحدة: فهي تنشئ رابط checkout مستضاف وتنتظر رد الاتصال الموقع قبل وضع علامة على تلك الفاتورة المدفوعة.

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

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

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

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

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

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

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

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

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

إذا تعذر بدء تشغيل Connect MakePay، فتأكد من أن ClientExec URL هو HTTPS عام وأنه تم تحميل المجلد makepay ضمن plugins/gateways. إذا رأى العملاء خطأ checkout، فتأكد من توصيل MakePay وأن الفاتورة غير مدفوعة. إذا لم تحدد عمليات الاسترجاعات الفواتير المدفوعة، فقارن رد الاتصال MakePay URL مع رد الاتصال URL أعلاه وقم بتدوير سر webhook من إعدادات البوابة.