VibeFox Adyen for PrestaShop

نظرة عامة

تضيف وحدة VibeFox Adyen Gateway المدفوعات عبر روابط الدفع الخاصة بـ Adyen (Adyen Payment Links) إلى PrestaShop. في خطوة الدفع يختار العميل Adyen، ثم يُنقل إلى صفحة الدفع التي تستضيفها Adyen، فيدفع بأي طريقة مفعّلة في حساب التاجر لديك لدى Adyen (البطاقات والمحافظ الرقمية وطرق الدفع المحلية)، ثم يعود إلى متجرك. لا تمر بيانات البطاقة عبر موقعك أبدًا. لا يُنشأ الطلب إلا بعد أن تؤكد Adyen الدفع عبر webhook موقّع، لذلك لا تترك عمليات الدفع المتروكة أي طلبات غير مدفوعة.

تناسب الوحدة المتاجر التي لديها حساب تاجر لدى Adyen وتريد طرق الدفع الخاصة بهذا الحساب دون بناء نموذج دفع في موقعها. لا تتضمن الوحدة اشتراكات أو مدفوعات متكررة، ولا بطاقات محفوظة، ولا حقول بطاقات داخل الموقع (Drop-in أو Components)، ولا أزرار للتحصيل أو الإلغاء في PrestaShop. ويتبع التحصيل إعدادات حسابك لدى Adyen.

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

Adyen Payment Links: يُنشأ رابط دفع بإجمالي السلة بعملة السلة، بالوحدات الصغرى التي تتطلبها Adyen لكل عملة (بلا منازل عشرية مثل JPY وKRW وIDR، وبثلاث منازل عشرية مثل KWD وBHD).

الدفع يُعتمد فقط عند تأكيد Adyen: لا يُنشأ الطلب إلا عبر webhook من نوع AUTHORISATION موقّع بـ HMAC. والعودة إلى المتجر لا تُنشئ الطلب ولا تدفعه أبدًا.

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

لا معالجة مزدوجة: الإرسالات المكررة أو المتوازية للـ webhook لا تُنشئ طلبًا ثانيًا ولا تسجّل الدفعة مرتين. ومحاولة دفع جديدة تُنهي صلاحية رابط الدفع السابق، وأي دفعة ناجحة ثانية لطلب مدفوع تضيف ملاحظة تحذير.

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

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

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

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

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث. حساب تاجر لدى Adyen مع مفاتيح API، وwebhook من نوع Standard بمفتاح HMAC، وللمدفوعات الحقيقية بادئة عنوان URL للإنتاج (Live URL prefix). ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).