VibeFox Yoco for OpenCart

نظرة عامة

تضيف VibeFox Yoco Pay Gateway مدفوعات البطاقات وInstant EFT بالراند الجنوب أفريقي (ZAR) إلى OpenCart 3 وOpenCart 4 عبر واجهة Yoco Checkout البرمجية. في خطوة الدفع الأخيرة ينقر العميل على Confirm Order، فيُنقل إلى صفحة الدفع التي تستضيفها Yoco، ويدفع هناك، ثم يعود إلى متجرك. لا تمر بيانات البطاقة عبر موقعك أبدًا. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Yoco الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

تناسب المتاجر الجنوب أفريقية التي تبيع بالـ ZAR ولديها حساب Yoco بدفعات إلكترونية. تقبل الإضافة المدفوعات لمرة واحدة فقط. لا تتضمن بطاقات محفوظة، ولا اشتراكات، ولا نموذج بطاقة داخل الموقع، ولا تفويضًا وتحصيلًا منفصلين. تعمل بالـ ZAR فقط، بحد أدنى لإجمالي الطلب قدره R2.00.

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

صفحة دفع Yoco المستضافة: يُنشأ دفع Yoco بإجمالي الطلب بالسنتات. يتلقى الطلب المكرر بعد نقرة مزدوجة أو انتهاء مهلة نفس صفحة الدفع، لا صفحة ثانية.

تُعتبر مدفوعة فقط عندما تؤكد Yoco ذلك: تستعلم الإضافة من Yoco عن حالة الدفع عند عودة العميل، وعند وصول webhook موقّع. لا يحصل الطلب على حالته إلا عندما تُبلغ Yoco بأن الدفع مكتمل، ثم يرسل OpenCart رسائل الطلب المعتادة.

إعداد الـ webhooks تلقائيًا: عند حفظ مفتاح سري، تسجّل الإضافة عنوان الـ webhook الخاص بها لدى Yoco لذلك الوضع، وتخزّن سر التوقيع. تُرفض الـ webhooks التي لا توقيع صالح لها.

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

لا معالجة مزدوجة: يُعالَج الـ webhook وعودة العميل المتزامنان واحدًا بعد الآخر. لا تُخصم سلة مدفوعة من جديد، وتُعلَّم الدفعة الثانية في ملاحظات الطلب.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي من تبويب VibeFox Yoco Pay Gateway في الطلب، بالمبلغ الذي خصمته Yoco وبمفتاح الوضع الذي تمت فيه الدفعة. تُسجَّل المبالغ المستردة التي تُنفَّذ من بوابة Yoco تلقائيًا.

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

حالات طلباتك الخاصة وشروط OpenCart: اختر الحالة للطلب المدفوع، والدفعة قيد المراجعة، والاسترداد الكامل؛ وكذلك المنطقة الجغرافية، والحد الأدنى لإجمالي الطلب، وترتيب العرض. سجل يخفي المفاتيح وعناوين البريد الإلكتروني.

المتطلبات

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