VibeFox Pagar.me for OpenCart

نظرة عامة

تربط VibeFox Pagar.me Gateway بين OpenCart 3 وOpenCart 4 وواجهة Pagar.me (Stone) Core API v5 للمتاجر في البرازيل. في الخطوة الأخيرة من الدفع، ينقر العميل على Confirm Order، ثم يُنقل إلى صفحة الدفع الخاصة بـ Pagar.me، ويدفع بالبطاقة الائتمانية أو PIX أو boleto أو بطاقة الخصم. لا تُقبل المدفوعات إلا بالريال البرازيلي (BRL). يُنشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن يؤكد Pagar.me الدفع أو يُصدر PIX أو boleto، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

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

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

صفحة دفع Pagar.me: بطاقة ائتمانية، وPIX، وboleto، وبطاقة خصم. تختار أنت وسائل الدفع المعروضة، وعدد أيام صلاحية boleto (من 1 إلى 30).

مدفوع فقط عند تأكيد Pagar.me: لا يطلب webhook وعودة العميل من المتجر سوى التحقق من طلب Pagar.me المحدد. ثم يُقرأ الطلب من واجهة Pagar.me البرمجية باستخدام مفتاحك السري.

التحقق من المبلغ والعملة: تُقارن المبالغ المحصّلة بإجمالي الطلب. يؤدي الفرق، أو boleto مدفوع بأقل من قيمته، أو دفعة بعد الإلغاء، إلى نقل الطلب إلى حالة مراجعة مع ملاحظة.

PIX وboleto: يُبقي PIX أو boleto الصادر الطلبَ في حالة انتظار حتى يؤكد Pagar.me الدفع. وعند انتهاء صلاحية أيٍّ منهما تُعيَّن حالة الفشل.

سلة واحدة ودفعة واحدة: عندما يدفع العميل مرة أخرى، تُعاد استخدام صفحة الدفع المفتوحة أو تُغلق أولًا في Pagar.me. ويُعلَّم أي دفع ثانٍ للسلة نفسها لاسترداده.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي لمدفوعات البطاقة وPIX من تبويب VibeFox Pagar.me Gateway في الطلب، حتى حدّ المبلغ الذي حصّله Pagar.me فعليًا. وتُسجَّل الاستردادات والمنازعات التي تتم في Pagar.me على الطلب.

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

حالات الطلب الخاصة بك: اختر حالة OpenCart للطلب المدفوع، وPIX أو boleto قيد الانتظار، والدفع قيد المراجعة، والدفع الفاشل، والاسترداد.

المتطلبات

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