من سلة OpenCart إلى صفحة MagicPay
تربط إضافة MagicPay خطوة الدفع في OpenCart بصفحة تستضيفها MagicPay. يُدخل العميل بيانات بطاقته في تلك الصفحة، وتتولى MagicPay اختيار نقطة البيع POS. راجع معلومات الحزمة مقابل بيئة متجرك واحتفظ بإعدادات الدفع الحالية قبل التثبيت. ابدأ في بيئة اختبار حتى تراجع أثر التغيير على صفحة إتمام الطلب.
يفصل OpenCart بين تثبيت الحزمة وتثبيت إضافة الدفع. ظهور MagicPay في قائمة أداة التثبيت لا يعني أن وسيلة الدفع أصبحت جاهزة للعميل. أكمل المرحلتين قبل البحث عن سبب غيابها من صفحة الدفع.
حافظ على اسم الملف وأكمل المرحلتين
اطلب الحزمة عبر طلب عرض توضيحي أو قناة التواصل. يجب أن يبقى اسم الملف magicpay.ocmod.zip. ينشئ OpenCart مجلد الإضافة اعتماداً على هذا الاسم، لذلك قد تؤدي إعادة التسمية إلى تعطيل بنية التثبيت المطلوبة.
- افتح Extensions > Installer، واضغط Upload ثم اختر magicpay.ocmod.zip.
- بعد رفع الملف، اضغط Install في صف MagicPay داخل قائمة أداة التثبيت.
- انتقل إلى Extensions > Extensions، واختر Payments ثم اضغط Install بجانب MagicPay مرة أخرى.
- افتح Edit وأدخل API key وSecret key، وفعّل Status مع إبقاء Test mode مفعلاً، ثم اضغط Save.
راجع المفاتيح والإشعارات وحالة الطلب
احصل على المفاتيح من Ayarlar > API Yetki Yönetimi في لوحة MagicPay. استخدم مفاتيح الاختبار مع الوضع التجريبي ولا تشارك المفتاح السري. يعرض تبويب Sanal POS في إعدادات الإضافة سجلات نقاط البيع للحساب. يجب وجود نقطة نشطة واحدة على الأقل، ولا يُستخدم هذا التبويب لاختيار بنك لكل طلب.
أنشئ طلباً من واجهة المتجر وادفع ببطاقة اختبار على MagicPay. طابق سجل OpenCart مع العملية في لوحة MagicPay. إذا لم تصل النتيجة، افحص الوصول العام عبر HTTPS. ترسل الإضافة عنوان الإشعار ضمن طلب الدفع تلقائياً. راجع أيضاً بقاء الطلب غير مدفوع بعد محاولة مرفوضة.
تحقق من حفظ الإعدادات قبل التشغيل
أعد فتح Edit للتحقق من حفظ Status ووضع التشغيل المقصود. راجع عودة العميل وحالة الطلب معاً. لا تتجاوز الرصيد المتبقي القابل للاسترداد عند اختبار الاسترداد الكامل أو الجزئي.
بعد اكتمال الفحص، عطّل الوضع التجريبي وأدخل المفاتيح الفعلية ثم اضغط Save. قارن الطلبات الفعلية الأولى بسجلات MagicPay. حافظ على اسم الأرشيف الأصلي إذا رفعت الحزمة مجدداً، لأن الاسم يؤثر في بنية التثبيت داخل OpenCart.