VibeFox Pagar.me for PrestaShop

نظرة عامة

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

تناسب المتاجر البرازيلية التي تريد عرض أهم طرق الدفع المحلية في صفحة مستضافة واحدة، مع استرداد من صفحة طلبات PrestaShop. لا تتضمن الوحدة نموذج بطاقة داخل صفحة الدفع، ولا بطاقات محفوظة، ولا اشتراكات أو مدفوعات متكررة، ولا قواعد للتقسيط، ولا مدفوعات مجزأة، ولا مدفوعات بالبطاقة بالتفويض فقط، ولا تكاملًا مع Pagar.me Hub.

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

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

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

التحقق من المبلغ والعملة: يُقارن مبلغ الرسوم المدفوعة بإجمالي السلة. وأي فرق، أو boleto مدفوع جزئيًا، أو دفعة بعد الإلغاء يضع الطلب في Pagar.me payment on hold مع ملاحظة.

PIX وboleto: يُنشئ PIX أو boleto صادر الطلب في حالة Awaiting Pagar.me payment حتى تؤكد Pagar.me الدفع. أما المنتهي منهما فيضع الطلب في حالة Payment error.

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

استردادات من صفحة الطلب: استرداد كامل أو جزئي لمدفوعات البطاقة وPIX في كتلة Pagar.me payment، حتى المبلغ الذي حصّلته Pagar.me فعليًا. وتظهر الاستردادات وعمليات الاسترجاع (chargebacks) التي تتم في Pagar.me على الطلب.

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

كتلة Pagar.me في صفحة الطلب: طلب Pagar.me وطريقة الدفع والحالة والمبالغ المدفوعة والمستردة وسجل الاستردادات وملاحظات Pagar.me الخاصة بالطلب. سجل اختياري لا يتضمن المفاتيح ولا بيانات العملاء.

المتطلبات

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