VibeFox Xendit for PrestaShop

نظرة عامة

تضيف VibeFox Xendit Payment Gateway مدفوعات Xendit إلى PrestaShop للمتاجر في إندونيسيا والفلبين وفيتنام وتايلاند وماليزيا وسنغافورة. في خطوة الدفع، يختار العميل Xendit، فيُنقل إلى صفحة الفاتورة المستضافة لدى Xendit، ويدفع عبر أي قناة دفع مفعّلة في حسابك لدى Xendit لعملة السلة (حسابات افتراضية، ومحافظ إلكترونية، ورموز QR، ومنافذ بيع بالتجزئة، أو بطاقات)، ثم يعود إلى متجرك. لا يُنشأ الطلب إلا بعد أن تؤكد Xendit الدفع.

تناسب الوحدة المتاجر التي تريد طرق الدفع المحلية في جنوب شرق آسيا من حساب Xendit واحد، دون إنشاء نماذج دفع على موقعها. تتم الاستردادات من لوحة تحكم Xendit لا من لوحة إدارة PrestaShop. لا تتضمن الوحدة بطاقات محفوظة، ولا اشتراكات، ولا حقول دفع في صفحة الدفع، ولا تفويضًا وتحصيلًا منفصلين، ولا حسابات فرعية من xenPlatform.

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

فاتورة Xendit المستضافة: فاتورة واحدة لكل محاولة دفع، بإجمالي السلة وبعملة السلة. تُرسل IDR وVND كأعداد صحيحة، وتُرسل العملات الأخرى بمنزلتين عشريتين.

لا يُعتمد الدفع إلا عند تأكيد Xendit: تُتحقق webhooks باستخدام رمز التحقق الخاص بالوضع، ويُعاد دائمًا قراءة حالة الفاتورة ومبلغها وعملتها من واجهة Xendit البرمجية قبل إنشاء الطلب.

التحقق من المبلغ والعملة: الفاتورة المدفوعة التي لا تطابق إجمالي السلة أو عملتها تُنشئ الطلب في حالة Xendit payment on hold مع ملاحظة.

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

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

حالة الطلب التي تختارها: Payment accepted أو Delivered بعد نجاح الدفع.

سبع عملات: IDR وPHP وVND وTHB وMYR وUSD وSGD. تظهر طريقة الدفع لهذه العملات فقط.

كتلة Xendit في صفحة الطلب: جميع فواتير الطلب مع الوضع والمبلغ والحالة وقناة الدفع، وملاحظات الدفع. تُسجَّل الأخطاء دائمًا دون مفاتيح أو بيانات عملاء.

المتطلبات

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