VibeFox Yoco for PrestaShop

نظرة عامة

تضيف وحدة VibeFox Yoco Pay Gateway إلى PrestaShop مدفوعات البطاقات وInstant EFT بعملة راند جنوب أفريقيا (ZAR) عبر Yoco Checkout API. في خطوة الدفع يختار العميل Yoco، فيُنقل إلى صفحة الدفع التي تستضيفها Yoco، ويدفع هناك ثم يعود إلى متجرك. لا تمر بيانات البطاقة عبر موقعك أبدًا، ولا تترك المدفوعات المتروكة طلبات غير مدفوعة.

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

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

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

يُعتمد الدفع فقط عند تأكيد Yoco: تسأل الوحدة Yoco عن حالة الـ checkout عند عودة العميل، وعند وصول webhook موقّع. ولا يُنشأ الطلب إلا عندما تُبلغ Yoco بأن الـ checkout مكتمل.

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

التحقق من المبلغ والعملة: الدفعة بمبلغ أو عملة مختلفة تضع الطلب في Yoco payment on hold مع ملاحظة. ولا تعيد الدفعة فتح طلب مُلغى أو مُسترَد.

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

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

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

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

المتطلبات

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