VibeFox Transbank for PrestaShop

نظرة عامة

تضيف وحدة VibeFox Transbank Gateway مدفوعات Transbank Webpay Plus إلى PrestaShop للمتاجر في تشيلي. في خطوة الدفع يختار العميل Webpay Plus، ويُنقل إلى نموذج الدفع الخاص بـ Webpay، فيدفع ببطاقة ائتمانية أو بطاقة خصم أو بطاقة مدفوعة مسبقًا، ثم يعود إلى متجرك. لا تمر بيانات البطاقة عبر موقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد Transbank الدفع، لذلك لا تترك المدفوعات الملغاة أو المرفوضة طلبات غير مدفوعة.

تناسب المتاجر التي تبيع بالبيزو التشيلي (CLP) ولديها رمز تجارة قياسي لـ Webpay Plus. ليس لدى Transbank webhook للدفع: يُؤكَّد الدفع من خادم إلى خادم عندما يعود العميل من Webpay. لا تدعم الوحدة Webpay Plus Mall أو البطاقات المحفوظة في Oneclick أو الاشتراكات أو التحصيل المؤجل أو تحويل العملات، ولا تُستورَد الاستردادات التي تُجرى في بوابة Transbank.

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

التوجيه إلى Webpay Plus: تُنشأ معاملة Transbank بإجمالي السلة بالبيزو الصحيح، ويدفع العميل في نموذج Webpay.

يُعتمد الدفع فقط عند تأكيد Transbank: عند العودة تؤكد الوحدة المعاملة مع Transbank (commit). لا يُنشأ الطلب إلا عندما توافق Transbank على المعاملة. وإذا لم يتطابق المبلغ أو رقم الطلب (buy order) أو الجلسة مع ما أرسله المتجر، يُنقل الطلب إلى Transbank payment on hold للمراجعة.

لا خصم عند تغيّر السلة: إذا تغيّر إجمالي السلة بعد بدء الدفع (في تبويب آخر، أو انتهت صلاحية قسيمة)، لا تُؤكَّد المعاملة، فلا يُخصم من العميل شيء ويدفع الإجمالي الجديد.

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

آمن عند الأخطاء: إذا فشل طلب التأكيد، تسأل الوحدة Transbank عن الحالة الفعلية للمعاملة قبل إنشاء الطلب.

الاستردادات من صفحة الطلب: استرداد كامل أو جزئي بالبيزو الصحيح في كتلة Transbank Webpay Plus الخاصة بالطلب، ودائمًا في البيئة التي تمّ فيها الدفع. يضبط الاسترداد الكامل حالة الطلب على Refunded.

الاختبار دون بيانات اعتماد: تستخدم بيئة التكامل رمز التجارة العام للاختبار الخاص بـ Transbank تلقائيًا.

كتلة الطلب والسجل: الدفعة، وكل محاولات Webpay للسلة، وملاحظات Transbank في صفحة الطلب. تُسجَّل الأخطاء دائمًا، وتُعرض التفاصيل عند الطلب، دون بيانات البطاقة أو المفاتيح.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. عملة السلة: البيزو التشيلي (CLP). للمدفوعات الفعلية، تحتاج إلى رمز تجارة الإنتاج لـ Webpay Plus (Commerce Code) وAPI Key Secret من Transbank. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).