صفحة دفع مستضافة لمتجر PrestaShop
توجّه وحدة MagicPay العميل من خطوة الدفع في PrestaShop إلى صفحة تستضيفها MagicPay. يُدخل العميل بيانات البطاقة هناك، وتتولى MagicPay اختيار نقطة البيع POS المستخدمة. ترتبط وسيلة الدفع في المتجر بنقاط البيع المسجلة في حسابك، الذي يجب أن يحتوي على نقطة نشطة واحدة على الأقل.
يتم التثبيت عبر مدير الوحدات. بعد رفع الحزمة، افتح Configure لإدخال المفاتيح وتفعيل الدفع. احتفظ بالإعدادات الحالية وراجع ملاءمة الحزمة لبيئة المتجر. يمكنك طلب حزمة التثبيت عبر طلب عرض توضيحي أو قناة التواصل.
رفع الوحدة وإدخال بيانات الربط
احصل على API key وSecret key التجريبيين من Ayarlar > API Yetki Yönetimi في لوحة MagicPay. أدخلهما في حقول الإعداد فقط، ولا تضع المفتاح السري في المستندات المشتركة. بعد رفع الوحدة، يجب حفظ إعدادات الدفع بشكل منفصل.
- افتح Modules > Module Manager في إدارة PrestaShop.
- اختر Upload a module واسحب magicpay-prestashop.zip إلى النافذة أو حدد الملف.
- بعد انتهاء التثبيت، اضغط Configure لفتح إعدادات MagicPay.
- أدخل API key وSecret key، وفعّل وسيلة الدفع مع إبقاء Test mode مفعلاً، ثم اضغط Save.
مراجعة إعدادات الوحدة ونتيجة الطلب
يعرض تبويب Sanal POS داخل إعدادات الوحدة سجلات نقاط البيع في حساب MagicPay. لا يُستخدم لاختيار بنك لكل طلب؛ تتولى MagicPay التوجيه. أعد فتح الإعدادات بعد الحفظ للتأكد من تفعيل وسيلة الدفع والوضع التجريبي.
أضف منتجاً إلى السلة ونفّذ دفعة تجريبية. قارن مبلغ طلب PrestaShop وحالته بالعملية في MagicPay. إذا كان متجرك يستخدم TRY أو USD أو EUR، اختبر بالعملة المستخدمة فعلياً. عند غياب النتيجة، افحص إتاحة المتجر عبر HTTPS. تُرفق الوحدة عنوان الإشعار بكل طلب دفع تلقائياً.
مراجعة الدفع والاسترداد قبل الإطلاق
اختبر محاولة مرفوضة إلى جانب الدفع الناجح وعودة العميل. عند اختبار الاسترداد الكامل أو الجزئي، راعِ الاستردادات السابقة ولا تتجاوز الرصيد المتبقي القابل للاسترداد. قارن النتيجة في سجل المتجر ولوحة MagicPay.
ارجع إلى Configure، وعطّل الوضع التجريبي، وأدخل المفاتيح الفعلية ثم احفظ. طابق الطلبات الفعلية الأولى مع عمليات MagicPay. كرر فحص الطلب بعد تغيير القالب أو صفحة إتمام الشراء للتأكد من وصول النتيجة إلى السجل الصحيح.