VibeFox Pagar.me for WooCommerce

نظرة عامة

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

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

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

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

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

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

PIX وboleto: يضع PIX أو boleto صادر الطلب في حالة الانتظار حتى تؤكد Pagar.me الدفع؛ أما المنتهي منهما فيحوّل الطلب إلى Failed.

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

الاستردادات: استرداد كامل أو جزئي لمدفوعات البطاقة وPIX من شاشة طلبات WooCommerce. وتظهر الاستردادات وعمليات الاسترجاع (chargebacks) التي تتم في Pagar.me على الطلب.

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

WooCommerce الحديث: صفحة الدفع الكلاسيكية، وكتلة Checkout، وصفحة Pay for order، وHPOS، وترجمة إلى البرتغالية البرازيلية. يُؤخذ CPF/CNPJ من حقول Brazilian Market on WooCommerce عند وجودها.

المتطلبات

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