VibeFox SimplePay for PrestaShop

نظرة عامة

تضيف VibeFox SimplePay Gateway مدفوعات البطاقات عبر SimplePay، خدمة الدفع المجرية، إلى PrestaShop. وتتصل بواجهة SimplePay البرمجية (API) الإصدار v2. في خطوة الدفع، يختار العميل SimplePay، ثم يُنقل إلى صفحة الدفع الخاصة بـ SimplePay، فيدفع بالبطاقة ثم يعود إلى متجرك. لا تمر بيانات البطاقة عبر موقعك أبدًا. ولا يُنشأ الطلب إلا بعد أن تؤكد SimplePay الدفع، لذلك لا تترك المدفوعات المتروكة أي طلبات غير مدفوعة.

وهي مناسبة للمتاجر التي تبيع بعملة HUF أو EUR أو USD ولديها حسابات تاجر في SimplePay. تقبل الوحدة مدفوعات البطاقات لمرة واحدة فقط. لا تتضمن البطاقات المحفوظة أو الدفع بنقرة واحدة، ولا الاشتراكات أو المدفوعات المتكررة، ولا التفويض والتحصيل المنفصلان، ولا تُزامَن تلقائيًا الاستردادات التي تُجرى من لوحة تاجر SimplePay.

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

حساب واحد لكل عملة: MERCHANT وSECRET KEY لعملات HUF وEUR وUSD، في بيئتي الإنتاج والاختبار (sandbox). تُعرض طريقة الدفع فقط لعملة سلة التسوق التي لها حساب في الوضع الحالي. وتُرسل مبالغ HUF كفورنت صحيحة.

الدفع يُعتمد فقط عند تأكيد SimplePay: يُنشأ الطلب بعد وصول إشعار IPN الموقَّع من SimplePay، أو بعد طلب حالة موقَّع عندما يعود العميل بنتيجة ناجحة. ولا تكفي عودة العميل وحدها لاعتماد الدفع.

طلبات موقَّعة: كل طلب يُرسل إلى SimplePay يُوقَّع، وتُتحقَّق ردود SimplePay. وتُرفض إشعارات IPN ذات التوقيع غير الصالح.

التحقق من المبلغ والعملة: إذا تغيّرت سلة التسوق بعد بدء الدفع، ينتقل الطلب إلى حالة SimplePay payment on hold مع ملاحظة، بدلًا من تعليمه كمدفوع.

لا معالجة مزدوجة: لا تُنشئ إشعارات IPN والعودة المتكررة أو المتزامنة طلبًا ثانيًا أبدًا. ويحصل كل محاولة على مرجع SimplePay خاص بها، وتظل المدفوعات المتأخرة لمحاولة أقدم معترفًا بها.

الاستردادات من صفحة الطلب: استرداد كامل أو جزئي في كتلة SimplePay payment الخاصة بالطلب، دائمًا عبر حساب التاجر والوضع (الاختبار أو الإنتاج) اللذين تمت بهما عملية الدفع. ويُعيّن الاسترداد الكامل الطلب إلى Refunded.

الرسائل التي يطلبها SimplePay: معرّف معاملة SimplePay في صفحة تأكيد الطلب، ونصوص SimplePay للمدفوعات الفاشلة والملغاة والمنتهية المهلة عند الدفع.

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

المتطلبات

PrestaShop 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حسابات تاجر SimplePay (MERCHANT وSECRET KEY) للعملات التي تبيع بها: HUF أو EUR أو USD. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).