VibeFox HyperPay for OpenCart

نظرة عامة

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

تناسب الإضافة المتاجر في المملكة العربية السعودية والإمارات العربية المتحدة والأردن والبحرين وعُمان وقطر ومصر وغيرها من أسواق الشرق الأوسط وشمال أفريقيا التي لديها حساب تاجر لدى HyperPay. لا تتيح الإضافة الاسترداد أو الإلغاء من OpenCart (يتم ذلك من لوحة تحكم HyperPay)، ولا تدعم البطاقات المحفوظة أو الاشتراكات أو التحقق من نطاق Apple Pay أو كيانًا منفصلًا لكل علامة تجارية أو وسائل الشراء الآن والدفع لاحقًا.

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

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

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

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

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

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

الاختبار والتشغيل الفعلي: Access Token وEntity ID ومفتاح Webhook منفصلة لكل وضع. تستخدم استعلامات الحالة والتحصيل وWebhooks دائمًا الوضع الذي أُنشئ فيه عملية الدفع.

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

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

المتطلبات

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