البوابة Wix Velo

ملخص

يستخدم MakePay لـ Wix البرنامج الإضافي لخدمة موفر الدفع Wix Velo. يضيف التاجر أربعة ملفات MakePay JavaScript إلى محرر Wix، ويقوم بتثبيت crypto-js، ويربط مزود الدفع في الإعدادات > قبول المدفوعات، ويخزن أسرار API في Wix Secrets Manager.

في checkout، يتصل Wix بـ createTransaction(). يقوم ملف الواجهة الخلفية MakePay بإنشاء رابط دفع MakePay مستضاف ويعيد إعادة التوجيه URL إلى Wix. عندما يؤكد MakePay الدفع، يستدعي webhook الدالة Wix HTTP ويسجل الرمز الدفع على أمر Wix.

قبل أن تبدأ

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

• متجر Wix مع تمكين وضع المطور
• إذن لتحرير ملفات الواجهة الخلفية Velo ومكونات الخدمة الإضافية
• إذن لاستخدام مدير الأسرار Wix
• شركة MakeCrypto مع تكوين تسوية MakePay
• مفتاح MakePay API مع إمكانية الوصول للكتابة لرابط الدفع
• سر MakePay webhook للشركة

قم بإنشاء بيانات اعتماد MakePay

في MakeCrypto:

1. حدد الشركة التي يجب أن تتلقى دفعات Wix.
2. افتح المحفظة > الأرصدة وقم بتكوين التسوية.
3. افتح عمليات التكامل > عمليات التكامل API وقم بإنشاء مفتاح API.
4. أعط المفتاح على الأقل:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. انسخ معرف الشركة ومعرف مفتاح API وسر المفتاح API.
6. افتح التاجر > إعدادات الدفع وقم بتدوير أو نسخ سر webhook.

تتم إضافة سر المفتاح API وسر webhook إلى Wix Secrets Manager، وليس إلى كود الواجهة الأمامية.

إضافة ملفات Wix Velo

افتح مستودع المصدر MakePay Wix:

https://github.com/makecryptoio/makepay-wix

يتم الاحتفاظ بنفس المصدر في هذا monorepo تحت apps/plugins/wix.

في Wix:

1. افتح محرر الموقع وقم بتمكين وضع التطوير.
2. ضمن عامة وخلفية > الخلفية، أنشئ:
   • MakePay.js
   • http-functions.js
3. ضمن مكونات الخدمة الإضافية، أنشئ مكونًا إضافيًا الدفع باسمه MakePayPayment.
4. ينسخ:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. قم بتثبيت حزمة crypto-js npm من الحزم والتطبيقات.
6. نشر الموقع.

أضف أسرار Wix

افتح أدوات المطورين > مدير الأسرار وأضف:

الاسم السري	القيمة
makepay_api_key_secret	سر مفتاح MakePay API
makepay_webhook_secret	سر MakePay webhook

لا تلصق هذه القيم في رمز الصفحة أو ملفات الواجهة الأمامية العامة.

قم بتوصيل MakePay في Wix

افتح الإعدادات > قبول المدفوعات في لوحة معلومات Wix وقم بتوصيل مزود الدفع MakePay المخصص.

يدخل:

المجال	القيمة
معرف الشركة MakePay	معرف الشركة MakeCrypto
** MakePay API معرف المفتاح **	معرف مفتاح MakePay API
عملة التسوية	عادة USDT

عنوان طريقة الدفع checkout هو:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

قم بتكوين webhooks

نقطة نهاية الدالة Wix HTTP هي:

https://your-wix-domain.com/_functions/makepay_notify

في MakeCrypto، افتح التاجر > إعدادات الدفع وقم بتعيين رد الاتصال MakePay URL على نقطة النهاية هذه. يجب أن يتطابق سر webhook في Wix Secrets Manager مع سر MakePay webhook.

يتحقق معالج Wix webhook من رأس X-MakePay-Signature قبل وضع علامة على أي طلب على أنه مدفوع.

اختبار checkout

1. أضف منتجًا منخفض القيمة إلى عربة التسوق Wix.
2. انتقل إلى checkout.
3. اختر طريقة الدفع بالتشفير MakePay.
4. انقر ** تقديم الطلب والدفع **.
5. تأكد من أن Wix يعيد التوجيه إلى MakePay checkout المستضاف.
6. أكمل الدفع التجريبي.
7. تأكد من وضع علامة على طلب Wix بأنه مدفوع بعد استلام webhook.
8. حدد عمليات التكامل > طلبات Webhook في MakeCrypto إذا كان الطلب كذلك لا تحديث.

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

يستخدم تكامل Wix مصادقة مفتاح API لأن ملفات موفر الدفع Velo المنسوخة من التاجر لا تدعم التدفق التلقائي Connect MakePay حتى الآن.

احتفظ بهذه القواعد:

• قم بتخزين الأسرار فقط في Wix Secrets Manager.
• استخدم مفتاح MakePay الخاص بـ API، وليس مفتاحًا داخليًا واسع النطاق.
• لا تمنح نطاقات إدارة المفاتيح أو إرسال المحفظة أو API.
• قم بتدوير مفتاح API وسر webhook إذا كان أي شخص لديه حق الوصول إلى محرر Wix القديم لم تعد إدارة المدفوعات.
• احتفظ بالرد URL HTTPS وعامة.

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

إذا لم يظهر الموفر في قبول الدفعات، فتأكد من أن مكون الخدمة الإضافي يسمى MakePayPayment، وأن ملفي المكون الإضافي موجودان، وتم نشر الموقع بعد إضافة الكود.

إذا فشل الاتصال، فتأكد من وجود makepay_api_key_secret في Wix Secrets Manager وأن معرف مفتاح API يتطابق مع نفس شركة MakeCrypto.

إذا لم يقوم checkout بإعادة التوجيه، فافحص سجلات Wix Velo بحثًا عن خطأ createTransaction وتأكد من أن مفتاح API يحتوي على makepay:payment-links:write.

إذا لم يتم تحديث الطلبات، فتأكد من رد الاتصال MakeCrypto URL هو https://your-wix-domain.com/_functions/makepay_notify، والتطابقات السرية webhook، وتعرض سجلات التسليم MakeCrypto webhook استجابة 2xx.