VibeFox Helcim for OpenCart — المساعدة

المتطلبات

OpenCart: 3.0.x (تم الاختبار على 3.0.5.0) أو 4.0.2 والإصدارات الأحدث (تم الاختبار على 4.1.0.3).

PHP: الإصدار 8.0 أو أحدث.

HTTPS وPCI DSS: تُدخل بيانات البطاقة في صفحة الدفع الخاصة بمتجرك، ويرسلها خادمك إلى Helcim. لا تُخزَّن هذه البيانات ولا تُسجَّل أبدًا، لكنها تمرّ عبر خادمك؛ لذلك يحتاج متجرك إلى شهادة SSL لصفحة الدفع، ويجب أن تستوفي استضافتك متطلبات PCI DSS (SAQ D).

العملة: تعالج Helcim المدفوعات بعملتي CAD وUSD. يظهر طريقة الدفع فقط عندما تكون عملة صفحة الدفع إحدى Account currencies المحددة في الإضافة.

حساب Helcim: حساب تاجر لدى Helcim في كندا أو الولايات المتحدة، ورمز API يتمتع بصلاحية معالجة المعاملات (انظر Configuration). حساب Helcim التجريبي (developer) اختياري للاختبار.

مفتاح ترخيص VibeFox: يُشترى من vibefox.net. يعمل المفتاح الواحد على نطاق واحد فقط.

التثبيت

التنزيل ملف zip واحد يحتوي على الحزم الخاصة بإصداري OpenCart. فُكّ ضغطه على جهاز الكمبيوتر الخاص بك. يحتوي على README.txt، وحزمة OpenCart 3 wcp_helcim_gateway-oc3-(version).ocmod.zip، وحزمة OpenCart 4 wcp_helcim_gateway.ocmod.zip. ثبّت فقط الحزمة الخاصة بإصدار OpenCart لديك. مفتاح الترخيص هو نفسه للإصدارين.

OpenCart 3

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف wcp_helcim_gateway-oc3-(version).ocmod.zip. لا تحتوي الإضافة على تعديلات OCMOD، لذلك لا حاجة إلى تحديث Extensions > Modifications. وبدلًا من أداة التثبيت، يمكنك نسخ محتويات مجلد upload الموجود في هذه الحزمة إلى المجلد الجذري لمتجرك.

2. انتقل إلى Extensions > Extensions واختر النوع Payments. ابحث عن VibeFox Helcim Gateway وانقر على Install (زر + الأخضر). يحتاج مستخدم الإدارة لديك إلى صلاحية تعديل قائمة إضافات الدفع.

3. انقر على Edit (زر القلم الرصاص) لفتح صفحة الإعدادات. الصق مفتاح ترخيص VibeFox في الحقل License key ضمن كتلة الترخيص في أعلى الصفحة، ثم انقر على Activate (انظر License key).

4. في Helcim، افتح All Tools > Integrations > API Access Configuration، وأنشئ وصولًا إلى API بصلاحية معالجة المعاملات (عمليات الشراء والتفويض المسبق والتحصيل والاسترداد)، ثم انسخ رمزه.

5. الصق الرمز في Live API token، والصق رمز حساب Helcim التجريبي في Test API token إن كان لديك حساب تجريبي.

6. اختر Transaction type وAccount currencies، ثم فعّل Enable / Disable وانقر على Save. للاختبار أولًا، فعّل Test mode وادفع بحسابك التجريبي، ثم أوقفه لاحقًا.

OpenCart 4

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف wcp_helcim_gateway.ocmod.zip. لا تُغيّر اسم الملف: يأخذ OpenCart 4 رمز الإضافة من اسم الملف، ولا تعمل الحزمة إذا تغيّر اسمها.

2. تظهر الحزمة في قائمة الإضافات المثبّتة في الصفحة نفسها. انقر على Install (زر + الأخضر) بجانبها.

3. انتقل إلى Extensions > Extensions واختر النوع Payments. ابحث عن VibeFox Helcim Gateway، وانقر على Install (زر + الأخضر)، ثم على Edit (زر القلم الرصاص).

