VibeFox Square for OpenCart

نظرة عامة

تضيف VibeFox Square Gateway مدفوعات البطاقات الائتمانية والخصم عبر Square إلى OpenCart 3 وOpenCart 4. في خطوة Confirm Order يُدخل العميل بطاقته في نموذج البطاقة الآمن الخاص بـ Square (Square Web Payments SDK). يستلم خادمك رمزًا لمرة واحدة فقط ويخصم المبلغ عبر Square Payments API. لا تصل بيانات البطاقة إلى متجرك أبدًا. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن يردّ Square، لذلك تبقى المحاولات المرفوضة طلبات مفقودة.

تناسب الإضافة بائعي Square الذين يريدون قبول مدفوعات البطاقات في صفحة الدفع الخاصة بهم، بعملة موقع Square الخاص بهم: USD أو CAD أو AUD أو JPY أو GBP أو EUR. تقبل الإضافة مدفوعات البطاقات لمرة واحدة، وتُخصم فورًا. لا تشمل البطاقات المحفوظة أو الاشتراكات أو Apple Pay أو Google Pay أو Cash App Pay أو Afterpay أو بطاقات هدايا Square، كما لا تشمل المدفوعات بالتفويض فقط أو webhooks من Square.

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

3-D Secure / SCA: يتم التحقق من المشتري عند تحويل البطاقة إلى رمز، مع إرسال إجمالي الطلب والعملة وعنوان الدفع إلى Square.

يُعتمد الدفع فقط عند تأكيد Square: يحصل الطلب على حالة «مدفوع» فقط لدفعة COMPLETED بالمبلغ الإجمالي نفسه تمامًا، وبالعملة ومرجع الطلب والموقع نفسها. أي أمر غير متوقع يضع الطلب في حالة مراجعة مع ملاحظة.

لا خصم مزدوج: محاولة دفع واحدة لكل سلة في الوقت نفسه، وطلبات idempotent، والمحاولة التي فُقد ردها تُراجَع لدى Square بدلًا من خصم البطاقة مرة أخرى.

فحص بيانات الاعتماد والعملة: يُتحقق من رمز الوصول والموقع لدى Square عند الحفظ. وتُخفى طريقة الدفع للطلبات بعملة لا يستطيع موقع Square تحصيلها.

استردادات من صفحة الطلب: استردادات كاملة وجزئية في تبويب VibeFox Square Gateway للطلب، وتتم دائمًا في البيئة والموقع والمبلغ والعملة الخاصة بالدفعة الفعلية. يضبط الاسترداد الكامل الحالة Refunded.

تبويب Square في صفحة الطلب: معرّف الدفعة مع رابط إلى Square Dashboard، والبطاقة، والإيصال، وسجل الاستردادات، والملاحظات.

رسائل واضحة: يرى العملاء رسائل قصيرة (رُفضت البطاقة، رمز CVV غير صحيح، مطلوب 3-D Secure). تُسجَّل الأخطاء دائمًا دون مفاتيح أو بيانات بطاقة.

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

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 أو أحدث (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي التنزيل الواحد على الحزم لكلا الإصدارين. حساب Square مع تطبيق في Square Developer Dashboard (Application ID وAccess Token وLocation ID). يجب أن تكون عملة الطلب هي عملة موقع Square الخاص بك: USD أو CAD أو AUD أو JPY أو GBP أو EUR. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).