VibeFox MercadoPago for OpenCart

نظرة عامة

تضيف VibeFox MercadoPago Gateway إلى OpenCart 3 وOpenCart 4 مدفوعات البطاقات الائتمانية وبطاقات الخصم عبر MercadoPago Checkout API، لحسابات MercadoPago في الأرجنتين والبرازيل وتشيلي وكولومبيا والمكسيك وبيرو والأوروغواي. في خطوة Confirm Order يملأ العميل بيانات البطاقة في حقول MercadoPago.js الآمنة التي تقدمها MercadoPago، لذلك لا تصل بيانات البطاقة إلى موقعك أبدًا. تحوّل MercadoPago البطاقة إلى رمز لمرة واحدة، ثم ينشئ متجرك الدفعة على الخادم. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد رد MercadoPago، ولذلك تترك البطاقات المرفوضة طلبات بلا حالة.

تناسب المتاجر التي تبيع بعملة حساب MercadoPago الخاص بها وترغب في عرض نموذج البطاقة في صفحة الدفع الخاصة بها، مع إمكانية التقسيط. تقبل الإضافة البطاقات فقط. لا تتضمن تحويلًا إلى Checkout Pro، ولا محفظة MercadoPago، ولا الدفع نقدًا أو عبر Pix أو PSE أو Yape، ولا البطاقات المحفوظة أو الاشتراكات، ولا الفصل بين التفويض والتحصيل، ولا تحويل العملات.

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

نموذج البطاقة في صفحة الدفع الخاصة بك: رقم البطاقة وتاريخ الانتهاء ورمز الأمان في حقول MercadoPago، واسم حامل البطاقة، ووثيقة حامل البطاقة عندما يتطلبها البلد، والجهة المُصدِرة للبطاقة عند الحاجة، والتقسيط (cuotas, parcelas) الذي تقدمه MercadoPago لإجمالي الطلب، ضمن حدّ Maximum installments الذي تحدده.

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

إشعارات آمنة: يُعاد قراءة كل إشعار من واجهة MercadoPago البرمجية قبل تغيير أي طلب، مع فحص اختياري لتوقيع x-signature.

دون خصومات مزدوجة: يمنع القفل على مستوى السلة، ومفتاح idempotency لكل رمز بطاقة، والبحث عن الردود المفقودة، الخصم المزدوج عند النقر المزدوج أو فتح تبويب ثانٍ أو انتهاء المهلة. ولا تُخصم سلة سبق دفعها مرة أخرى.

وضعا الاختبار والإنتاج: بيانات اعتماد TEST- وAPP_USR- منفصلة، تُتحقق من بادئتها ومن بلد الحساب عند الحفظ. وتستخدم الاستردادات والإشعارات بيانات اعتماد الوضع الذي تمت فيه الدفعة.

استرداد من صفحة الطلب: استردادات كاملة وجزئية من تبويب VibeFox MercadoPago Gateway في الطلب، حتى المبلغ المحصّل فعليًا، مع تفاصيل الدفع وسجل الاستردادات وملاحظات MercadoPago. يضبط الاسترداد الكامل الحالة Refunded.

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

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 والإصدارات الأحدث (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي التنزيل الواحد على حزم الإصدارين. عملة مفعّلة في المتجر تطابق عملة حساب MercadoPago (ARS أو BRL أو CLP أو COP أو MXN أو PEN أو UYU). تطبيق MercadoPago يحتوي على Public Keys وAccess Tokens للاختبار والإنتاج. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).