4. أدخل مفتاح الترخيص ورموز API وإعدادات الدفع كما في الخطوات من 3 إلى 6 لـ OpenCart 3. صفحة الإعدادات وحقولها هي نفسها في الإصدارين.

تبدأ عملية التثبيت الجديدة مع إيقاف طريقة الدفع وإيقاف وضع الاختبار.

الإعدادات

تقع جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit. تُدرج الأقسام على اليسار؛ ويحفظ الزر Save أسفل القائمة الصفحة بأكملها. وفوق الإعدادات، تحذّرك الصفحة إذا لم تكن العملة الافتراضية لمتجرك ضمن Account currencies (عندئذٍ يُعرض Helcim فقط للطلبات بعملة مسموح بها)، وتحذّرك أيضًا، ما دامت طريقة الدفع مفعّلة، إذا كان رمز API الخاص بالوضع الحالي فارغًا (فتُخفى طريقة الدفع عندئذٍ في صفحة الدفع). وإذا لم تكن لديك صلاحية تعديل الإضافة، فستعرض الصفحة الإعدادات لكنها لن تستطيع حفظها.

عند الحفظ، يجب ألّا يكون الحقل Title فارغًا (بحد أقصى 128 حرفًا)، ويجب أن يكون Sort Order عددًا صحيحًا، ويجب أن يكون Total رقمًا أكبر من 0 أو يساويه، ويجب أن تكون كل حالة طلب موجودة. إذا كان هناك خطأ ما، فلن يُحفظ شيء، وستعرض الصفحة قائمة بالأخطاء.

Helcim

Enable / Disable: يقوم Enable Helcim Gateway بتفعيل طريقة الدفع أو إيقافها. الافتراضي: إيقاف.

Title: عنوان طريقة الدفع الذي يظهر في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Credit card (Helcim). مطلوب.

Description: النص الذي يراه العميل في خطوة Confirm Order، فوق نموذج البطاقة. الافتراضي: Pay securely with your credit card.

Sort Order: ترتيب طريقة الدفع في صفحة الدفع. اتركه فارغًا أو أدخل عددًا صحيحًا.

Geo Zone: اعرض نموذج البطاقة فقط لعناوين الدفع الواقعة ضمن المنطقة الجغرافية المحددة. الافتراضي: All zones. تُضبط المناطق الجغرافية في System > Localisation > Geo Zones.

Total: إجمالي الدفع، بالعملة الافتراضية للمتجر، الذي يجب أن يبلغه الطلب حتى تُعرض طريقة الدفع. اتركه فارغًا لعرضها مهما كان المبلغ.

بيانات اعتماد API

في Helcim، انتقل إلى All Tools > Integrations > API Access Configuration، وأنشئ وصول API وانسخ رمزه. امنحه صلاحية معالجة المعاملات لعمليات الشراء والتفويض المسبق والتحصيل والاسترداد. تستخدم حسابات Helcim التجريبية عنوان API نفسه المستخدم في الحسابات الحية، لذلك يستخدم وضع الاختبار ببساطة رمز حساب Helcim التجريبي الخاص بك. يحتوي القسم على رابط لوثائق API الخاصة بـ Helcim.

Live API token: رمز API الخاص بحسابك الحي في Helcim. يُستخدم عندما يكون وضع الاختبار متوقفًا.

Test mode: يستخدم Test API token (حساب Helcim التجريبي). تُرسل المدفوعات والتحصيلات والاستردادات إلى حسابك التجريبي في Helcim، ويرى العملاء إشعار وضع الاختبار. تستخدم عمليات تحصيل الطلب واستراداته دائمًا رمز الوضع الذي دُفع به الطلب. الافتراضي: إيقاف.

Test API token: رمز API الخاص بحساب Helcim التجريبي (developer). يُستخدم عندما يكون وضع الاختبار مفعّلًا.

لا تُعرض الرموز المحفوظة مرة أخرى أبدًا. يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها. ولحذف رمز محفوظ، فعّل خيار Clear the saved token on save أسفل الحقل، ثم انقر على Save.

الدفع

Transaction type: كيفية خصم قيمة البطاقة.

