VibeFox HyperPay for PrestaShop

نظرة عامة

تضيف VibeFox HyperPay Payment Gateway مدفوعات البطاقات عبر أداة COPYandPAY من HyperPay إلى PrestaShop. بعد تأكيد الطلب في الدفع، يرى العميل أداة الدفع من HyperPay في صفحة دفع في متجرك، ويدفع هناك باستخدام VISA أو Mastercard أو mada أو American Express أو STC Pay أو Apple Pay. تُدخَل بيانات البطاقة في أداة HyperPay فقط، ولا تصل إلى خادمك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد HyperPay الدفع، لذلك لا تترك المدفوعات المتروكة أو المرفوضة طلبات غير مدفوعة.

تناسب هذه الوحدة المتاجر في المملكة العربية السعودية والإمارات العربية المتحدة والأردن والبحرين وعُمان وقطر ومصر وغيرها من أسواق الشرق الأوسط وشمال أفريقيا (MENA) التي لديها حساب تاجر لدى HyperPay. لا تدعم الوحدة الاستردادات أو الإلغاءات من PrestaShop (نفّذها من لوحة تحكم HyperPay)، ولا البطاقات المحفوظة، ولا الاشتراكات، ولا التحقق من نطاق Apple Pay، ولا Entity ID منفصلًا لكل علامة تجارية، ولا طرق الدفع الآجل (buy now, pay later).

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

أداة HyperPay: أداة COPYandPAY في صفحة الدفع، وتُحمَّل مع Subresource Integrity، وباللغة التي يستخدمها العميل عندما تدعمها HyperPay. تختار العلامات التجارية التي تعرضها.

لا يُعتمد الدفع إلا عند تأكيد HyperPay: عبر طلب حالة من الخادم إلى الخادم عند عودة العميل، وعبر webhooks مشفّرة (AES-256-GCM) عند إغلاق المتصفح. ولا ينشئ عنوان الإرجاع وحده طلبًا مدفوعًا أبدًا.

التحقق مقابل السلة: يجب أن ينتمي الدفع إلى إحدى جلسات الدفع في HyperPay الخاصة بهذه السلة، ويجب أن يطابق المبلغ والعملة. وعند عدم التطابق ينتقل الطلب إلى HyperPay payment on hold مع ملاحظة.

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

خصم فوري أو تفويض مسبق: خصم المبلغ فورًا، أو حجزه وتحصيله لاحقًا عبر Capture payment في كتلة HyperPay الخاصة بالطلب.

اختبار وإنتاج: Access Token وEntity ID ومفتاح webhook منفصلة لكل وضع. تُنفَّذ فحوصات الحالة والتحصيلات والـ webhooks دائمًا في الوضع الذي أُنشئت فيه جلسة الدفع.

رسائل واضحة: تُشرح للعميل في الدفع المدفوعاتُ المرفوضة أو غير المكتملة أو غير المؤكدة بعد، وتُحفَظ السلة لمحاولة أخرى.

كتلة HyperPay في صفحة الطلب: معرّف الدفع، وجلسة الدفع، والمبلغ، والنتيجة، وزر التحصيل. يُسجَّل في السجل دون بيانات البطاقة أو المفاتيح أو بيانات العميل.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث مع إضافة OpenSSL. حساب تاجر لدى HyperPay مع Access Token وEntity ID (للاختبار وللإنتاج)، وwebhook للمدفوعات مع مفتاح فك التشفير الخاص به. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).