VibeFox Conekta for OpenCart

نظرة عامة

تضيف VibeFox Conekta Gateway الدفع عبر Conekta (المكسيك) إلى OpenCart 3 وOpenCart 4. في خطوة الدفع الأخيرة ينقر العميل على Confirm Order، فيُنقل إلى صفحة الدفع الآمنة المستضافة لدى Conekta، ثم يدفع ببطاقة ائتمان أو بطاقة خصم، أو نقدًا في OXXO ومتاجر أخرى، أو بتحويل بنكي عبر SPEI، أو عبر BNPL، وذلك حسبما تسمح به. ثم يعود العميل إلى متجرك. لا تمرّ بيانات البطاقة عبر موقعك أبدًا. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Conekta الدفع أو تُصدر مرجع OXXO أو SPEI، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

تناسب هذه الإضافة المتاجر المكسيكية التي تبيع بعملة MXN أو USD وترغب في تقديم الدفع بالبطاقة والدفع النقدي ضمن طريقة دفع واحدة بحساب Conekta. تقبل الإضافة المدفوعات لمرة واحدة فقط. لا توجد نموذج بطاقة في صفحة الدفع لديك، ولا تدعم البطاقات المحفوظة، أو الاشتراكات، أو التفويض المسبق مع التحصيل لاحقًا، أو الأقساط الشهرية (MSI). تُسجَّل الاستردادات أو المطالبات (chargebacks) التي تُجرى في لوحة Conekta على الطلب كملاحظة فقط، ولا تُسجَّل تلقائيًا.

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

صفحة الدفع المستضافة لدى Conekta: يُنشأ طلب في Conekta بإجمالي الطلب وبعملة الطلب، ويتضمن المنتجات والخصومات والضرائب والشحن. تُعرض خيارات النقد وSPEI وBNPL للطلبات بعملة MXN، أما الطلبات بعملة USD فتقبل البطاقات فقط.

لا يُعتمد الدفع إلا بعد تأكيد Conekta: يقتصر دور كل من webhook وعودة العميل على تشغيل قراءة الطلب من واجهة برمجة تطبيقات Conekta باستخدام مفتاحك الخاص. لا يُوثق بأي محتوى في الإشعار أو في عنوان العودة. بعد ذلك يرسل OpenCart رسائل الطلب المعتادة.

التحقق من المبلغ والعملة: تُقارَن قيمة المبلغ بالسنتات والعملة بالطلب. أي اختلاف، أو دفعة في وضع الاختبار تصل والمتجر في وضع الإنتاج، يضع الطلب في حالة الإيقاف المؤقت لديك للمراجعة.

OXXO وSPEI: عندما يحصل العميل على مرجع دفع، ينتقل الطلب إلى حالة انتظار الدفع الخاصة بك، ثم ينتقل إلى حالة مدفوع عندما تُبلغ Conekta بالدفعة.

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

وضعا الاختبار والإنتاج: مفاتيح خاصة منفصلة لكل وضع، وإشعار وضع الاختبار عند الدفع. تستخدم الإشعارات والاستردادات دائمًا مفتاح الوضع الذي تمت فيه الدفعة.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي من علامة التبويب VibeFox Conekta Gateway في الطلب، حتى المبلغ الذي خصمته Conekta فعليًا. يضع الاسترداد الكامل حالة Refunded.

شروط OpenCart: حالات الطلبات الخاصة بك، والمنطقة الجغرافية، والحد الأدنى لإجمالي الطلب، وترتيب الفرز. سجل اختياري بلا مفاتيح API ولا بيانات اتصال العميل.

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 وما بعده (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. عملة الدفع MXN أو USD. حساب Conekta يتضمن مفاتيح خاصة للاختبار والإنتاج، وwebhook في لوحة Conekta. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).