VibeFox Conekta for PrestaShop

نظرة عامة

تضيف VibeFox Conekta Gateway مدفوعات Conekta (المكسيك) إلى PrestaShop. في خطوة الدفع يختار العميل Conekta، فيُنقل إلى صفحة الدفع الآمنة المُستضافة لدى Conekta، ويدفع بالبطاقة الائتمانية أو بطاقة الخصم، أو نقدًا في OXXO والمتاجر الأخرى، أو عبر التحويل المصرفي SPEI، أو عبر BNPL، وذلك حسب الطرق التي تسمح بها. ثم يعود العميل إلى متجرك. لا تصل بيانات البطاقة إلى موقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد Conekta الدفع أو تصدر مرجع دفع OXXO أو SPEI، لذلك لا تترك عمليات الدفع المتروكة طلبات غير مدفوعة.

تناسب المتاجر المكسيكية التي تبيع بعملة MXN أو USD وتريد قبول البطاقات والمدفوعات النقدية بطريقة دفع واحدة عبر حساب Conekta. تقبل الوحدة المدفوعات لمرة واحدة فقط. لا تتضمن نموذج بطاقة في صفحة الدفع، ولا بطاقات محفوظة، ولا اشتراكات، ولا تفويضًا مسبقًا وتحصيلًا، ولا أقساطًا شهرية (MSI). والاستردادات أو النزاعات التي تُجرى في لوحة Conekta تظهر كملاحظة على الطلب فقط، ولا تُسجَّل تلقائيًا.

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

صفحة الدفع المُستضافة من Conekta: يُنشأ طلب Conekta بإجمالي السلة وبعملة السلة. وتُعرض طرق النقد وSPEI وBNPL للسلال بعملة MXN فقط؛ أما السلال بعملة USD فلا تقبل إلا البطاقات.

لا يُعتمد الدفع إلا عند تأكيد Conekta: يقتصر كل من webhook وعودة العميل على طلب قراءة الطلب من Conekta API باستخدام المفتاح الخاص بك (Private Key). ولا يُعتمد على أي شيء في الإشعار أو في رابط العودة.

التحقق من المبلغ والعملة: يُقارن المبلغ بالسنت والعملة بالسلة. وأي فرق، أو أي دفعة من وضع الاختبار تُستلم أثناء تشغيل المتجر في وضع الإنتاج، يضع الطلب في Conekta payment on hold للمراجعة.

OXXO وSPEI: عندما يحصل العميل على مرجع دفع، يُنشأ الطلب بحالة Awaiting Conekta payment، ويتحول إلى Payment accepted عندما يُبلغ Conekta بالدفع.

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

وضعا الاختبار والإنتاج: مفاتيح خاصة منفصلة لكل وضع، وإشعار TEST MODE في صفحة الدفع. وتستخدم الاستردادات والإشعارات دائمًا مفتاح الوضع الذي تم فيه الدفع.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي من كتلة Conekta payment في الطلب، حتى المبلغ الذي حصلته Conekta فعلًا. ويضع الاسترداد الكامل الطلب في حالة Refunded.

كتلة Conekta في صفحة الطلب: طلب Conekta والمحصّل والحالة والمبالغ وسجل الاسترداد وملاحظات الوحدة. سجل اختياري لا يتضمن مفاتيح API ولا بيانات اتصال العميل.

المتطلبات

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