MakePay Blesta البوابة

تتيح بوابة MakePay Blesta الرسمية للعملاء دفع فواتير Blesta من خلال التشفير المستضاف checkout. يقوم Blesta بإنشاء الفاتورة وامتلاكها. يقوم MakePay بإنشاء رابط checkout ويرسل تحديثات الدفع مرة أخرى إلى Blesta.

تبقى الفواتير المتكررة داخل Blesta. عندما تقوم Blesta بإنشاء فاتورة تجديد، تتعامل البوابة معها مثل أي دفعة فاتورة أخرى.

قبل أن تبدأ

أنت بحاجة إلى:

• Blesta 5.x أو الأحدث
• تثبيت HTTPS Blesta
• وصول المسؤول إلى بوابات الدفع Blesta
• تم تكوين تسوية MakePay والعلامة التجارية

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

تنزيل الحزمة الأحدث:

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

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

Blesta/components/gateways/nonmerchant/makepay

في Blesta، افتح الإعدادات > بوابات الدفع، واختر متاح، وابحث عن MakePay، وقم بتثبيته كبوابة غير تجارية.

قم بتوصيل MakePay

افتح إعدادات بوابة MakePay في Blesta وانقر فوق Connect MakePay.

تدفق الاتصال:

1. يفتح صفحة اتصال MakePay.
2. يتيح لك اختيار الشركة التي يجب أن تتلقى المدفوعات.
3. يعيدك إلى Blesta بعد الموافقة.
4. يحفظ اتصال البوابة لتثبيت Blesta.

بعد الاتصال، قم بإنشاء فاتورة تجريبية صغيرة وادفعها من منطقة العميل.

دليل API مفتاح احتياطي

Connect MakePay هو الإعداد الموصى به. يتوفر الإعداد اليدوي لمفتاح API للمتاجر التي لا يمكنها إكمال الاتصال الموجه.

للإعداد اليدوي، اضبط طريقة الاتصال على مفتاح API اليدوي وأدخل:

• معرف الشركة MakePay
• معرف المفتاح API
• API السر الرئيسي
• Webhook سر التوقيع

اجعل رد الاتصال URL الموضح في Blesta قابلاً للوصول من الإنترنت العام.

تدفق الخروج

عندما يختار العميل MakePay لفاتورة Blesta، فإن البوابة:

1. يقرأ مبلغ الفاتورة والعملة ومعرف العميل والبيانات التعريفية للفاتورة.
2. ينشئ رابط دفع مستضاف MakePay.
3. يظهر زر الدفع باستخدام MakePay.
4. يرسل العميل إلى checkout المستضاف.
5. يتلقى رد اتصال موقعًا عندما تتغير حالة الدفع.

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

المجال	الغرض
source=blesta	يحدد التكامل
orderId=blesta_invoice_<invoiceId>	خرائط نشاط MakePay تعود إلى Blesta
invoiceId	معرف الفاتورة الأساسي Blesta
clientId	معرف العميل Blesta عندما يكون متاحًا

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

حالة MakePay	سلوك Blesta
paid، completed، confirmed، succeeded	يسجل معاملة معتمدة
pending، waiting، confirming	يبقي الدفع معلق
failed، expired، cancelled	يسجل دفعة مرفوضة

يظل Blesta مسؤولاً عن تنشيط الخدمة وأتمتة الفوترة المتكررة بعد دفع الفاتورة.

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

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

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

إذا تعذر بدء تشغيل Connect MakePay، فتأكد من أن رد الاتصال Blesta URL عام وتم تثبيت البوابة كبوابة غير تجارية.

إذا لم يتم تحديث الفواتير، فتأكد من إمكانية الوصول إلى رد الاتصال URL الموضح في الإعدادات ومن وجود سر التوقيع webhook.

إذا رأى العملاء خطأ checkout، فتأكد من اتصال MakePay وأن عملة الفاتورة المحددة مدعومة من خلال إعداد MakePay.