VibeFox Redsys for PrestaShop

نظرة عامة

تربط VibeFox Redsys Gateway متجر PrestaShop بنقطة البيع الافتراضية (POS) من Redsys (Servired / Sermepa) التي تمنحها معظم البنوك الإسبانية لتجارها. في خطوة الدفع يختار العميل Redsys، فيُوجَّه إلى صفحة الدفع الآمنة لـ Redsys في بنكك، ويدفع بالبطاقة عبر 3-D Secure، أو عبر Bizum أو طريقة أخرى يفعّلها بنكك للجهاز الطرفي، ثم يعود إلى متجرك. لا تمرّ بيانات البطاقة عبر موقعك أبدًا، ولا تترك المدفوعات المتروكة طلباتٍ غير مدفوعة.

يناسب المتاجر في إسبانيا التي تملك حساب تاجر Redsys لدى بنكها. تقبل الوحدة مدفوعات لمرة واحدة يتم تفويضها وتحصيلها فورًا. لا يتضمن نموذج بطاقة على موقعك (InSite)، ولا بطاقات محفوظة أو دفعًا بنقرة واحدة، ولا اشتراكات، ولا تفويضًا مسبقًا مع تحصيل لاحق.

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

صفحة الدفع في Redsys: يرسل نموذج الدفع الموقَّع العميل إلى صفحة Redsys في بنكك بمبلغ السلة الإجمالي، باللغة المستخدمة في السلة.

الدفع يُعتمد فقط عند تأكيد Redsys: لا يُنشأ الطلب إلا بإشعار Redsys الإلكتروني، بعد التحقق من توقيع HMAC-SHA256 ورمز التاجر. العودة إلى المتجر لا تُنشئ الطلب ولا تدفعه وحدها أبدًا.

التحقق من المبلغ والعملة: تُقارَن قيمة الإشعار وعملته بالسلة. عند عدم التطابق ينتقل الطلب إلى Redsys payment on hold مع ملاحظة.

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

وضعا الاختبار والفعلي: مفاتيح سرية منفصلة لبيئة اختبار Redsys (SIS-T) وللبيئة الحقيقية. تتذكر كل دفعة بيئتها، ومن ذلك الاستردادات.

الاستردادات من صفحة الطلب: استرداد كامل أو جزئي في كتلة Redsys payment الخاصة بالطلب، عبر واجهة REST الخاصة بـ Redsys، مع التحقق من توقيع الرد. الاسترداد الكامل يضع الطلب في حالة Refunded.

حالة الطلب التي تختارها: Payment accepted أو Delivered أو Redsys payment on hold للمراجعة اليدوية بعد دفعة ناجحة.

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

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب تاجر Redsys لدى بنكك: رمز التاجر (FUC)، ورقم الجهاز الطرفي، والمفاتيح السرية SHA-256 لبيئتي الاختبار والإنتاج، مع تفعيل الإشعار الإلكتروني (HTTP) للجهاز الطرفي. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).