VibeFox PayMongo for PrestaShop

نظرة عامة

تضيف VibeFox PayMongo Payment Gateway مدفوعات PayMongo للفلبين إلى PrestaShop. في خطوة الدفع يختار العميل PayMongo، فيُنقل إلى صفحة الدفع المستضافة لدى PayMongo، ويدفع ببطاقة أو GCash أو GrabPay أو Maya أو بأي طريقة أخرى تختارها، ثم يعود إلى متجرك. لا تمرّ بيانات البطاقة عبر موقعك أبدًا. يُنشأ الطلب فقط بعد أن تؤكد PayMongo الدفع، لذلك لا تترك المدفوعات المتروكة أي طلبات غير مدفوعة.

تناسب هذه الوحدة المتاجر التي تبيع بالبيزو الفلبيني (PHP) ولديها حساب PayMongo. تقبل الوحدة المدفوعات لمرة واحدة بمبلغ ₱100.00 على الأقل. لا توجد حقول بطاقة في صفحة الدفع الخاصة بمتجرك، ولا بطاقات محفوظة، ولا اشتراكات أو تقسيط، ولا تفويض وتحصيل منفصلان. ولا تُنسخ الاستردادات التي تتم في لوحة تحكم PayMongo إلى PrestaShop.

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

PayMongo Checkout: صفحة مستضافة واحدة تضم طرق الدفع التي تختارها: البطاقات (Visa و Mastercard)، و GCash، و GrabPay، و Maya، و ShopeePay، و QR Ph، و BillEase، و Atome، والخدمات المصرفية الإلكترونية المباشرة (BPI، و UnionBank).

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

التحقق من المبلغ والعملة: يُقارن المبلغ المدفوع والعملة بالسلة. عند وجود اختلاف، يُوضع الطلب في حالة PayMongo payment on hold مع ملاحظة.

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

الوضع التجريبي والوضع الفعلي: مفاتيح سرية منفصلة وأسرار webhook منفصلة. تحتفظ المدفوعات بالوضع الذي تمت فيه: فالدفعة التجريبية لا تُكمل الطلب أبدًا والمتجر في الوضع الفعلي، وتستخدم الاستردادات مفتاح وضع الدفعة نفسها.

الاستردادات من صفحة الطلب: استرداد كامل أو جزئي في كتلة PayMongo payment، حتى المبلغ الذي حصّلته PayMongo فعليًا. الاسترداد الكامل يضع الطلب في حالة Refunded.

حالة الطلب التي تختارها: Payment accepted أو Delivered بعد الدفع الناجح. المدفوعات التي ما زالت قيد المعالجة تنتظر في Awaiting PayMongo payment.

كتلة PayMongo في صفحة الطلب: الدفعة، و payment intent، و checkout والوضع، وسجل الاستردادات والملاحظات. سجل بلا مفاتيح أو بيانات عملاء.

المتطلبات

PrestaShop من 8.0 إلى 9.x، و PHP 8.0 أو أحدث. حساب PayMongo بمفاتيح API سرية و webhook لكل وضع. سلال بالبيزو الفلبيني (PHP). مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).