وحدة PrestaShop

ملخص

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

تقوم الوحدة بإنشاء رابط دفع MakePay لكل طلب PrestaShop وتستمع إلى MakePay webhooks الموقع بحيث تحدث تغييرات حالة الطلب تلقائيًا.

قبل أن تبدأ

سوف تحتاج إلى:

• PrestaShop 8.0 أو الأحدث، بما في ذلك PrestaShop 9.x
• PHP 7.4 أو أحدث مع تمكين OpenSSL
• المكتب الخلفي HTTPS وcheckout URL
• حساب موظف PrestaShop يمكنه تكوين الوحدات النمطية
• شركة MakeCrypto مع تكوين تسوية MakePay

يوصى باستخدام PHP الصوديوم. عندما يكون متاحًا، تستخدمه الوحدة مع أسرار ملفات تعريف الارتباط PrestaShop لتشفير تفاصيل الاتصال، وأسرار webhook، وبيانات الاعتماد الاحتياطية اليدوية لمفتاح API.

قم بإعداد MakeCrypto

أكمل إعداد التاجر قبل توصيل PrestaShop.

1. قم بتسجيل الدخول على https://www.makecrypto.io ثم اختر الشركة التي يجب أن تتلقى دفعات PrestaShop.
2. افتح المحفظة > الأرصدة، ثم قم بتكوين عملة التسوية والسلسلة و محفظة الوجهة.
3. افتح التاجر > إعدادات الدفع وراجع رسوم الدفع وإعادة التوجيه سلوك.
4. اختياري: افتح الإعدادات > التاجر لإضافة العلامة التجارية للتاجر والدعم البريد الإلكتروني وألوان checkout وموضوع الدفع المستضاف والمجالات المخصصة.

لا تحتاج إلى إنشاء تطبيق مطور يدويًا. تقوم وحدة PrestaShop الرسمية بإنشاء اتصال خاص بالمتجر عند النقر فوق Connect MakePay.

قم بتثبيت الوحدة

قم بتنزيل أحدث وحدة ZIP الرسمية:

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

ثم قم بتثبيته في PrestaShop:

1. افتح المكتب الخلفي > الوحدات النمطية > مدير الوحدة.
2. انقر تحميل وحدة واختر makepay.zip الذي تم تنزيله.
3. بعد التثبيت، انقر فوق تكوين.
4. أبقِ المصادقة مضبوطة على وضع الاتصال الافتراضي.

جذر ZIP هو makepay/ وملف الوحدة الرئيسي هو makepay.php، وهو ما يتوافق مع توقعات تعبئة الوحدة النمطية PrestaShop.

قم بتوصيل متجرك

استخدم Connect MakePay للإعداد العادي. فهو يربط متجر PrestaShop هذا بشركة MakeCrypto التي تختارها ويمكن فصله لاحقًا دون تغيير رمز المتجر.

1. في تكوين الوحدة النمطية MakePay، احتفظ MakePay API بقاعدة URL مضبوطة على https://www.makecrypto.io.
2. انقر الاتصال MakePay.
3. قم بتسجيل الدخول إلى MakeCrypto إذا طُلب منك ذلك، واختر الشركة التي قمت بإعدادها، و الموافقة على الوصول المطلوب.
4. بعد العودة إلى PrestaShop، تأكد من أن الوحدة تظهر المتجر باسم متصل.
5. احفظ إعدادات البوابة وحافظ على تمكين الوحدة.

أثناء الاتصال، تقوم الوحدة تلقائيًا بتسجيل webhook العام URL:

https://your-store.example/module/makepay/webhook

اجعل نقطة النهاية هذه قابلة للوصول من الإنترنت العام. يجب أن تسمح وحدات الأمان وجدران الحماية وقواعد التخزين المؤقت بطلبات POST الموقعة إلى URL.

كيف يعمل الاتصال

يفتح الزر Connect MakePay MakeCrypto في علامة تبويب المتصفح. تقوم بتسجيل الدخول، واختيار الشركة التي يجب أن تتلقى المدفوعات، ومراجعة الوصول المطلوب، والعودة إلى PrestaShop بعد الموافقة. تقوم الوحدة بعد ذلك بحفظ الاتصال، وتسجيل webhook URL، وتحتفظ بالإعدادات منفصلة لكل سياق متجر في عمليات التثبيت متعددة المتاجر.

لا يلزم وجود سر مشترك للتطبيق أو إعداد تطبيق المطور لـ PrestaShop.

إعدادات البوابة

قم بمراجعة هذه الإعدادات في الوحدات > مدير الوحدة > MakePay > التكوين.

