VibeFox Stripe for PrestaShop

نظرة عامة

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

تناسب المتاجر التي تريد قبول البطاقات عبر حساب Stripe دون إنشاء نموذج بطاقة خاص بها على موقعها. تقبل الوحدة مدفوعات البطاقات لمرة واحدة فقط. لا تتضمن البطاقات المحفوظة، ولا الاشتراكات، ولا نموذج البطاقة على الموقع، ولا أزرار Apple Pay أو Google Pay على موقعك، ولا التفويض والتحصيل المنفصلان.

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

Stripe Checkout: تُنشأ جلسة دفع بإجمالي السلة وبعملة السلة، بما في ذلك العملات التي لا تحتوي على منازل عشرية مثل JPY وKRW، والعملات ذات ثلاث منازل عشرية مثل KWD وBHD.

لا يُعتمد الدفع إلا بعد تأكيد Stripe: يُنشأ الطلب بعد تلقي webhook موقَّع من Stripe، أو بعد التحقق من الدفع من جهة الخادم عندما يعود العميل إلى المتجر. ولا يؤدي غياب الـ webhook إلى فقدان الطلبات المدفوعة.

التحقق من المبلغ والعملة: يُقارَن المبلغ والعملة اللذان تُبلغ عنهما Stripe بالسلة. وعند عدم التطابق ينتقل الطلب إلى Stripe payment on hold مع ملاحظة.

لا معالجة مكررة: لا تُنشئ الـ webhooks المتكررة وعودة العميل طلبًا ثانيًا أبدًا، ولا تُسجَّل الدفعة مرتين. وتؤدي محاولة دفع جديدة إلى إغلاق جلسة Stripe السابقة، فلا يستطيع العميل دفع السلة نفسها مرتين.

وضع الاختبار والوضع الحي: مفاتيح سرية منفصلة وأسرار webhook منفصلة لكل وضع. لا تؤكد دفعة الاختبار أبدًا دفعة حقيقية، وتُنفَّذ الاستردادات دائمًا في الوضع الذي تمت فيه عملية الدفع.

الاسترداد من صفحة الطلب: استرداد كامل أو جزئي في كتلة Stripe payment الخاصة بالطلب. ويؤدي الاسترداد الكامل إلى وضع الطلب على Refunded. وتُسجَّل الاستردادات التي تتم في Stripe Dashboard في الطلب.

حالة الطلب التي تختارها: Payment accepted أو Delivered أو Stripe payment on hold للمراجعة اليدوية بعد الدفع الناجح.

كتلة Stripe في صفحة الطلب: الدفعة مع رابط إلى Stripe Dashboard، وسجل الاستردادات، والملاحظات. سجل اختياري لا يتضمن المفاتيح ولا بيانات العملاء.

المتطلبات

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