Account currencies: العملات التي يستطيع حسابك في Helcim معالجتها. تُخصم الطلبات دائمًا بعملة الطلب. تُخفى طريقة الدفع في صفحة الدفع للعملات الأخرى.

الطلبات

يُنشأ الطلب في خطوة Confirm Order بدون حالة (طلب مفقود)، ولا يحصل على حالة إلا بعد أن توافق Helcim على البطاقة. يسرد كل حقل حالات الطلبات الخاصة بـ OpenCart.

Order Status After Payment: خُصمت قيمة البطاقة (عملية شراء، أو تحصيل تفويض مسبق). الافتراضي: قيد المعالجة.

Authorized Status: تفويض مسبق: المبالغ محجوزة فقط ولم تُخصم بعد. حصِّلها باستخدام Capture payment في تبويب الطلب. الافتراضي: قيد الانتظار، لأن OpenCart لا يحتوي على حالة On hold.

On Hold (Review) Status: رد Helcim لا يطابق الطلب (موافقة جزئية، أو عملة مختلفة، أو عدم وجود معرّف معاملة، أو اختلاف إجمالي الطلب عن قيمة الخصم). تحقق من المعاملة في Helcim قبل تنفيذ الطلب؛ وتشرح ملاحظة السبب. الافتراضي: قيد الانتظار. يمكنك إنشاء حالاتك الخاصة في System > Localisation > Order Statuses لتمييز الطلبات المفوَّضة عن طلبات المراجعة.

Canceled Status: أُلغي تفويض مسبق غير محصَّل من تبويب الطلب (لم يُخصم من العميل). الافتراضي: ملغى.

Refunded Status: يُضبط بعد استرداد كامل قيمة الدفع من تبويب الطلب. الافتراضي: مسترد.

متقدم

Debug log: يكتب طلبات API واستجاباتها في wc_hlg_debug.log.php داخل مجلد السجلات في OpenCart (storage/logs). لا يمكن فتح الملف من الويب. تُختصر أرقام البطاقات إلى آخر 4 أرقام. لا تُسجَّل أبدًا قيم CVC وتاريخ الانتهاء والرموز والأسماء والعناوين والبريد الإلكتروني وعناوين IP. تُسجَّل الأخطاء (المدفوعات المرفوضة أو الفاشلة، وأخطاء API، والتحصيلات والاستردادات الفاشلة) دائمًا، حتى عندما يكون هذا الخيار متوقفًا. الافتراضي: إيقاف.

Log: يعرض حجم السجل وأحدث إدخالاته. انقر على Clear log لتفريغه.

Delete data on uninstall: عند تفعيله، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة وملفات السجل. تبقى معاملات Helcim واستردادها دائمًا، لذلك يمكن تحصيل الطلبات المدفوعة سابقًا واسترداد قيمتها بعد إعادة التثبيت. الافتراضي: إيقاف.

الاستيراد / التصدير

Export: يحفظ Download JSON الإعدادات في ملف JSON. لا تُصدَّر رموز API.

Import: الصق ملف JSON صُدِّر سابقًا وانقر على Import لاستعادة الإعدادات. تبقى رموز API المحفوظة كما هي.

صفحة الدفع

في خطوة Payment Method، يختار العميل طريقة الدفع (افتراضيًا Credit card (Helcim)). وفي خطوة Confirm Order، يرى العميل أيقونة بطاقة ووصفك ونموذجًا يتضمن Card Number وExpiry (MM/YY) وCVC وCardholder Name. في وضع الاختبار يعرض النموذج TEST MODE — payments go to a Helcim test account, no real charges are made. وينشئ OpenCart الطلب في هذه الخطوة، ولكن بدون حالة بعد. عندما ينقر العميل على Confirm Order، تتحقق الإضافة من المجموع الاختباري لرقم البطاقة، ومن أن تاريخ الانتهاء صالح ولم ينقضِ، ومن أن قيمة CVC مكوّنة من 3 أو 4 أرقام، ومن أن الاسم مُدخل. تُعرض الأخطاء فوق النموذج، ولا يُرسل أي شيء إلى Helcim.

