VibeFox Moyasar for PrestaShop

نظرة عامة

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

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

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

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

لا يُعتمد الدفع إلا بعد تأكيد Moyasar: تقرأ الوحدة الفاتورة من واجهة Moyasar البرمجية باستخدام مفتاحك السري قبل إنشاء الطلب. وتُفحص عودة العميل وإشعار الفاتورة و webhook الاختياري بالطريقة نفسها.

التحقق من المبلغ والعملة: يُقارَن المبلغ والعملة المدفوعان بالسلة. وإذا لم يتطابقا، ينتقل الطلب إلى Moyasar payment on hold مع ملاحظة.

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

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

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

حالة الطلب التي تختارها: Payment accepted أو Delivered أو Moyasar payment on hold بعد الدفع الناجح، في تغيير حالة واحد.

كتلة Moyasar في صفحة الطلب: الفاتورة، والدفعة، والبطاقة، وسجل الاستردادات، وملاحظات الوحدة. ولا يتضمن السجل المفاتيح أو بيانات البطاقات أو بيانات العملاء.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب Moyasar بمفاتيح API سرية؛ ويُنصح بإعداد webhook في Moyasar Dashboard. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).