VibeFox Moyasar for OpenCart

نظرة عامة

تضيف VibeFox Moyasar Payment Gateway المدفوعات عبر صفحة الدفع المستضافة لدى Moyasar إلى OpenCart 3 و OpenCart 4. في الخطوة الأخيرة من الدفع، ينقر العميل على Confirm Order، فيُنقل إلى صفحة دفع Moyasar خاصة بالطلب، ويدفع باستخدام mada أو Visa أو Mastercard أو Apple Pay أو STC Pay أو أي طريقة أخرى مفعّلة في حسابك لدى Moyasar، ثم يعود إلى متجرك. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Moyasar الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

وهي مناسبة للمتاجر في المملكة العربية السعودية ودول مجلس التعاون الخليجي التي تريد قبول المدفوعات المحلية والدولية عبر حساب Moyasar. تقبل الإضافة المدفوعات لمرة واحدة فقط. لا توجد في عملية الدفع الخاصة بمتجرك نماذج لبطاقات، ولا بطاقات محفوظة، ولا اشتراكات، ولا فصل بين التفويض والتحصيل. الطرق التي تظهر في صفحة Moyasar تُضبط في حسابك لدى Moyasar، وليس في الإضافة.

الميزات الرئيسية

صفحة دفع Moyasar: تُنشأ فاتورة بإجمالي الطلب بعملة الطلب: SAR أو AED أو USD أو EUR أو KWD أو BHD أو OMR. تُحوَّل العملات ذات الثلاث منازل عشرية إلى الفلس بشكل صحيح.

مدفوع فقط عند تأكيد Moyasar: تقرأ الإضافة الفاتورة من واجهة Moyasar البرمجية باستخدام مفتاحك السري قبل ضبط حالة الطلب. يُتحقق بالطريقة نفسها من عودة العميل، وإشعار الفاتورة، والـ webhook الاختياري. ثم يرسل OpenCart رسائل الطلب المعتادة.

التحقق من المبلغ والعملة: تُقارن المبالغ والعملة المدفوعة بالطلب. وعند وجود اختلاف، يُنقل الطلب إلى حالة مراجعة مع ملاحظة.

لا معالجة مزدوجة: تُطبَّق كل دفعة مرة واحدة فقط، حتى عندما تصل التأكيدات معًا. وتعيد المحاولة الجديدة استخدام صفحة الدفع المفتوحة للسلة أو تلغيها، فلا يمكن دفعها مرتين.

وضعا الاختبار والتشغيل: مفاتيح سرية منفصلة لكل وضع. تُتحقق كل دفعة وتُسترد باستخدام مفتاح الوضع الذي أُجريت فيه.

الاستردادات من صفحة الطلب: استرداد كامل وجزئي في تبويب VibeFox Moyasar Payment Gateway الخاص بالطلب، حتى المبلغ الذي حصّلته Moyasar. يُرسل الاسترداد الكامل لدفعة بطاقة تمت خلال ساعتين كإلغاء (void). وتُسجَّل الاستردادات التي تُجرى من لوحة تحكم Moyasar كملاحظات على الطلب.

حالات الطلب الخاصة بك: اختر حالة OpenCart للطلب المدفوع، ولدفعة تراجعها Moyasar، ولدفعة معلّقة، ولخطأ في الدفع، ولاسترداد كامل.

شروط OpenCart: المنطقة الجغرافية، والحد الأدنى لإجمالي الطلب، وترتيب العرض. سجل بلا مفاتيح أو بيانات بطاقات أو تفاصيل عملاء.

المتطلبات

OpenCart 3.0.x (تم اختباره على 3.0.5.0) أو OpenCart 4.0.2 وما بعده (تم اختباره على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي ملف التنزيل الواحد على الحزم الخاصة بالإصدارين. حساب Moyasar مع مفاتيح API سرية؛ يُنصح بإعداد webhook في لوحة تحكم Moyasar. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).