VibeFox Peach Payments for PrestaShop

نظرة عامة

تضيف VibeFox Peach Payments Pay Gateway مدفوعات البطاقات عبر Peach Payments إلى PrestaShop. وتتصل بواجهة Peach Payments Card API ‏(COPYandPAY). في خطوة الدفع، يختار العميل الدفع بالبطاقة ويُدخل بيانات البطاقة في نموذج الدفع من Peach Payments في صفحة دفع بمتجرك. تُدخل بيانات البطاقة في نموذج Peach Payments ولا تصل إلى خادمك أبدًا. تدعم Visa وMastercard وAmerican Express وDiners Club. لا يُنشأ الطلب إلا بعد أن تؤكد Peach Payments الدفعة، لذلك لا تترك الدفعات المتروكة طلبات غير مدفوعة.

تناسب المتاجر في جنوب أفريقيا وكينيا وموريشيوس التي تبيع بعملة ZAR أو KES أو MUR ولديها حساب Peach Payments. لا تتضمن الوحدة الاسترداد من صفحة طلب PrestaShop (نفّذ الاسترداد في لوحة تحكم Peach Payments)، ولا البطاقات المحفوظة أو الاشتراكات أو التفويض المسبق والتحصيل، ولا EFT أو BNPL أو QR أو غيرها من وسائل الدفع غير البطاقات.

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

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

webhooks مشفّرة: تؤكد webhooks الخاصة بـ Peach Payments Card ‏(AES-256-GCM) المدفوعات حتى لو أغلق العميل المتصفح قبل العودة. إذا كانت السلة مشغولة، تتلقى webhook ردًا بخطأ مؤقت وتعيد Peach Payments إرسالها.

فحص المبلغ والعملة: تُقارَن كل دفعة بالسلة. عند عدم التطابق، ينتقل الطلب إلى حالة Peach Payments payment on hold مع ملاحظة، بدلًا من تعليمه كمدفوع.

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

وضعا الاختبار والإنتاج: Entity ID وAccess Token ومفتاح webhook مستقلة لبيئة الاختبار (sandbox) في Peach Payments وحساب الإنتاج. تُفحص الدفعة دائمًا في الوضع الذي بدأت فيه.

عمليات لوحة التحكم كملاحظات: تُضيف webhook الاستردادات والإلغاءات وعمليات رد المبالغ القسري المنفذة في لوحة تحكم Peach Payments إلى ملاحظات الطلب.

العلامات التجارية للبطاقات: اختر العلامات التي يعرضها نموذج الدفع. يُحمّل البرنامج النصي للنموذج مع قيمة تجزئة Subresource Integrity.

كتلة Peach Payments في صفحة الطلب: معرّف الدفعة ومعرّف الدفع (checkout) والمبلغ والنتيجة وملاحظات الوحدة. سجل اختياري لا يتضمن بيانات البطاقات أو المفاتيح أو بيانات العملاء.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث مع امتداد OpenSSL. حساب Peach Payments يتضمن Entity ID وAccess Token لواجهة Card API (للاختبار و/أو الإنتاج)، ومفتاح فك تشفير webhook من Peach Payments. عملة السلة: ZAR أو KES أو MUR. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).