VibeFox TrustPay for OpenCart

نظرة عامة

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

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

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

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

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

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

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

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

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

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

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

المتطلبات

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