في OpenCart 4 يختار العميل طريقة الدفع بزر Choose الموجود في كتلة طريقة الدفع، في النافذة Payment method options. ثم يظهر نموذج البطاقة في كتلة تأكيد الطلب أسفل صفحة الدفع، فوق زر Confirm Order. افتراضيًا لا يطلب OpenCart 4 عنوان الدفع؛ فترسل الإضافة عنوان الشحن إلى Helcim للتحقق من العنوان، مع اسم حامل البطاقة.

ثم يرسل خادمك البطاقة إلى Helcim كعملية شراء أو تفويض مسبق بإجمالي الطلب بعملة الطلب. ويُرسل اسم حامل البطاقة وعنوان الدفع والهاتف والبريد الإلكتروني للتحقق من العنوان. يظهر الدفع في Helcim برقم فاتورة مكوّن من رقم الطلب و-OC ورمز قصير. ترد Helcim في الطلب نفسه. لا يحصل الطلب على حالته إلا بعد أن توافق Helcim على المعاملة، بالطريقة المعتادة في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون. يُفرَّغ سلة التسوق فورًا، ويصل العميل إلى صفحة نجاح الطلب في OpenCart.

لا تعمل إلا محاولة دفع واحدة لكل سلة في الوقت نفسه، ولا تُخصم قيمة سلة مدفوعة مرة أخرى أبدًا، حتى لو أنشأ OpenCart طلبًا جديدًا لها في الأثناء (في OpenCart 3 يُنشئ طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order؛ وفي OpenCart 4 قد يظل طلب سابق أو تبويب متصفح آخر يحتفظ بالسلة نفسها). يحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، لذلك بعد رفض البطاقة يدفع العميل عن الطلب نفسه. وإذا أُغلق ذلك الطلب في الأثناء (مثلًا ألغيته أنت)، أو كان مدفوعًا بالفعل وصارت السلة تحتوي على عملية شراء جديدة، فإن Confirm Order يعيد العميل إلى صفحة الدفع، وتظهر فوقها الرسالة Your previous order is already closed (cancelled or refunded by the store) or paid for another cart. Please confirm the order again: the cart will be paid with a new order.، ويدفع Confirm Order التالي طلبًا جديدًا للسلة. وأي تغيير في السلة، بما في ذلك كمية جديدة، يُعدّ سلة جديدة تحتاج إلى دفع خاص بها. تستخدم كل محاولة مفتاح idempotency. إذا لم ترد Helcim، يبقى الطلب بدون حالة، وتُعيد المحاولة خلال 5 دقائق النتيجة الأصلية من Helcim بدلًا من خصم البطاقة مرتين. وإذا وُوفق على الدفع لكن تعذّر ضبط حالة الطلب، فإن المحاولة التالية للسلة نفسها تضبط الحالة دون خصم البطاقة مجددًا.

الرسائل التي قد يراها العميل فوق النموذج: Your card was declined. Please check the card details or use another card. عندما ترفض Helcim؛ وPayment failed: مع سبب Helcim للطلبات المرفوضة الأخرى؛ وWe could not confirm your payment with the card processor. Please try again in a minute; if the problem persists, contact us before using another card. عندما لا ترد Helcim؛ وThis payment method is temporarily unavailable. Please choose another payment method. عندما يُرفض رمز API؛ وYour payment is already being processed. Please wait a moment and check your e-mail before trying again. عند الإرسال المزدوج؛ وYour payment was received, but the order could not be completed automatically. Please contact us — do not pay again. عندما تُوافَق على الدفعة لكن تعذّر ضبط حالة الطلب. يبقى العميل في خطوة Confirm Order مع السلة نفسها. وتُرسل التفاصيل الفنية إلى السجل.

لا تستخدم الإضافة HelcimPay.js ولا Helcim.js، لذلك تمر بيانات البطاقة عبر خادمك. وليس فيها بطاقات محفوظة، ولا اشتراكات، ولا مدفوعات ACH أو بنكية، ولا Apple Pay أو Google Pay أو 3-D Secure، ولا webhooks من Helcim.

الطلبات والاستردادات

حالات الطلب

