VibeFox Culqi for PrestaShop

نظرة عامة

تضيف وحدة VibeFox Culqi Payment خدمة الدفع البيروفية Culqi إلى PrestaShop. في خطوة الدفع، يدفع العميل بالبطاقة أو عبر Yape في نافذة Culqi Checkout المنبثقة ولا يغادر متجرك أبدًا. تُدخَل بيانات البطاقة في نافذة Culqi ولا تصل إلى خادمك أبدًا. ثم ينشئ خادمك عملية الخصم عبر Culqi Charges API، ولا يُنشأ الطلب إلا بعد أن تؤكد Culqi عملية الخصم، لذلك لا تترك المدفوعات المرفوضة أو المتروكة أي طلبات غير مدفوعة.

تناسب المتاجر في بيرو التي تبيع بالسول البيروفي (PEN) أو الدولار الأمريكي (USD) ولديها حساب Culqi. تقبل الوحدة المدفوعات لمرة واحدة بالبطاقة وعبر Yape فقط. لا تتضمن رموز PagoEfectivo أو CIP، ولا تطبيقًا مصرفيًا، ولا وكلاء، ولا محافظ، ولا Cuotéalo، ولا بطاقات محفوظة، ولا اشتراكات أو تقسيطًا، ولا webhooks من Culqi، ولا تفويضًا وتحصيلًا منفصلين.

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

نافذة Culqi Checkout المنبثقة: البطاقات (Visa وMastercard وAmerican Express وDiners Club) واختياريًا Yape في نافذة داخل صفحة الدفع الخاصة بمتجرك.

3-D Secure: عندما يشترطه المصرف، تُفتح Culqi 3-D Secure تلقائيًا وتكتمل عملية الخصم بعد المصادقة.

الدفع يُعتمد فقط عند تأكيد Culqi: يُنشأ الطلب عندما ترد Culqi بعملية خصم ناجحة، ويُقارَن المبلغ والعملة المخصومان بالسلة. وعند عدم التطابق ينتقل الطلب إلى حالة Culqi payment on hold مع ملاحظة.

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

رسائل رفض واضحة: يرى العميل رسالة Culqi ويمكنه تجربة بطاقة أخرى. يُكتب رمز الرفض في سجل الوحدة.

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

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

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

المتطلبات

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