VibeFox Datatrans for PrestaShop

نظرة عامة

تضيف VibeFox Datatrans Gateway إلى PrestaShop المدفوعات عبر Datatrans، مزوّد خدمات الدفع السويسري. في خطوة الدفع يختار العميل Datatrans، ثم يُحوَّل إلى صفحة الدفع الخاصة بـ Datatrans، ويدفع بالبطاقة أو TWINT أو PostFinance أو أي طريقة أخرى مفعّلة في حسابك لدى Datatrans، ثم يعود إلى متجرك. لا تمر بيانات البطاقة بموقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد Datatrans الدفع، لذلك لا تترك المدفوعات التي يُتخلى عنها أي طلبات غير مدفوعة.

تناسب المتاجر التي لديها حساب تاجر لدى Datatrans وتريد صفحة دفع مستضافة واستردادات من صفحة الطلب في PrestaShop. تقبل الوحدة المدفوعات لمرة واحدة فقط. لا تتضمن البطاقات المحفوظة أو الأسماء المستعارة (aliases)، ولا الاشتراكات، ولا تكامل Lightbox أو Secure Fields على موقعك، ولا اختيار طرق الدفع من الإعدادات، ولا التحصيل الجزئي لمبلغ مفوَّض.

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

صفحة الدفع في Datatrans: تُنشأ معاملة بإجمالي سلة التسوق وبعملة السلة، وبمبالغ بأصغر وحدة صحيحة، بما في ذلك العملات بلا منازل عشرية مثل JPY وKRW والعملات ذات ثلاث منازل عشرية مثل KWD وBHD.

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

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

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

بيئة الاختبار (sandbox) والإنتاج: بيانات اعتماد منفصلة لكل بيئة. تذهب الاستردادات والتحصيل دائمًا إلى البيئة التي تم فيها الدفع.

الاستردادات من صفحة الطلب: استرداد كامل أو جزئي من قسم Datatrans payment في الطلب، مع حماية من الإضافة إلى الرصيد مرتين عند إعادة المحاولة. يضبط الاسترداد الكامل حالة الطلب على Refunded.

التفويض الآن والتحصيل لاحقًا: اختياري. يبقى الطلب في حالة Datatrans payment on hold إلى أن تحصّل الدفعة أو تلغيها من قسم الطلب.

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

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب تاجر لدى Datatrans مع Merchant ID وكلمة مرور API من خادم إلى خادم ومفتاح توقيع HMAC (يُنصح به). ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).