مصمم لمتجرك

اربط طلبات nopCommerce بمدفوعات MagicPay

اربط nopCommerce بنقاط البيع عبر MagicPay، مع إدخال البطاقة في صفحة مستضافة وعمليات دفع واسترداد مرتبطة بطلبات متجرك.

  • اتصال واحد بنقاط البيع
  • إدخال البطاقة لدى MagicPay
  • عمليات الطلبات والاسترداد

دفع بالبطاقة عبر صفحة MagicPay

توجّه إضافة MagicPay عميل nopCommerce من صفحة إتمام الطلب إلى صفحة دفع تستضيفها MagicPay. يُدخل العميل بيانات البطاقة هناك، وتتولى MagicPay توجيه العملية إلى نقطة البيع POS. الحزمة مخصصة لبيئة nopCommerce 4.90 و.NET 9. اطلبها عبر طلب عرض توضيحي أو قناة التواصل واحتفظ بإعدادات الدفع الحالية.

تثبيت الإضافة المحلية وتفعيل وسيلة الدفع عمليتان منفصلتان. يتطلب التثبيت أيضاً إعادة تشغيل التطبيق. اختر وقتاً مناسباً لهذا الانقطاع وتأكد من عودة الوصول إلى الإدارة بعده. ابدأ فحص المدفوعات في بيئة اختبار.

تثبيت الإضافة وإعادة تشغيل التطبيق

احصل على API key وSecret key التجريبيين من Ayarlar > API Yetki Yönetimi في MagicPay. لا تشارك المفتاح السري. أكمل إعادة التشغيل بعد التثبيت، ثم انتقل إلى إعداد وسيلة الدفع عندما يعمل التطبيق مجدداً.

  1. افتح Configuration > Local plugins، واختر Upload plugin or theme ثم حزمة nopCommerce التي تسلمتها.
  2. اضغط Install بجانب MagicPay، ثم استخدم Restart application to apply changes.
  3. بعد عودة التطبيق، افتح Configuration > Payment methods. حدد Is active أمام MagicPay ثم افتح Configure.
  4. أدخل API key وSecret key، وأبقِ Test mode مفعلاً ثم احفظ. تحقق مجدداً من تفعيل وسيلة الدفع.

فحص وسيلة الدفع ونتيجة الطلب

يعرض تبويب Sanal POS في إعدادات MagicPay سجلات نقاط البيع للحساب. يجب أن تكون واحدة منها نشطة على الأقل. لا تختار البنك لكل طلب من هذا التبويب؛ تتولى MagicPay التوجيه. فرّق عند مراجعة شاشات الإدارة بين إضافة مثبتة ووسيلة دفع نشطة.

أضف منتجاً إلى السلة واستخدم بطاقة اختبار في صفحة MagicPay. قارن حالة دفع طلب nopCommerce بالعملية في لوحة MagicPay. إذا غابت النتيجة، افحص إتاحة المتجر عبر HTTPS. ترسل الإضافة عنوان الإشعار مع طلب الدفع، دون إعداد منفصل في اللوحة. تحقق أيضاً من بقاء الطلب غير مدفوع بعد محاولة مرفوضة.

إعداد التشغيل الفعلي والتحديثات اللاحقة

عند اختبار الاسترداد الكامل أو الجزئي، راعِ العمليات السابقة ولا تتجاوز الرصيد المتبقي القابل للاسترداد. راجع مبلغ الطلب ونتيجة الدفع وعودة العميل. بعد اكتمال الفحص، عطّل الوضع التجريبي في Configure، وأدخل المفاتيح الفعلية واحفظ.

للتحديث، ارفع الحزمة الجديدة عبر Upload plugin or theme وأعد تشغيل التطبيق. تحقق من نشاط وسيلة الدفع وبيئة التشغيل المحددة، ثم راجع رحلة دفع الطلب مجدداً. ظهور الإضافة في القائمة وحده لا يثبت وصول نتيجة الدفع إلى الطلب.

الأسئلة الشائعة

متى أعيد تشغيل التطبيق؟

بعد الضغط على Install في Local plugins، استخدم Restart application to apply changes. اضبط وسيلة الدفع بعد عودة التطبيق.

أين أفعّل وسيلة الدفع؟

حدد Is active أمام MagicPay في Configuration > Payment methods، ثم احفظ المفاتيح ووضع التشغيل في Configure.

كيف أحدّث الحزمة؟

ارفع الحزمة الجديدة عبر Upload plugin or theme وأعد تشغيل التطبيق، ثم افحص وسيلة الدفع والإعدادات ورحلة الطلب.