VibeFox Paystack for OpenCart

نظرة عامة

تضيف VibeFox Paystack Payment الدفع عبر Paystack إلى OpenCart 3 وOpenCart 4. في الخطوة الأخيرة من الدفع يضغط العميل على Confirm Order، فيُنقل إلى صفحة الدفع الآمنة المستضافة لدى Paystack، ويدفع بأي قناة مفعّلة في حسابك لدى Paystack، مثل البطاقات أو التحويل البنكي أو USSD أو الدفع عبر الهاتف المحمول. لا تمر بيانات البطاقة عبر موقعك أبدًا. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن يؤكد Paystack الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

تناسب المتاجر التي تبيع بعملة NGN أو USD أو GHS أو ZAR أو KES أو XOF أو EGP أو RWF ولديها حساب في Paystack. المطلوب هو المفاتيح السرية فقط. لا تتضمن الإضافة نموذج دفع مدمجًا أو منبثقًا (توجيه فقط)، ولا بطاقات محفوظة، ولا اشتراكات، ولا تقسيم للمدفوعات أو حسابات فرعية، ولا اختيار لقنوات الدفع.

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

يُعتمد الدفع فقط عند تأكيد Paystack: لا تُعتمد عودة العميل ولا محتوى الـ webhook. تقرأ الإضافة المعاملة من واجهة Paystack البرمجية على الخادم، وتتحقق من مرجعها وحالتها ومبلغها وعملتها مقارنةً بالطلب. بعد ذلك يرسل OpenCart رسائله المعتادة للطلب.

webhook موقّعة: يوقّع Paystack كل webhook بمفتاحك السري، لذلك لا يوجد أي مفتاح إضافي لإعداده. تُؤكَّد التحويلات البنكية ومدفوعات USSD التي تكتمل لاحقًا عبر الـ webhook.

فحص المبلغ والعملة: إذا وُجد اختلاف، يُنقل الطلب إلى حالة مراجعة مع ملاحظة. وتُدعم رسوم Paystack المحمّلة على العميل.

سلة واحدة، دفعة واحدة: قد تصل عودة العميل والـ webhook في الوقت نفسه دون تطبيق الدفعة مرتين. تنتقل أي محاولة جديدة لسلة دُفعت مسبقًا مباشرةً إلى صفحة النجاح، ويُعلَّم الدفع المكرر لاسترداده.

وضعا الاختبار والتشغيل الحي: مفاتيح سرية منفصلة. تُظهر صفحة الإعدادات تحذيرًا عند غياب المفتاح، أو استخدام مفتاح اختبار في الوضع الحي، أو مفتاح حي في وضع الاختبار، أو وضع مفتاح عام في حقل المفتاح السري، ويبقى خيار الدفع مخفيًا حتى تُصحَّح المشكلة.

استرداد من صفحة الطلب: استرداد كامل أو جزئي من تبويب VibeFox Paystack Payment في الطلب، ضمن الوضع (الاختبار أو التشغيل الحي) الذي تمّت به عملية الدفع، وبالمبلغ والعملة اللذين خصمهما Paystack فعليًا.

حالات الطلبات الخاصة بك: اختر حالة OpenCart للطلب المدفوع، والطلب المكتمل تلقائيًا، والدفعة التي ما زالت قيد المعالجة، والدفعة قيد المراجعة، والدفعة الفاشلة، والاسترداد الكامل.

شروط OpenCart: المنطقة الجغرافية، والحد الأدنى لإجمالي الطلب، وترتيب العرض. سجل لا يتضمن مفاتيح ولا بيانات العملاء.

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 والإصدارات الأحدث (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي التنزيل الواحد على الحزم الخاصة بالإصدارين. حساب Paystack يحتوي على مفاتيح سرية للاختبار و/أو التشغيل الحي. عملة الطلب: NGN أو USD أو GHS أو ZAR أو KES أو XOF أو EGP أو RWF، كما هي مفعّلة في حساب Paystack الخاص بك. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).