VibeFox Helcim for OpenCart

نظرة عامة

تضيف VibeFox Helcim Gateway مدفوعات البطاقات الائتمانية عبر Helcim Payment API إلى OpenCart 3 وOpenCart 4. في الخطوة الأخيرة من الدفع يُدخل العميل بطاقته في نموذج يظهر فوق زر Confirm Order، ويرسل خادمك البيانات إلى Helcim، وتُحدَّد حالة الطلب من رد Helcim في الطلب نفسه. تُقبل بطاقات Visa وMastercard وAmerican Express وDiscover وUnionPay، بالدولار الكندي CAD أو الدولار الأمريكي USD.

تناسب المتاجر في كندا والولايات المتحدة التي لديها حساب Helcim وتريد عرض نموذج البطاقة مباشرةً في صفحة الدفع. تمر بيانات البطاقة عبر خادم الويب الخاص بك، لذا يحتاج متجرك إلى HTTPS واستضافة متوافقة مع PCI DSS (SAQ D). لا تتضمن الإضافة بطاقات محفوظة ولا اشتراكات ولا مدفوعات ACH أو التحويلات المصرفية ولا Apple Pay أو Google Pay أو 3-D Secure، ولا webhooks من Helcim: فعمليات التحصيل والاسترداد والإلغاء التي تُجرى في لوحة Helcim لا تظهر في OpenCart.

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

نموذج البطاقة في صفحة الدفع: رقم البطاقة وتاريخ الانتهاء وCVC واسم حامل البطاقة، ويُتحقَّق منها قبل الإرسال (المجموع الاختباري لرقم البطاقة، وعدم انتهاء الصلاحية، وطول CVC).

شراء أو تفويض مسبق: اخصم قيمة البطاقة فورًا، أو احجز المبلغ فقط ثم حصّله لاحقًا باستخدام Capture payment في تبويب الطلب.

الحالة بعد الموافقة فقط: ينشئ OpenCart الطلب قبل الدفع، لكنه لا يتلقى حالةً إلا بعد أن توافق Helcim على المعاملة، لذلك تترك البطاقة المرفوضة طلبًا ناقصًا فقط. وإذا لم يتطابق المبلغ أو العملة المعتمدان مع الطلب، يُنقل الطلب إلى حالة المراجعة لديك مع ملاحظة.

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

الاستردادات من صفحة الطلب: استرداد كامل أو جزئي من تبويب VibeFox Helcim Gateway في الطلب، حتى المبلغ الذي خصمته Helcim فعليًا. يُفرج عن التفويض المسبق غير المحصَّل بالكامل.

رموز الإنتاج والاختبار: رموز API منفصلة لحسابي Helcim للإنتاج والاختبار. تستخدم عمليات التحصيل والاسترداد دائمًا الحساب الذي دُفع به الطلب.

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

المتطلبات

OpenCart 3.0.x (تم اختباره على 3.0.5.0) أو OpenCart 4.0.2 والإصدارات الأحدث (تم اختباره على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي ملف التنزيل الواحد على الحزم الخاصة بالإصدارين. حساب تاجر لدى Helcim (كندا أو الولايات المتحدة) ورمز API. عملة الدفع CAD أو USD. HTTPS لمتجرك واستضافة متوافقة مع PCI DSS. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).