VibeFox Vindi for OpenCart

نظرة عامة

تربط VibeFox Vindi Gateway منصة OpenCart 3 وOpenCart 4 بواجهة Vindi البرمجية للمتاجر في البرازيل التي تبيع بالريال البرازيلي (BRL). يدفع العملاء بالبطاقة الائتمانية في صفحة فاتورة Vindi، أو عبر boleto أو PIX أو BolePix (boleto + PIX). لا تمر بيانات البطاقة عبر موقعك أبدًا. أما في حالة boleto وPIX، فيحصل الطلب فورًا على حالة الانتظار الخاصة بمتجرك، ويحصل العميل على رابط boleto ورموز PIX في صفحة النجاح وفي حسابه وفي بريد الطلب الإلكتروني.

تناسب المتاجر البرازيلية التي لديها حساب Vindi بالفعل وتريد مدفوعات لمرة واحدة دون إنشاء نموذج بطاقة. في المدفوعات بالبطاقة ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Vindi الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة. تقبل الإضافة المدفوعات المنفردة بدفعة واحدة فقط. لا تتضمن اشتراكات أو فوترة متكررة، ولا بطاقات محفوظة، ولا أقساط (parcelamento)، ولا نموذج بطاقة على موقعك، ولا يمكنها استرداد مدفوعات boleto.

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

أربع طرق دفع: بطاقة ائتمانية وboleto وPIX وBolePix. تختار الطرق التي تُعرض عند الدفع.

حقل CPF / CNPJ: يُطلب عند الدفع لطريقتي boleto وPIX، ويُتحقق منه بأرقام التحقق الخاصة به. يُملأ مسبقًا من حقل مخصص للعميل باسم CPF أو CNPJ عندما يكون ذلك ممكنًا.

يُعتمد الدفع فقط عند تأكيد Vindi: لا يُقبل الدفع إلا بعد أن تقرأ الإضافة الفاتورة مرة أخرى من واجهة Vindi البرمجية وتتحقق من العملة ورمز الطلب وعميل Vindi والمبلغ الدقيق. وعند وجود اختلاف يُوضع الطلب في حالة الاحتجاز مع ملاحظة.

Webhook محمي: يحتوي عنوان الـ webhook على رمز سري، وكل إشعار يؤدي فقط إلى فحص جديد عبر واجهة Vindi البرمجية.

لا مدفوعات مزدوجة: تُدفع السلة مرة واحدة فقط. تعيد المحاولة الجديدة استخدام فاتورة Vindi المعلّقة أو تلغيها أولًا. وعندما تلغي طلبًا غير مدفوع في OpenCart، تُلغى فاتورته في Vindi أيضًا.

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

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي لمدفوعات البطاقة وPIX من تبويب الإضافة في صفحة الطلب، حتى المبلغ الذي حصّلته Vindi فعلًا. يضع الاسترداد الكامل الطلب في حالة الاسترداد الخاصة بك.

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

المتطلبات

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