VibeFox Kushki for OpenCart

نظرة عامة

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

تناسب الإضافة المتاجر التي تحصّل بالدولار الأمريكي (USD) أو بالبيزو الكولومبي (COP) وتريد نموذج بطاقة في صفحة الدفع الخاصة بها دون التعامل مع بيانات البطاقات. تدعم الإضافة المدفوعات في خطوة واحدة فقط. لا تتضمن استردادات جزئية، أو بطاقات محفوظة، أو اشتراكات، أو مدفوعات نقدية أو تحويلًا بنكيًا (PSE)، أو مدفوعات ببطاقة الخصم عبر إعادة التوجيه، ولا تدعم التفويض والتحصيل المنفصلين.

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

نموذج بطاقة Kushki المستضاف: نموذج البطاقة الخاص بـ Kushki في خطوة Confirm Order من صفحة دفع OpenCart. يُرسل الدفع فور ضغط العميل زر الدفع داخل النموذج. تُمرَّر الأقساط (diferido) التي يختارها العميل في النموذج إلى عملية الخصم.

مدفوع فقط عند تأكيد Kushki: لا تُحدَّد حالة الطلب إلا بعد أن توافق Kushki على الخصم برقم تذكرة. إذا أبلغت Kushki عن مبلغ أو عملة مختلفين، يُنقل الطلب إلى حالة مراجعة مع ملاحظة. بعد ذلك يرسل OpenCart رسائل الطلب المعتادة.

الضريبة كـ IVA: يُؤخذ المبلغ والعملة من الطلب. تُبلغ Kushki بضريبة الطلب بوصفها IVA، وتُبلَّغ البنود غير الخاضعة للضريبة بشكل منفصل.

Webhooks موقّعة: تؤكد Webhooks الاختيارية الدفعات التي فُقدت استجابة واجهتها البرمجية، وتضيف ملاحظات عن عمليات الإلغاء (void) والاستردادات التي تتم من Kushki Console. تُرفض الإشعارات التي لا يصحّ توقيعها.

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

وضعا الاختبار والإنتاج: معرّفات Merchant ID وتوقيعات Webhook منفصلة لكل وضع. تتم الاستردادات دائمًا في الوضع الذي تمت فيه الدفعة.

استرداد كامل من صفحة الطلب: تسترد علامة VibeFox Kushki Payment في الطلب كامل المبلغ الذي خصمته Kushki، وتعرض رقم التذكرة والمرجع وسجل الاستردادات وملاحظات Kushki.

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

المتطلبات

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