VibeFox Vindi for PrestaShop

نظرة عامة

تربط VibeFox Vindi Gateway متجر PrestaShop بواجهة Vindi API للمتاجر في البرازيل التي تبيع بالريال البرازيلي (BRL). يدفع العملاء بالبطاقة الائتمانية في صفحة الفاتورة الخاصة بـ Vindi، أو عبر boleto أو PIX أو BolePix (boleto + PIX). لا تمرّ بيانات البطاقة عبر موقعك أبدًا. وفي حالتي boleto وPIX يبقى الطلب في حالة Awaiting Vindi payment، ويتلقى العميل رابط boleto ورموز PIX في صفحة تأكيد الطلب وفي «حسابي» وفي البريد الإلكتروني.

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

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

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

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

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

webhook محمي: يحتوي رابط webhook على رمز سري، وكل إشعار يُطلق فحصًا جديدًا عبر Vindi API فقط.

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

الإنتاج وsandbox: مفاتيح API منفصلة. تحفظ كل دفعة البيئة التي أُنشئت فيها فاتورتها، لذلك تُنفَّذ الفحوص والاستردادات دائمًا في تلك البيئة.

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

كتلة Vindi في صفحة الطلب: فواتير السلة وسجل الاسترداد وملاحظات الوحدة.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث، وعملة المتجر الريال البرازيلي (BRL). حساب Vindi مع مفتاح API (وحساب Vindi sandbox للاختبار). ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).