VibeFox TrustPay for PrestaShop

نظرة عامة

تضيف VibeFox TrustPay Gateway مدفوعات البطاقات عبر finby (المعروفة سابقًا باسم TrustPay) إلى PrestaShop. في خطوة الدفع يختار العميل الدفع بالبطاقة، ثم يُنقل إلى صفحة finby الآمنة لدفع البطاقات مع 3-D Secure، فيدفع ببطاقته ويعود إلى متجرك. لا تمرّ بيانات البطاقة عبر موقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد finby الدفع بإشعار موقَّع، لذلك لا تترك المدفوعات التي يتم التخلي عنها أي طلبات غير مدفوعة.

تناسب المتاجر التي تريد قبول البطاقات عبر مشروع finby دون بناء نموذج بطاقة خاص بها على موقعها. تقبل الوحدة مدفوعات البطاقات فقط. لا تتضمن تحويلات بنكية أو وسائل دفع أخرى من finby، ولا أزرار Apple Pay أو Google Pay على موقعك، ولا بطاقات محفوظة، ولا اشتراكات، ولا تفويضًا وتحصيلًا منفصلين، ولا استطلاعًا دوريًا للحالة.

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

صفحة دفع finby: يُنشأ طلب دفع بالبطاقة بقيمة إجمالي سلة التسوق وبعملة السلة (EUR أو CZK أو HUF أو GBP أو PLN أو NOK أو SEK أو DKK أو BGN أو RON أو CHF أو USD). تُفتح صفحة الدفع بلغة المتجر إذا كانت finby تدعمها، وإلا فبالإنجليزية.

لا يُعتمد الدفع إلا بعد تأكيد finby: يُنشأ الطلب بناءً على إشعار موقَّع من خادم finby إلى خادم المتجر. عودة العميل لا تعلّم الدفعة كمدفوعة أبدًا.

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

منع المعالجة المزدوجة: لا تُنشئ الإشعارات المتكررة طلبًا ثانيًا ولا تسجّل الدفعة مرتين. ولا يُعامَل الدفع الثاني لطلب مدفوع إلا بوصفه ملاحظة فقط.

مشاريع الاختبار والإنتاج: معرّف Project ID ومفتاح Secret key منفصلان لمشروع الاختبار (playground) ولمشروع الإنتاج. لا يؤكد الدفع التجريبي أي دفعة حقيقية، وتُنفَّذ الاستردادات دائمًا على المشروع الذي دُفع من خلاله الطلب.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي في كتلة TrustPay / finby payment، حتى المبلغ الذي دفعه العميل فعلًا. الاسترداد الكامل يضع الطلب في حالة Refunded.

حالة الطلب التي تختارها: Payment accepted أو Delivered بعد نجاح الدفع، وتُعيَّن بخطوة واحدة.

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

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب finby (TrustPay) يحتوي على مشروع مع Project ID وSecret key الخاصين به، ومشروع اختبار (playground) للمدفوعات التجريبية. يجب أن يكون عنوان URL للإشعارات في متجرك متاحًا من الإنترنت. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).