VibeFox Kushki for PrestaShop

نظرة عامة

تضيف VibeFox Kushki Payment مدفوعات البطاقات عبر Kushki إلى PrestaShop للمتاجر في الإكوادور وكولومبيا. في خطوة الدفع يُدخل العميل بطاقته في نموذج مستضاف من Kushki يظهر داخل صفحة الدفع لديك لكنه تقدمه Kushki. يعيد النموذج رمزًا لمرة واحدة، ويخصم متجرك المبلغ من جهة الخادم عبر واجهة Kushki البرمجية. لا تصل أرقام البطاقات إلى موقعك أبدًا. يُنشأ الطلب فقط بعد أن توافق Kushki على الخصم، لذلك لا تترك المدفوعات المرفوضة أو المتروكة أي طلبات غير مدفوعة.

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

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

نموذج بطاقة Kushki المستضاف: نموذج البطاقة من Kushki في خطوة الدفع من صفحة دفع PrestaShop. تُمرَّر الأقساط (diferido) المختارة في النموذج مع عملية الخصم.

يُعتمد الدفع فقط عند تأكيد Kushki: لا يُنشأ الطلب إلا بعد أن توافق Kushki على الخصم برقم تذكرة. يؤدي اختلاف المبلغ أو العملة الذي تبلغ عنه Kushki إلى وضع الطلب في Kushki payment on hold مع ملاحظة.

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

Webhooks موقعة: تُنشئ الـ Webhooks الاختيارية الطلب لدفعة فُقدت استجابة واجهتها، وتضيف ملاحظات للإلغاءات والاستردادات التي تتم في Kushki Console. تُرفض الإشعارات التي لا يكون توقيعها صالحًا.

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

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

استرداد كامل من صفحة الطلب: كتلة Kushki payment في الطلب تسترد كامل المبلغ الذي خصمته Kushki. يُضبط الطلب على Refunded.

كتلة Kushki في صفحة الطلب: رقم التذكرة والمرجع والبيئة وسجل الاستردادات وملاحظات Kushki الخاصة بالطلب. لا يتضمن السجل معرّفات التاجر ولا رموز البطاقات ولا عناوين بريد العملاء.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. عملة السلة USD أو COP. حساب Kushki يحتوي على Public Merchant ID وPrivate Merchant ID لبيئتي الاختبار والإنتاج، وHTTPS للمدفوعات الفعلية. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).