VibeFox PagSeguro for PrestaShop

نظرة عامة

تربط VibeFox PagSeguro Gateway متجر PrestaShop بـ PagBank (المعروف سابقًا باسم PagSeguro) عبر PagBank Checkout API. في خطوة الدفع يختار العميل PagBank، فتنشئ الوحدة عملية دفع في PagBank بالمبلغ الدقيق للسلة وتوجّه العميل إلى صفحة الدفع الخاصة بـ PagBank. هناك يدفع العميل بالطرق المفعّلة في حسابك لدى PagBank، مثل بطاقة الائتمان أو PIX أو boleto، ثم يعود إلى متجرك. المدفوعات مقبولة بالريال البرازيلي (BRL) فقط. لا يُنشأ الطلب إلا بعد أن تُبلغ PagBank بالدفع، لذلك لا تترك المدفوعات المتروكة أي طلبات غير مدفوعة.

تناسب المتاجر البرازيلية التي تريد صفحة الدفع المستضافة لدى PagBank مع إمكانية الاسترداد مباشرةً من صفحة الطلب في PrestaShop. لا تتضمن الوحدة نموذج بطاقة داخل المتجر، ولا بطاقات محفوظة، ولا اشتراكات أو مدفوعات متكررة، ولا مدفوعات مقسّمة. تُضبط طرق الدفع والتقسيط في حسابك لدى PagBank، ولا تُختار من داخل الوحدة.

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

صفحة دفع مستضافة لدى PagBank: لا تمر بيانات البطاقة عبر خادمك أبدًا. يُملأ اسم العميل وبريده الإلكتروني ورقم هاتفه البرازيلي ورقم CPF/CNPJ في صفحة PagBank إذا كانت متوفرة لدى المتجر.

لا يُعتبر الدفع مكتملًا إلا بعد تأكيد PagBank: تُتحقق الإشعارات وعودة العميل بقراءة عملية الدفع وطلب PagBank عبر الواجهة البرمجية: الحالة والمبلغ بالسنتافو والعملة. تُرفض الإشعارات الموقّعة ذات التوقيع غير الصالح.

لا شيء يلزم إعداده في PagBank: يُرسل عنوان الإشعارات مع كل عملية دفع.

التحقق من المبلغ: أي دفعة لا يتطابق مبلغها أو عملتها مع السلة تُوضع في حالة PagBank payment on hold مع ملاحظة. تُؤخذ فوائد التقسيط التي يدفعها المشتري في الحسبان.

حالات واضحة: تنتقل الطلبات المدفوعة إلى Payment accepted؛ وتنتقل دفعات PIX أو boleto المُنشأة والمدفوعات قيد التحليل إلى Awaiting PagBank payment؛ وتنتقل المدفوعات المرفوضة لاحقًا إلى Payment error، والملغاة إلى Canceled.

لا دفع مزدوج: عند إعادة الدفع، يُعاد استخدام عملية الدفع المفتوحة في PagBank أو تُعطَّل السابقة. لا تُنشئ الإشعارات والعودة المتكررة أبدًا طلبًا ثانيًا ولا تسجّل الدفعة مرتين.

Sandbox والإنتاج: رموز منفصلة. تستخدم عمليات التحقق من الحالة والاسترداد لطلب ما دائمًا البيئة التي تمّت فيها عملية دفعه.

الاسترداد من صفحة الطلب: استرداد كامل وجزئي في كتلة PagBank payment، حتى المبلغ الذي حصّلته PagBank، ولا يُسجَّل إلا بعد تأكيد PagBank. يؤدي الاسترداد الكامل إلى تعيين الطلب Refunded.

المتطلبات

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