VibeFox Adyen for OpenCart

نظرة عامة

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

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

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

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

لا يُعتمد الدفع إلا عند تأكيد Adyen: لا تُحدَّد حالة الطلب إلا بواسطة webhook من نوع AUTHORISATION موقَّع بـ HMAC. ولا تؤدي العودة إلى المتجر إلى دفع الطلب أبدًا. ثم يرسل OpenCart رسائل الطلب المعتادة.

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

دون معالجة مزدوجة: لا تسجّل عمليات تسليم webhook المكررة أو المتوازية دفعة واحدة مرتين أبدًا. وتؤدي محاولة دفع جديدة إلى إنهاء روابط الدفع السابقة للطلب والسلة، ويضيف أي دفع ناجح ثانٍ لطلب مدفوع بالفعل ملاحظة تحذير.

وضعا الاختبار والإنتاج: مفاتيح API ومفاتيح HMAC منفصلة لكل بيئة. ولا يؤكد إشعار الاختبار أي دفعة حقيقية أبدًا، وتُرسل المبالغ المستردة دائمًا إلى البيئة وحساب التاجر اللذين تمت بهما الدفعة.

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

حالات الطلب الخاصة بك: اختر حالة OpenCart للطلب المدفوع، وللدفعة قيد المراجعة، وللدفعة الملغاة، وللاسترداد الكامل.

شروط OpenCart والسجل: المنطقة الجغرافية وأدنى إجمالي للطلب وترتيب العرض. سجل بلا مفاتيح API ولا بيانات شخصية للمشتري.

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 أو أحدث (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. يتضمن ملف التنزيل الواحد الحزم الخاصة بالإصدارين. حساب تاجر لدى Adyen مع مفاتيح API، وwebhook من نوع Standard مع مفتاح HMAC، ولمدفوعات الإنتاج بادئة عنوان URL الخاصة بالإنتاج. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).