MakePay WISECP البوابة

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

يعد هذا مفيدًا لموفري الاستضافة وفرق SaaS والوكالات وشركات الخدمات التي تقوم بالفعل بتشغيل الفوترة من خلال WISECP.

قبل أن تبدأ

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

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

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

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

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

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

WISECP/coremio/modules/Payment/MakePay

في WISECP، افتح الإعدادات > الفواتير > بوابات الدفع، وابحث عن MakePay، وقم بتمكينه، واحفظ إعدادات الوحدة.

قم بتوصيل MakePay

افتح إعدادات بوابة MakePay في WISECP واستخدم رابط Connect MakePay الموضح في حقل حالة الاتصال.

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

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

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

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

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

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

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

اجعل رد الاتصال URL الذي تم إنشاؤه بواسطة WISECP قابلاً للوصول من الإنترنت العام.

تدفق الخروج

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

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

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

المجال	الغرض
source=wisecp	يحدد التكامل
checkoutId	خرائط نشاط MakePay تعود إلى WISECP checkout
orderId	يستخدم معرف WISECP checkout للبحث عن رد الاتصال

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

حالة MakePay	سلوك WISECP
paid، completed، confirmed، succeeded	يمثل نجاح checkout
pending، waiting، confirming	يبقي checkout معلقًا
failed، expired، cancelled	يضع علامة على checkout كخطأ

تظل WISECP مسؤولة عن تفعيل الخدمة، والتجديدات، وترقيم الفاتورة، وإخطارات العميل بعد دفع الفاتورة.

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

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

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

إذا تعذر بدء تشغيل Connect MakePay، فتأكد من تثبيت البوابة تحت coremio/modules/Payment/MakePay وأن رد الاتصال WISECP URL عام.

إذا لم يتم تحديث الفواتير، فتأكد من وجود سر التوقيع webhook وأن الخادم الخاص بك يمكنه تلقي عمليات الاسترجاعات HTTPS من MakePay.

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