VibeFox PagSeguro for OpenCart

نظرة عامة

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

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

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

صفحة دفع PagBank: عملية دفع واحدة لإجمالي الطلب بعملة BRL. تنتهي صلاحية صفحة الدفع بعد 120 دقيقة.

مدفوع فقط عند تأكيد PagBank: لا تؤدي الإشعارات وعودة العميل إلا إلى بدء عملية تحقق. ويُقرأ الدفع وطلب PagBank ورسومه دائمًا من واجهة PagBank البرمجية باستخدام رمز البيئة التي أُنشئ فيها الدفع.

إشعارات موقّعة: عندما ترسل PagBank الترويسة x-authenticity-token، يُتحقق منها برمزك؛ ويُرفض أي توقيع غير صالح.

التحقق من المبلغ والعملة: يُقارن المبلغ المخصوم (دون فوائد التقسيط لدى PagBank) والعملة بالطلب. ويؤدي أي اختلاف، أو دفعة بعد الإلغاء، إلى نقل الطلب إلى حالة مراجعة مع ملاحظة.

Boleto وPIX والتحليل: يُبقي boleto أو PIX الذي تم إنشاؤه، أو دفعة قيد التحليل، الطلبَ في حالة انتظار حتى تُبلغ PagBank بأنها مدفوعة.

سلة واحدة ودفعة واحدة: عندما يدفع العميل مرة أخرى، تُعاد استخدام صفحة PagBank المفتوحة أو تُعطَّل أولًا. وتبقى الدفعة التي تمت في صفحة سابقة صالحة، ويُعلَّم أي دفع ثانٍ للاسترداد.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي في تبويب VibeFox PagSeguro Gateway الخاص بالطلب، حتى حدّ المبلغ الذي حصّلته PagBank فعليًا. وتُسجَّل الاستردادات التي تتم في لوحة PagBank على الطلب.

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

المتطلبات

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