وحدة دفع تُثبّت على خادم Magento
توجّه MagicPay عميل Magento إلى صفحة مستضافة لإدخال البطاقة وتتولى توجيه العملية إلى نقطة البيع POS. ينفذ التثبيت مطور لديه وصول إلى الخادم. اطلب الحزمة عبر طلب عرض توضيحي أو قناة التواصل واحتفظ بالإعدادات الحالية قبل البدء.
الإصدارات الموثقة لهذه الحزمة هي Magento 2.4.7 و2.4.8 مع PHP 8.2 أو 8.3. تخضع تبعية Magento framework للقيد ~103.0.7. طابق هذه المتطلبات مع تبعيات الخادم الفعلية؛ ارتفاع رقم الإصدار وحده لا يثبت الملاءمة. ابدأ في بيئة اختبار.
وضع الملفات وتنفيذ تسلسل الإعداد
افحص بنية المجلدات بعد فك الضغط. قد يؤدي وجود مجلد إضافي إلى وضع الوحدة خارج المسار المتوقع. تُنفذ خطوات الإعداد من المجلد الرئيسي لـ Magento مع مراعاة وضع تشغيل المتجر.
- فك الحزمة داخل app/code/MagicPay/Checkout وتأكد من وجود registration.php مباشرة في هذا المجلد.
- نفّذ بالترتيب bin/magento module:enable MagicPay_Checkout ثم bin/magento setup:upgrade ثم bin/magento setup:di:compile.
- في وضع production، أكمل نشر المحتوى الثابت الموضح في دليل التثبيت قبل bin/magento cache:flush.
- افتح Stores > Configuration > Sales > Payment Methods. أدخل API key وSecret key في MagicPay، واضبط Enabled على Yes، وأبقِ Test mode مفعلاً ثم اضغط Save Config.
ربط نطاق الموقع بنتيجة الدفع
احصل على المفاتيح من Ayarlar > API Yetki Yönetimi في MagicPay ولا تشارك المفتاح السري. يمكنك إدخال المفاتيح على مستوى website. اختر الموقع المقابل أيضاً في Stores > Settings > Virtual POS. يصل رابط Manage banks إلى الشاشة نفسها. يجب وجود نقطة بيع نشطة في الحساب.
أنشئ طلب الاختبار من الموقع الذي أعددته. ادفع ببطاقة اختبار وقارن طلب Magento بالعملية في MagicPay. يتطلب وصول الإشعار إتاحة المتجر عبر HTTPS؛ وترسل الوحدة عنوان الإشعار تلقائياً. نجاح الاختبار في موقع واحد لا يثبت عمل المواقع الأخرى.
التشغيل والتحديث حسب نطاق الموقع
لا تتجاوز الرصيد المتبقي القابل للاسترداد عند اختبار الاسترداد الكامل أو الجزئي. راجع الدفع الناجح والمرفوض وعودة العميل وحالة الطلب. عطّل الوضع التجريبي في نطاق الموقع المقصود، وأدخل المفاتيح الفعلية ثم اضغط Save Config.
للتحديث، فك الحزمة الجديدة في المجلد نفسه وكرر خطوات التفعيل والترقية والتجميع وتفريغ الذاكرة المؤقتة. أدرج نشر المحتوى الثابت في وضع production. أعد فحص طلبات الموقع المتأثر بعد كل تغيير.