الإعداد	ماذا يفعل
ممكن	يقوم بتشغيل أو إيقاف تشغيل طريقة الدفع MakePay على checkout.
المصادقة	استخدم الوضع المتصل الافتراضي لعمليات التثبيت العادية. المفتاح الاحتياطي اليدوي API مخصص للاسترداد الذي يقوده الدعم.
اسم طريقة الدفع	الاسم الذي يراه العملاء في checkout، على سبيل المثال Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others.
** تجربة الخروج **	استخدم إعادة التوجيه المستضاف للحصول على التدفق الأكثر موثوقية، أو صفحة checkout المضمنة لإظهار MakePay في صفحة iframe آمنة مع رابط احتياطي مستضاف.
عملة التسوية	أصل MakePay المفضل مثل USDT. يقوم MakePay بحل السلسلة من إعدادات الشركة حيثما أمكن ذلك.
انتهاء الدفع	مدى الحياة المستضاف لـ checkout، على سبيل المثال 30m أو 2h أو 12h.
MakePay API قاعدة URL	استخدم https://www.makecrypto.io للإنتاج.
**معرف الشركة / API معرف المفتاح / API سر المفتاح **	مطلوب فقط للرجوع اليدوي لمفتاح API.
Webhook سر	يتم ضبطه تلقائيًا أثناء الاتصال. أدخل يدويًا فقط للوضع الاحتياطي.

دول النظام

في checkout، تقوم الوحدة بإنشاء أمر PrestaShop في الحالة المخصصة في انتظار دفع MakePay وتفتح تجربة MakePay checkout المحددة.

تعيين حالة Webhook:

حالة MakePay	حالة PrestaShop
paid، completed، confirmed، succeeded	تم قبول الدفع
refunded، refund	مستردة
failed، expired، chargeback	خطأ في الدفع
cancelled، canceled	تم الإلغاء
حالات أخرى قيد التقدم	في انتظار الدفع MakePay

تكتب الوحدة رسائل طلب خاصة مع حالة webhook والدفع UID والمبلغ والأصل والدفع URL عند وجودها في حمولة MakePay webhook.

الأمن والأذونات

طلبات الاتصال PrestaShop:

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

لا يمكنه إرسال أموال المحفظة أو إنشاء مفاتيح API القديمة.

يتم توقيع تحديثات Webhook بواسطة MakePay ويتم التحقق منها قبل أي تغييرات في حالة طلب PrestaShop. يمكن لمسؤولي المتجر إلغاء الاتصال في MakeCrypto ضمن عمليات التكامل > التطبيقات المتصلة، أو قطع الاتصال من صفحة تكوين الوحدة النمطية PrestaShop.

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

استخدم وضع مفتاح API اليدوي فقط إذا كان Connect MakePay غير متاح أو طلب منك دعم MakeCrypto استخدامه.

1. في MakeCrypto، افتح عمليات التكامل > عمليات التكامل API.
2. قم بإنشاء أو اختيار مفتاح MakePay API لنفس الشركة التي تتلقى المتجر المدفوعات.
3. انسخ معرف الشركة ومعرف مفتاح API وسر المفتاح API وسر webhook.
4. في PrestaShop، افتح Modules > Module Manager > MakePay > Configure.
5. اضبط المصادقة على الرجوع اليدوي لمفتاح API.
6. الصق بيانات الاعتماد واحفظها.

احتفظ بأسرار API الأساسية بعيدًا عن ملفات السمات والبرامج النصية من جانب العميل وتذاكر الدعم العامة. لا يزال الاتصال MakePay مفضلاً لتشغيل المتجر العادي.

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

إذا فشل الاتصال بـ MakePay، فتأكد من أن مكتبك الخلفي URL يستخدم HTTPS، ويمكن لمتجرك إرسال طلبات HTTPS الصادرة إلى https://www.makecrypto.io، ويمكن لحساب الموظف تكوين الوحدات النمطية.

إذا لم تظهر طريقة الدفع في checkout، فتأكد من أن الوحدة نشطة، وأن Enabled قيد التشغيل، وأن المتجر متصل بـ MakePay أو لديه بيانات اعتماد مفتاح API اليدوية الصالحة.

إذا أظهر checkout خطأ في التسوية أو الإعداد، فارجع إلى MakeCrypto وأكمل المحفظة > الأرصدة > إعداد التسوية للشركة المتصلة بالمتجر.

إذا لم يتم تحديث الطلبات بعد الدفع، فحدد عمليات التكامل > طلبات Webhook في MakeCrypto لمحاولات التسليم. يجب أن تقوم نقطة النهاية PrestaShop webhook بإرجاع استجابة 2xx. تأكد أيضًا من أن جدران الحماية المستضيفة لا تحظر طلبات POST إلى /module/makepay/webhook.

إذا قمت بتغيير مجال المتجر، أو مجال المكتب الخلفي، أو نقل المتجر إلى بيئة جديدة، فافصل MakePay وأعد توصيله بحيث يتطابق رد اتصال الاتصال وwebhook URLs مع المتجر الحالي.