VibeFox Peach Payments for OpenCart

نظرة عامة

تضيف VibeFox Peach Payments Pay Gateway مدفوعات البطاقات عبر نموذج COPYandPAY من Peach Payments إلى OpenCart 3 وOpenCart 4. في خطوة الدفع الأخيرة ينقر العميل على Confirm Order وينتقل إلى صفحة دفع في متجرك، حيث يُدخل بيانات البطاقة في نموذج Peach Payments. لا تصل بيانات البطاقة إلى خادمك أبدًا. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Peach Payments الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة (missing orders).

وهي مناسبة للمتاجر في جنوب أفريقيا وكينيا وموريشيوس التي تبيع بعملات ZAR أو KES أو MUR ولديها حساب Peach Payments مع Card API. تقبل الإضافة مدفوعات البطاقات لمرة واحدة فقط. لا يوجد نموذج بطاقة في خطوة الدفع نفسها، ولا بطاقات محفوظة، ولا اشتراكات، ولا تفويض مسبق والتقاط، ولا استردادات من OpenCart (تُجرى الاستردادات في لوحة تحكم Peach Payments)، ولا طرق EFT أو BNPL أو QR أو أي طرق أخرى غير البطاقات.

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

نموذج بطاقة Peach Payments: Visa وMastercard وAmerican Express وDiners Club، حسب ما تحدده الإعدادات. يُحمَّل برنامج النموذج مع تجزئة Subresource Integrity، ويتبع النموذج لغة العميل عندما تدعمها Peach Payments.

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

Webhooks مشفّرة: تُفك الـ webhooks تشفيرها بمفتاح AES-256-GCM الخاص بك، لذلك لا يمكن إلا لـ Peach Payments تغيير طلباتك. تُؤكَّد المدفوعات حتى إن أغلق العميل المتصفح.

التحقق من المبلغ والعملة: الدفعة التي لا تطابق الطلب تنتقل إلى حالة مراجعة مع ملاحظة. وتحصل الدفعات التي تضع عليها Peach Payments علامة للمراجعة اليدوية على ملاحظة أيضًا.

لا معالجة مزدوجة: لا يطبّق الرجوع والـ webhook الدفعة نفسها مرتين أبدًا، ولا تُدفع السلة نفسها مرتين، حتى إن أنشأ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة التأكيد، ويُحدِّث OpenCart 4 طلب الدفع نفسه.

وضعا الاختبار والإنتاج: معرّفات Entity ID ورموز الوصول ومفاتيح الـ webhook منفصلة. تُتحقق الدفعة دائمًا في الوضع الذي بدأت فيه.

استردادات لوحة التحكم في الملاحظات: تُضاف الاستردادات والعكوسات وعمليات الاسترداد من البطاقة (chargebacks) التي تُجرى في Peach Payments إلى ملاحظات الطلب عبر الـ webhook.

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

المتطلبات

OpenCart 3.0.x (تم اختباره على 3.0.5.0) أو OpenCart 4.0.2 والإصدارات الأحدث (تم اختباره على 4.1.0.3)، وPHP 8.0 أو أحدث مع امتداد OpenSSL. يحتوي التنزيل الواحد على الحزم الخاصة بالإصدارين. عملة ZAR أو KES أو MUR في متجرك. حساب Peach Payments يتضمن Entity ID وAccess Token الخاصين بـ Card API (للاختبار والإنتاج)، ومفتاح فك تشفير الـ webhooks من Peach Payments. يجب أن يكون المتجر متاحًا من الإنترنت لاستقبال الـ webhooks. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).