بدون حالة (طلب مفقود): رُفضت البطاقة، أو لم ترد Helcim، أو لم يدفع العميل بعد. تُكتب حالات الرفض والأخطاء في السجل وتُضاف كملاحظات. وفي Sales > Orders لا تظهر هذه الطلبات إلا عند ضبط فلتر Order Status على Missing Orders.

Order Status After Payment (الافتراضي Processing): وافقت Helcim على عملية شراء، أو جرى تحصيل تفويض مسبق. تعرض الملاحظة معرّف المعاملة ورمز الموافقة ونوع البطاقة وآخر 4 أرقام والوضع.

Authorized Status (الافتراضي Pending): وافقت Helcim على تفويض مسبق. المبالغ محجوزة فقط. حصِّلها أو أفرج عنها باسترداد كامل.

On Hold (Review) Status (الافتراضي Pending): وافقت Helcim على معاملة، لكن المبلغ أو العملة أو معرّف المعاملة في ردها لا يطابق الطلب، مثل ما يحدث بعد موافقة جزئية، أو عندما يتغير إجمالي الطلب أثناء الدفع. تقول الملاحظة Helcim response verification FAILED. تحقق من المعاملة في Helcim قبل تنفيذ الطلب.

Refunded Status (الافتراضي Refunded): استُرد الدفع بالكامل من خلال الإضافة.

Canceled Status (الافتراضي Canceled): أُلغي تفويض مسبق غير محصَّل. لم يُخصم من العميل.

الملاحظات هي إدخالات في History الطلب لا يراها العميل.

تبويب VibeFox Helcim Gateway

في Sales > Orders افتح طلبًا دُفع عبر Helcim. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox Helcim Gateway معرّف Transaction ID (ومعرّف التفويض المسبق بعد التحصيل) مع الوسم Test mode للمدفوعات التجريبية، وTransaction type وحالة التحصيل، وInvoice، وCard ورمز الموافقة، والمبالغ Approved / order / refunded، وزر التحصيل ونموذج الاسترداد، وسجل الاستردادات، وHelcim notes الخاصة بالطلب. يظهر التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة؛ ويحتاج التحصيل والاسترداد إلى صلاحية التعديل (تُضبط في System > Users > User Groups).

التحصيل

بالنسبة إلى تفويض مسبق لم يُحصَّل بعد، انقر على Capture payment في التبويب (يعرض الزر المبلغ) وأكّد Capture the pre-authorized amount through Helcim? يُحصَّل إجمالي الطلب الحالي مطروحًا منه الاستردادات. وقد يكون أقل من المبلغ المفوَّض، لكنه لا يمكن أن يكون أعلى منه. يستخدم التحصيل رمز الوضع الذي دُفع به الطلب. بعد التحصيل الناجح، يحصل الطلب على Order Status After Payment. وإذا فشل التحصيل، يعرض التبويب السبب ويضيفه إلى الملاحظات.

الاستردادات

في التبويب، أدخل Amount (يُملأ المبلغ الذي لم يُسترد بعد)، واختياريًا Reason (optional)، ثم انقر على Refund via Helcim. أكّد Refund this amount through Helcim? This cannot be undone. الاستردادات الكاملة والجزئية لعملية شراء أو تفويض مسبق محصَّل مدعومة، حتى المبلغ الذي خصمته Helcim فعلًا؛ لذلك بعد موافقة جزئية لا يمكنك استرداد أكثر مما دفعه العميل. أما في التفويض المسبق غير المحصَّل، فيصبح الزر Release pre-authorization: لا يمكن الإفراج إلا عن المبلغ كاملًا، ويُزال الحجز، ويحصل الطلب على Canceled Status.

يُرسل الاسترداد في الوضع الذي دُفع به الطلب، لذلك يجب ضبط رمز ذلك الوضع. ولا يُحتسب الاسترداد إلا إذا وافقت عليه Helcim. وإذا رفضته Helcim، يعرض التبويب الخطأ ولا يُسجَّل أي استرداد. ويُضاف الاسترداد الناجح إلى سجل الاستردادات والملاحظات مع معرّف معاملة الاسترداد في Helcim. ويضع الاسترداد الكامل الطلب على Refunded Status دون إشعار العميل، ودون إعادة المنتجات إلى المخزون، تمامًا كما يحدث عند تغيير الحالة يدويًا. ولا يغيّر الاسترداد الجزئي الحالة. ولا تؤدي إعادة المحاولة بعد انتهاء المهلة إلى استرداد مزدوج.

