VibeFox Midtrans for PrestaShop

نظرة عامة

تضيف VibeFox Midtrans Payment Gateway مدفوعات Midtrans Snap بالروبية الإندونيسية (IDR) إلى PrestaShop. في خطوة الدفع يختار العميل Midtrans، ويُوجَّه إلى صفحة دفع Midtrans Snap، ثم يدفع بأيّ وسيلة مفعّلة في حسابك لدى Midtrans: GoPay وQRIS وShopeePay والبطاقات والحسابات الافتراضية المصرفية ومتاجر التسوق السريع وغيرها. لا يُنشأ الطلب إلا بعد أن تؤكد Midtrans الدفع، لذلك لا تترك المدفوعات المتروكة أي طلبات غير مدفوعة.

تناسب المتاجر الإندونيسية التي تبيع بالروبية الإندونيسية (IDR) وتريد جمع جميع وسائل Midtrans تحت طريقة دفع واحدة. تعمل الوحدة بالروبية الإندونيسية فقط ولا تُجري تحويل عملات. لا تتضمن نافذة Snap المنبثقة، ولا نموذج بطاقة على موقعك، ولا بطاقات محفوظة، ولا إعدادات تقسيط أو عروض ترويجية، ولا اشتراكات، ولا تفويضًا وتحصيلًا منفصلين.

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

Snap Redirect: صفحة دفع واحدة من Midtrans بجميع وسائل حسابك لدى Midtrans، بمبلغ سلة التسوق بالروبية الصحيحة، مع بنود الطلب والشحن والخصومات والضريبة.

تُعتمد المدفوعات فقط عند تأكيد Midtrans: يُتحقق من توقيع كل إشعار دفع، وتُعاد قراءة الحالة من واجهة برمجة حالة Midtrans، ويُقارَن المبلغ المدفوع والعملة بالسلة. وإذا لم يتطابقا، ينتقل الطلب إلى Midtrans payment on hold مع ملاحظة.

المدفوعات المؤجلة: تُنشئ المدفوعات عبر الحساب الافتراضي ومتاجر التسوق السريع طلبًا في حالة Awaiting Midtrans payment. يصبح مدفوعًا عندما تبلغ Midtrans عن الدفع، ويُلغى عندما تنتهي صلاحية الدفعة.

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

Sandbox وProduction: مفاتيح Server Key منفصلة لكل بيئة. تتذكر كل دفعة البيئة التي تمت فيها، لذا تستمر الاستردادات والإشعارات الخاصة بمدفوعات sandbox في العمل بعد الانتقال إلى الإنتاج.

استرداد في الاتجاهين: استرداد كامل أو جزئي بالروبية الصحيحة من كتلة Midtrans payment في الطلب. وتُسجَّل الاستردادات المنفذة من لوحة Midtrans في الطلب تلقائيًا.

حالة الطلب التي تختارها: Payment accepted أو Delivered أو Midtrans payment on hold بعد دفع مؤكَّد. وتتيح بادئة رقم الطلب لعدة متاجر مشاركة حساب Midtrans واحد.

كتلة Midtrans في صفحة الطلب: المعاملة مع رابط إلى لوحة Midtrans، وطريقة الدفع، وسجل الاسترداد، والملاحظات. سجل اختياري لا يتضمن المفاتيح ولا بيانات العميل.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. عملة الروبية الإندونيسية (IDR) في متجرك. حساب Midtrans يحتوي على Server Key لبيئة Sandbox وأخرى للإنتاج، مع ضبط عنوان إشعار الدفع (Payment Notification URL) في لوحة تحكم Midtrans. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).