VibeFox Pesapal for OpenCart

نظرة عامة

تضيف VibeFox Pesapal Pay Gateway مدفوعات Pesapal إلى OpenCart 3 وOpenCart 4. تتصل الإضافة بواجهة Pesapal API 3.0. في الخطوة الأخيرة من الدفع ينقر العميل على Confirm Order، ثم يُحوَّل إلى صفحة الدفع الخاصة بـ Pesapal ويدفع بواسطة M-Pesa أو Airtel Money أو MTN أو بطاقة أو تحويل بنكي أو أي وسيلة أخرى تقدمها Pesapal في بلد العميل. لا تمر بيانات البطاقة عبر موقعك أبدًا. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Pesapal الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

تناسب المتاجر في كينيا وأوغندا وتنزانيا ورواندا وزامبيا ومالاوي وزيمبابوي التي تبيع بالعملات KES أو UGX أو TZS أو ZMW أو RWF أو USD، ولديها حساب تاجر لدى Pesapal. يكفي consumer key وconsumer secret فقط. لا تتيح الإضافة الاسترداد من صفحة الطلب (قم بالاسترداد من لوحة تحكم Pesapal)، ولا تحفظ البطاقات، ولا تدعم الاشتراكات أو المدفوعات المتكررة، ولا تعرض نموذج دفع على موقعك، ولا تُجري تحويل العملات.

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

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

التحقق من المبلغ والعملة: لا يُعلَّم الطلب كمدفوع إلا عندما تُبلغ Pesapal بالحالة Completed وتطابق المبلغ والعملة المدفوعان مع الطلب. وعند وجود اختلاف ينتقل الطلب إلى حالة مراجعة مع ملاحظة.

إعداد IPN تلقائيًا: يُسجَّل عنوان الإشعار لدى Pesapal عند أول دفعة، بشكل منفصل لوضع الاختبار (sandbox) والوضع الفعلي. لا حاجة لإعداد أي شيء في لوحة تحكم Pesapal.

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

كل محاولة تُحفظ: الدفعة التي تتم من صفحة Pesapal أقدم لنفس السلة، مثل تبويب متصفح ثانٍ، تظل معروفة، والمحاولة الجديدة تتحقق أولًا من المحاولات السابقة.

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

حالات الطلبات الخاصة بك: اختر حالة OpenCart للطلب المدفوع، والدفعة قيد المراجعة، والطلب الملغى، والدفعة المعكوسة. الدفعة التي تُبلغ Pesapal بأنها معكوسة تُحوّل الطلب المدفوع إلى Refunded.

تبويب Pesapal في صفحة الطلب: معرّف التتبع، والمرجع لدى التاجر، والوضع، وحالة Pesapal، وطريقة الدفع، ورمز التأكيد، وجميع محاولات الدفع، والملاحظات. منطقة جغرافية وحد أدنى للإجمالي وترتيب العرض في OpenCart. سجل اختياري لا يتضمن المفاتيح أو الرموز أو بيانات العملاء.

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 والإصدارات الأحدث (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي التنزيل الواحد على الحزم الخاصة بالإصدارين. حساب تاجر لدى Pesapal مع consumer key وconsumer secret (وضع الاختبار و/أو الوضع الفعلي). يجب أن يكون متجرك متاحًا من الإنترنت لاستقبال إشعارات الدفع. عملة الطلب: KES أو UGX أو TZS أو ZMW أو RWF أو USD. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).