لا تُعيد مرتجعات المنتجات في Sales > Returns الأموال عبر Helcim. لا تستقبل الإضافة webhooks من Helcim: فالتحصيلات والاستردادات والإلغاءات التي تُجرى في لوحة Helcim لا تنعكس في OpenCart، لذلك نفّذها من صفحة الطلب.

مفتاح الترخيص

تعمل الإضافة بمفتاح ترخيص VibeFox يُحصل عليه من vibefox.net. كتلة الترخيص License — VibeFox Helcim Gateway هي الكتلة الأولى في Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مخفيًّا، والحالة (مثل تاريخ انتهاء صلاحية الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها سطر Product: opencart-payment-helcim ورابط Manage licenses and domains in your account الذي يفتح حسابك على vibefox.net. لا يمكن تغيير المفتاح إلا لمستخدمي الإدارة الذين لديهم صلاحية Modify على الإضافة. تتبع نصوص الكتلة لغة الإدارة (وتشمل الإنجليزية والروسية).

إذا لم يُقبل المفتاح، تذكر الكتلة السبب، مثل Key not found أو This key belongs to another product أو Domain limit reached أو License expired on مع تاريخ. بعد تغيير عنوان المتجر، أو بعد تحرير خانة نطاق في حسابك، انقر على Check now. وإذا تعذّر الوصول إلى خادم التراخيص، تواصل الإضافة العمل بآخر حالة معروفة.

يعمل المفتاح الواحد على نطاق واحد فقط: عنوان المتجر في إعدادات OpenCart. ولا يؤدي حذف المفتاح من المتجر إلى تحرير خانة النطاق. حرّر الخانة في حسابك على vibefox.net.

بدون مفتاح فعّال، لا يُعرض Helcim للعملاء في صفحة الدفع. وإذا بدأ الدفع رغم ذلك، فسيرى العميل This payment method is not available. Please choose another one. ويظل مستخدم الإدارة الذي سجّل الدخول إلى الإدارة في المتصفح نفسه يرى طريقة الدفع في المتجر، مع الإشارة (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. على OpenCart 4 لا تتوفر هذه المعاينة: لا يرى المتجر تسجيل دخول الإدارة، لذلك تُخفى طريقة الدفع عن الجميع بدون مفتاح فعّال. وبعد فتح صفحة Edit مرة واحدة، يظهر تذكير في Dashboard الإدارة. أغلقه بالزر × لإخفائه لمدة 7 أيام. لا تتأثر الطلبات الحالية: تبقى المدفوعات التي تمت، وتعمل التحصيلات والاستردادات.

عند انتهاء صلاحية الترخيص، تواصل الإضافة العمل، لكن التحديثات والدعم يتطلبان التجديد. تُعاد مراجعة الحالة تلقائيًا عند فتح Dashboard أو صفحة Edit في الإدارة: مرة واحدة يوميًا خلال أول 14 يومًا بعد إدخال المفتاح، ثم مرة واحدة أسبوعيًا. لا حاجة إلى cron job. وإلغاء تثبيت الإضافة يحذف دائمًا مفتاح الترخيص وحالته.

استكشاف الأخطاء وإصلاحها

لا يظهر Helcim في صفحة الدفع: تحقق من أن الترخيص فعّال، وأن Enable / Disable مفعّل، وأن الوضع الحالي لديه رمز API (Live API token، أو Test API token في وضع الاختبار)، وأن عملة صفحة الدفع إحدى Account currencies. تعرض صفحة الإعدادات تحذيرًا عندما يكون الرمز مفقودًا أو عملة المتجر غير مسموح بها. تحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

رأى العميل الرسالة We could not confirm your payment: لم ترد Helcim، لذلك ربما خُصمت قيمة البطاقة. تذكر ملاحظة الطلب والسجل فاتورة Helcim. تحقق من تلك الفاتورة في Helcim قبل إعادة خصم المبلغ من العميل. تُعيد المحاولة خلال 5 دقائق النتيجة الأصلية، ولا تخصم مرتين.

يرى العملاء الرسالة This payment method is temporarily unavailable: رفضت Helcim رمز API. تقول ملاحظة الطلب إنه يجب التحقق من الرمز وصلاحياته. تأكد من أن وصول API يتمتع بصلاحية معالجة المعاملات.

يرى العملاء الرسالة This payment method is not available. Please reload the checkout page.: لم تعد جلسة الدفع تطابق الطلب، أو أُوقفت طريقة الدفع في الأثناء، أو لم يعد الرمز أو العملة مناسبين. يعيد العميل تحميل صفحة الدفع.

فشل الدفع بسبب من Helcim: رفضت Helcim الطلب، مثلًا بسبب البطاقة أو بيانات الفوترة. تحتوي ملاحظة الطلب والسجل على التفاصيل.

رأى العميل الرسالة Your payment was received, but the order could not be completed: وافقت Helcim على الدفع، لكن OpenCart لم يتمكن من ضبط حالة الطلب. يذكر السجل السبب. عندما يُرسل العميل السلة نفسها مرة أخرى، تُضبط الحالة من الدفعة المعتمدة دون خصم ثانٍ.

الطلب في حالة المراجعة: اقرأ الملاحظات في تبويب VibeFox Helcim Gateway. لم يطابق رد Helcim الطلب (فشل التحقق من الرد). تحقق من المعاملة في Helcim، ثم نفّذ الطلب أو استرد الدفعة.

التحصيل غير ممكن: يجب أن يكون المبلغ المراد تحصيله أكبر من 0 ولا يتجاوز المبلغ المفوَّض، ويجب ضبط رمز الوضع الذي دُفع به الطلب.

فشل الاسترداد: اقرأ الرسالة. لا يمكن إلا الإفراج الكامل عن تفويض مسبق غير محصَّل. وتعني رسالة متعلقة بالوضع أن رمز الوضع الذي دُفع به الطلب فارغ. ولا يُسجَّل الاسترداد المرفوض. وتعني الرسالة You do not have permission to capture or refund (modify this extension). أن مجموعة المستخدمين لديك لا تملك صلاحية تعديل الإضافة.

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

إلغاء التثبيت

انتقل إلى Extensions > Extensions، واختر النوع Payments، ثم انقر على Uninstall (الزر الأحمر −) بجوار VibeFox Helcim Gateway. يُحذف مفتاح الترخيص وحالة الترخيص لهذه الإضافة دائمًا. يحذف OpenCart دائمًا إعدادات الإضافة الخاصة به: Enable / Disable وSort Order وGeo Zone وTotal وحالات الطلبات في قسم Orders، والتي تعود إلى قيمها الافتراضية عند إعادة التثبيت. على OpenCart 4 يُحذف أيضًا حدث OpenCart الخاص بالإضافة، الذي يعرض الرسالة فوق صفحة الدفع. وإذا كان Delete data on uninstall مفعّلًا، تُحذف بقية إعدادات البوابة (العنوان والوصف ورموز API ووضع الاختبار ونوع المعاملة وعملات الحساب ومفتاح سجل التصحيح) والسجل. وإذا كان متوقفًا، تُحفظ لإعادة التثبيت لاحقًا. تبقى معاملات Helcim واستردادها دائمًا، لذلك يمكن تحصيل الطلبات المدفوعة سابقًا واسترداد قيمتها بعد إعادة التثبيت. وتحتفظ الطلبات الحالية بملاحظات الدفع الخاصة بها.

على OpenCart 4، ولحذف ملفات الإضافة أيضًا، انتقل إلى Extensions > Installer بعد إلغاء التثبيت، وانقر على Uninstall (الزر البرتقالي −) بجانب VibeFox Helcim Gateway في قائمة الإضافات المثبّتة، ثم على Delete (زر سلة المهملات الأحمر) لحذف الحزمة المرفوعة.

Helcim علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ Helcim ولا تحظى بتأييدها.