VibeFox Xendit for OpenCart

نظرة عامة

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

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

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

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

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

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

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

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

حالات طلباتك الخاصة: اختر حالة OpenCart للطلب المدفوع، والطلب المكتمل، والدفعة قيد المراجعة.

سبع عملات: IDR وPHP وVND وTHB وMYR وUSD وSGD. تظهر طريقة الدفع لهذه العملات فقط، وضمن المنطقة الجغرافية والحد الأدنى للإجمالي اللذين تحددهما.

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

المتطلبات

OpenCart 3.0.x (تم اختباره على 3.0.5.0) أو OpenCart 4.0.2 وما بعده (تم اختباره على 4.1.0.3)، وPHP 8.0 أو أحدث. تحتوي حزمة التنزيل الواحدة على الحزم لكلا الإصدارين. حساب Xendit يحتوي على مفاتيح API السرية ورموز التحقق من الـ webhooks لوضعي الاختبار والإنتاج. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).