VibeFox CorvusPay for OpenCart — المساعدة
المتطلبات
OpenCart: 3.0.x (تم الاختبار على 3.0.5.0) أو 4.0.2 وما بعده (تم الاختبار على 4.1.0.3).
PHP: 8.0 أو أحدث.
العملة: AUD أو BAM أو BHD أو CAD أو CHF أو CZK أو DKK أو EUR أو GBP أو HRK أو HUF أو ISK أو MKD أو NOK أو PLN أو RON أو RSD أو RUB أو SEK أو USD. وفي أي عملة أخرى لصفحة الدفع تُخفى طريقة الدفع عند الدفع. تُرسل المبالغ بمنزلتين عشريتين؛ ويُرفض أي إجمالي بمنازل عشرية أكثر (مثل العملات ذات 3 منازل عشرية كـ BHD) بدلًا من تقريبه.
حساب CorvusPay: تحتاج إلى حساب تاجر لدى CorvusPay. تُصدر CorvusPay معرّف Store ID ومفتاح Secret Key لكل متجر، بشكل منفصل لمتجر الاختبار ومتجر الإنتاج؛ وتظهر في CorvusPay Merchant Center. ويجب إدخال Success URL وCancel URL الخاصين بالإضافة هناك (انظر Configuration).
مفتاح ترخيص VibeFox: يُشترى من vibefox.net. يعمل المفتاح الواحد على نطاق واحد.
التثبيت
التنزيل ملف zip واحد يحتوي على الحزم الخاصة بالإصدارين من OpenCart. فُكّ ضغطه على حاسوبك. ويحتوي على README.txt، وحزمة OpenCart 3 wcp_corvuspay_gateway-oc3-(version).ocmod.zip، وحزمة OpenCart 4 wcp_corvuspay_gateway.ocmod.zip. ثبّت الحزمة الخاصة بإصدار OpenCart لديك فقط. مفتاح الترخيص واحد للإصدارين.
OpenCart 3
1. في لوحة الإدارة، انتقل إلى Extensions > Installer، ثم انقر على Upload واختر الملف wcp_corvuspay_gateway-oc3-(version).ocmod.zip. لا تحتوي الإضافة على تعديلات OCMOD، لذلك لا يلزم تحديث Extensions > Modifications. وبدلًا من أداة التثبيت، يمكنك أيضًا نسخ محتويات مجلد upload من هذه الحزمة إلى المجلد الجذر لمتجرك.
2. انتقل إلى Extensions > Extensions واختر النوع Payments. ابحث عن VibeFox CorvusPay Gateway وانقر على Install (زر + الأخضر). يحتاج مستخدم الإدارة الخاص بك إلى صلاحية تعديل قائمة إضافات الدفع.
3. انقر على Edit (زر القلم) لفتح صفحة الإعدادات. الصق مفتاح ترخيص VibeFox في الحقل License key ضمن كتلة الترخيص في أعلى الصفحة، ثم انقر على Activate (انظر License key).
4. أدخل Store ID وSecret Key لمتجر الاختبار في CorvusPay (وكذلك لمتجر الإنتاج من أجل المدفوعات الحقيقية). انسخ Success URL وCancel URL المعروضين في صفحة الإعدادات إلى CorvusPay Merchant Center، لمتجر الاختبار ولمتجر الإنتاج.
5. فعّل Enable/Disable وانقر على Save. أجرِ طلب اختبار، ثم أوقف تفعيل Test Mode للانتقال إلى الإنتاج.
OpenCart 4
1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف wcp_corvuspay_gateway.ocmod.zip. لا تُغيّر اسم الملف: يأخذ OpenCart 4 رمز الإضافة من اسم الملف، ولا تعمل الحزمة إذا أُعيدت تسميتها.
2. تظهر الحزمة في قائمة الإضافات المثبتة في الصفحة نفسها. انقر على Install (زر + الأخضر) بجانبها.
3. انتقل إلى Extensions > Extensions واختر النوع Payments. ابحث عن VibeFox CorvusPay Gateway وانقر على Install (زر + الأخضر)، ثم على Edit (زر القلم).
4. أدخل مفتاح الترخيص وبيانات متجر CorvusPay وعناوين Merchant Center URLs كما في الخطوات من 3 إلى 5 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين. العنوانان Success URL وCancel URL فقط مختلفان (انظر Success URL وCancel URL).
يبدأ التثبيت الجديد بطريقة الدفع معطّلة ووضع الاختبار مفعّلًا.
Configuration
توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox CorvusPay Gateway > Edit. تظهر الأقسام في القائمة الموجودة على اليسار، ويحفظ الزر Save أسفل القائمة الصفحة كاملة. وتظهر فوق الإعدادات الرسالة Test mode is on. Payments go to the CorvusPay test environment — no real money is taken. أثناء تفعيل وضع الاختبار، كما تظهر تحذيرات عندما تكون البوابة مفعّلة بينما Store ID أو Secret Key للوضع الحالي فارغان (وفي هذه الحالة تُخفى طريقة الدفع في صفحة الدفع حتى يُملآ)، وعندما لا تكون عملة متجرك الافتراضية مدعومة من CorvusPay. ومن دون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.
عند الحفظ، يجب ألا يتجاوز الحقل Title 128 حرفًا، ويجب أن يكون Sort Order عددًا صحيحًا، ويجب ألا يكون Minimum Total سالبًا، ويجب أن تكون منطقة Geo Zone المختارة وحالات الطلب موجودة؛ وإلا فلن يُحفظ شيء وتعرض الصفحة الأخطاء.
CorvusPay
Enable/Disable: Enable CorvusPay Gateway. تفعّل طريقة الدفع أو تعطّلها. Default: off.
Title: اسم طريقة الدفع الذي يراه العميل في صفحة الدفع، وهو أيضًا الاسم المحفوظ لطريقة الدفع في الطلب. Default: Credit/Debit Card (CorvusPay). حتى 128 حرفًا؛ وإذا تُرك فارغًا يُعرض الاسم الافتراضي.
Description: النص الذي يظهر للعميل في خطوة Confirm Order، فوق زر التأكيد. Default: Pay securely with your credit or debit card via CorvusPay. وفي وضع الاختبار تُضاف إليه العبارة (Test mode — no real payment is taken.)
Sort Order: ترتيب CorvusPay بين طرق الدفع في صفحة الدفع. اتركه فارغًا أو أدخل عددًا صحيحًا.
Geo Zone: اعرض CorvusPay فقط لعناوين الدفع الواقعة ضمن المنطقة الجغرافية المختارة. Default: All zones. تُعدّ المناطق الجغرافية في System > Localisation > Geo Zones.
Minimum Total: إجمالي الطلب، بالعملة الافتراضية للمتجر، الذي يجب أن يصل إليه الطلب قبل عرض CorvusPay. اتركه فارغًا إذا لم يكن هناك حد أدنى.
بيانات اعتماد المتجر
يصدر CorvusPay معرّف Store ID ومفتاح Secret Key لكل متجر (للاختبار والإنتاج بشكل منفصل)، ويظهران في CorvusPay Merchant Center.
Test Mode: يستخدم بيئة اختبار CorvusPay (wallet.test.corvuspay.com) مع Store ID وSecret Key الخاصين بالاختبار. Default: on. عطّله لاستقبال مدفوعات حقيقية عبر wallet.corvuspay.com.
Test Store ID: معرّف Store ID الرقمي لمتجر الاختبار الخاص بك في CorvusPay.
Test Secret Key: مفتاح Secret Key لمتجر الاختبار الخاص بك في CorvusPay، ويُستخدم في توقيعات HMAC-SHA256.
Live Store ID: معرّف Store ID الرقمي لمتجر الإنتاج الخاص بك في CorvusPay.
Live Secret Key: مفتاح Secret Key لمتجر الإنتاج الخاص بك في CorvusPay، ويُستخدم في توقيعات HMAC-SHA256.
يجب أن يحتوي Store ID على أرقام فقط. وإذا أدخلت شيئًا آخر، تعرض الصفحة … must contain digits only — the previous value was kept.، لكن بقية الحقول تُحفظ على أي حال. ولا تُعرض مفاتيح Secret Key المحفوظة مرة أخرى: يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. ولا تُدخل قيمة جديدة إلا إذا أردت تغييرها. ولحذف مفتاح محفوظ، ضع علامة على Clear the saved value on save أسفل الحقل، ثم انقر على Save. يُتحقق من أي دفعة دائمًا بمفتاح Secret Key للمتجر الذي بدأت فيه، لذلك أبقِ مفتاح الاختبار معبّأً ما دامت دفعات الاختبار قد تعود.
Success URL وCancel URL
انسخ العنوانين المعروضين تحت Merchant Center URLs إلى CorvusPay Merchant Center، لمتجر الاختبار ولمتجر الإنتاج. تعيد CorvusPay العميل إليهما بعد الدفع. وهما مبنيان من عنوان الواجهة الأمامية لمتجر OpenCart الخاص بك؛ انسخهما تمامًا كما تعرضهما الصفحة.
الدفع
Transaction Type: طريقة خصم مبلغ البطاقة.
Payment Page Language: لغة صفحة الدفع في CorvusPay. يستخدم Site language (الافتراضي) لغة المتجر الحالية عندما تدعمها CorvusPay، وإلا فالإنجليزية. ويمكنك أيضًا اختيار Hrvatski أو English أو Deutsch أو Italiano أو Srpski أو Slovenščina.
Order Status After Payment: حالة الطلب بعد دفعة Sale ناجحة. تشير الخيارات إلى حالات OpenCart المختارة في قسم Order statuses.
حالات الطلب
ينشئ OpenCart الطلب في خطوة Confirm Order من دون حالة (طلب مفقود). وهذه هي حالات OpenCart التي تضبطها البوابة؛ وكل حقل يعرض حالات الطلب في OpenCart لديك. ولا توجد في OpenCart حالة On hold، لذلك تُستخدم حالة المراجعة في حالة Authorize only، وعند اختلاف المبلغ أو العملة، وعند الدفعات التي تأتي بعد إلغاء؛ وتشرح ملاحظة الطلب السبب.
Processing status: يُستخدم عندما تكون Order Status After Payment هي Processing. Default: Processing.
Completed status: يُستخدم عندما تكون Order Status After Payment هي Completed. Default: Complete.
On hold (review) status: Authorize only، أو اختلاف المبلغ أو العملة، أو دفعة بعد إلغاء، أو عندما تكون Order Status After Payment مضبوطة على On hold. Default: Pending. يمكنك إنشاء حالة خاصة بك في System > Localisation > Order Statuses واختيارها هنا.
متقدم
Logging: يكتب معلومات التصحيح في corvuspay_p_debug.log.php داخل مجلد سجلات OpenCart (storage/logs). ولا يمكن فتح الملف من الويب. وتُسجَّل الأخطاء دائمًا حتى عند إيقاف هذا الخيار؛ ولا تُسجَّل أبدًا المفاتيح السرية والتوقيعات وبيانات العملاء. Default: off.
Log: يعرض حجم السجل وأحدث إدخالاته. انقر على Clear log لتفريغه.
Delete Data: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة وملفات السجل. وتُحفظ دائمًا الطلبات وبيانات معاملات CorvusPay. Default: off.
الاستيراد / التصدير
Export: تحفظ Download JSON الإعدادات في ملف JSON. ولا تُصدَّر مفاتيح Secret Key.
Import: الصق ملف JSON المُصدَّر سابقًا، ثم انقر على Import لاستعادة الإعدادات. تبقى مفاتيح Secret Key المحفوظة كما هي.
الدفع
في خطوة Payment Method يختار العميل طريقة الدفع (وهي Credit/Debit Card (CorvusPay) افتراضيًا). وفي خطوة Confirm Order يرى العميل وصفك؛ وينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بلا حالة. وعندما ينقر العميل على Confirm Order، تعرض الصفحة Redirecting to CorvusPay for payment. Please wait... وترسل النموذج الموقّع إلى صفحة الدفع في CorvusPay. وإذا لم تبدأ إعادة التوجيه، ينقر العميل على Pay via CorvusPay. ويُرسل إجمالي الطلب بعملة الطلب، ووصف قصير (Order ورقم الطلب واسم المتجر)، وبيانات عنوان العميل وبريده الإلكتروني (لملء صفحة الدفع مسبقًا). ويُعاد استخدام رقم طلب CorvusPay نفسه ما دام المبلغ والعملة والوضع ونوع المعاملة لم تتغير، ولا تقبل CorvusPay دفعة ثانية له. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع. وإذا لم يطلب المتجر عنوان دفع (وهو الإعداد الافتراضي في OpenCart 4)، تُؤخذ بيانات حامل البطاقة من اسم العميل وعنوان التوصيل.
بعد الدفع، تعيد CorvusPay العميل إلى Success URL. ولا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكده CorvusPay: يجب أن يكون رقم طلب CorvusPay صادرًا عن هذا المتجر، ويجب أن يطابق التوقيع المفتاح Secret Key للمتجر الذي بدأت فيه الدفعة، ويجب أن يطابق المبلغ والعملة الطلب. ثم يحصل الطلب على حالته بالطريقة المعتادة في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart مع العبارة Your CorvusPay payment has been received. وفي حالة Authorize only تعرض الصفحة Your CorvusPay payment has been authorized. The amount will be charged when the shop processes your order.، وبالنسبة إلى طلب في حالة المراجعة Your payment was received and is being reviewed by the shop.
إذا تعذّر تطبيق الدفعة في تلك اللحظة (مثلًا لأن طلبًا آخر يؤكد الطلب نفسه)، يرى العميل Your payment is being confirmed مع زر Check again، يقوده إلى صفحة النجاح بمجرد أن يحصل الطلب على حالة. وإذا تعذّر التحقق من طلب Success URL، يرى العميل Payment not confirmed وWe could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. ولا يتغير أي شيء. ويعمل Success URL أيضًا والمتجر في وضع الصيانة: يسمح OpenCart 3 بمرور طلبات إضافات الدفع، ويضيف الإضافة في OpenCart 4 إجراء بدء تشغيل (startup action) لعناوين Success URL وCancel URL. وفي OpenCart 4 لا يرسل المتصفح جلسة المتجر عندما ترجع CorvusPay العميل، لذلك تعرض الإضافة أولًا صفحة قصيرة تفتح العنوان نفسه من متجرك مرة أخرى: يحتفظ العميل بالسلة وبتسجيل الدخول.
إذا ألغى العميل في صفحة CorvusPay، يبقى الطلب بلا حالة، ويعود العميل إلى صفحة الدفع وسلته سليمة مع الرسالة The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. وفي OpenCart 4 تظهر هذه الرسالة فوق صفحة الدفع. وينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، بينما يحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، وتحصل المحاولة الجديدة على رقم طلب CorvusPay جديد؛ وإذا كان طلب آخر من السلة نفسها مدفوعًا بالفعل، يُنقل العميل إلى صفحة النجاح بدلًا من الدفع مرة أخرى.
يحتفظ OpenCart 4 بالطلب في صفحة الدفع حتى تُعرض صفحة النجاح. إذا أُغلق ذلك الطلب في هذه الأثناء دون دفع (مثلًا لأنك ألغيته)، فإن Confirm Order أو العودة من CorvusPay يعيد العميل إلى صفحة الدفع مع الرسالة Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order.. وإذا كان للطلب حالة بالفعل وتغيّرت السلة منذ ذلك (منتجات أخرى أو كميات مختلفة)، فإن الرسالة هي Your previous order is already placed. The cart has changed since then: please confirm the new order to pay for it. وفي الحالتين يدفع Confirm Order التالي طلبًا جديدًا للسلة.
إذا تعذّر بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر: CorvusPay is not configured. Please choose another payment method.، أو CorvusPay does not accept payments in …، أو This order total cannot be paid via CorvusPay (it must be greater than zero with at most 2 decimals). Please choose another payment method.
لا يُؤكَّد الطلب إلا عندما تعيد CorvusPay العميل إلى Success URL؛ ولا توجد إشعارات من خادم إلى خادم. وإذا أغلق العميل المتصفح مباشرة بعد الدفع، يبقى الطلب بلا حالة. ولا تدعم الإضافة الاسترداد أو التحصيل أو الإلغاء من OpenCart (تتطلب واجهة CorvusPay على الخادم شهادة عميل)، ولا توجد بطاقات محفوظة أو اشتراكات أو أقساط أو نموذج بطاقة داخل المتجر.
الطلبات
حالات الطلب
بدون حالة (طلب مفقود): أُرسل العميل إلى CorvusPay ولم يعد بدفعة مؤكدة، أو ألغى الدفع. وفي Sales > Orders لا تظهر هذه الطلبات إلا عند ضبط فلتر Order Status على Missing Orders. وإذا دفع العميل ولم يعد، فتحقق من الدفعة في CorvusPay Merchant Center واضبط حالة الطلب يدويًا.
Processing أو Completed أو حالة المراجعة: تم تأكيد دفعة Sale. وتتبع الحالة Order Status After Payment. وتعرض ملاحظة رقم طلب CorvusPay، ورمز الموافقة، ونوع البطاقة.
حالة المراجعة، معتمد: Authorize only هو الخيار المحدد. حصّل الدفعة في CorvusPay Merchant Center، ثم غيّر حالة الطلب.
حالة المراجعة، اختلاف المبلغ أو العملة: المبلغ أو العملة المدفوعان لا يطابقان الطلب. لا تشحن قبل التحقق من الدفعة في CorvusPay Merchant Center.
حالة المراجعة، دفعة بعد الإلغاء: وصلت دفعة ناجحة لمحاولة دفع كان العميل قد ألغاها. أنجز الطلب أو استرد الدفعة في CorvusPay Merchant Center.
إذا وصلت دفعة ناجحة أخرى لطلب مدفوع بالفعل، فلن يتغير الطلب. وتطلب منك ملاحظة التحقق من CorvusPay Merchant Center واسترداد الدفعة المكررة عند الحاجة. وإذا وصلت دفعة لطلب آخر من السلة نفسها بينما طلب واحد مدفوع بالفعل، يبقى ذلك الطلب بلا حالة وتُضاف الملاحظة إلى الطلب المدفوع.
الملاحظات هي إدخالات في History الطلب لا يراها العميل.
تبويب VibeFox CorvusPay Gateway
في Sales > Orders افتح طلبًا مدفوعًا عبر CorvusPay. وفي أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox CorvusPay Gateway رقم طلب CorvusPay (CorvusPay order number)، وStatus لمحاولة الدفع، وTransaction type، وAmount (والمبلغ المستلم إن أبلغت CorvusPay عنه)، وApproval code، وTransaction، ونوع Card، وCorvusPay notes. وتُعلَّم مدفوعات الاختبار بالعلامة Test. والتبويب للقراءة فقط، ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.
الاستردادات: لا تُدعم الاستردادات والتحصيلات والإلغاءات من OpenCart. نفّذها في CorvusPay Merchant Center وسجّل النتيجة يدويًا في OpenCart. ولا تُعيد مرتجعات المنتجات في Sales > Returns أي مبلغ عبر CorvusPay.
مفتاح الترخيص
تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox CorvusPay Gateway هي أول كتلة في Extensions > Extensions > Payments > VibeFox CorvusPay Gateway > Edit، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مموَّهًا، والحالة (مثل تاريخ انتهاء الترخيص ونطاقك)، والأزرار Check now لإعادة فحص الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها السطر Product: opencart-payment-corvuspay والرابط 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.
من دون مفتاح نشط لا تُعرض CorvusPay للعملاء في صفحة الدفع. وإذا بدأ الدفع رغم ذلك، فسيرى العميل This payment method is not available. Please choose another one. ويظل مستخدم الإدارة الذي سجّل الدخول إلى لوحة الإدارة في المتصفح نفسه يرى طريقة الدفع في المتجر، ومعلَّمة بـ (unlicensed — visible to admins only)، لتتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. وفي OpenCart 4 لا تتوفر هذه المعاينة: فالمتجر لا يرى تسجيل دخول الإدارة، لذلك تبقى طريقة الدفع بدون مفتاح نشط مخفية عن الجميع. وبعد أن تفتح صفحة Edit مرة واحدة، يظهر تذكير في Dashboard الخاصة بلوحة الإدارة. أغلقه بـ × لإخفائه لمدة 7 أيام. ولا تتأثر الطلبات الحالية: فالدفعات التي بدأت بالفعل تُؤكَّد عندما يعود العميل من CorvusPay.
عند انتهاء صلاحية الترخيص، تستمر الإضافة في العمل، لكن التحديثات والدعم تحتاج إلى تجديد. وتُعاد مراجعة الحالة تلقائيًا عند فتح Dashboard أو صفحة Edit في لوحة الإدارة: مرة واحدة يوميًا خلال أول 14 يومًا بعد إدخال المفتاح، ثم مرة واحدة أسبوعيًا. ولا حاجة إلى مهمة cron. ويؤدي إلغاء تثبيت الإضافة دائمًا إلى حذف مفتاح الترخيص وحالة الترخيص.
استكشاف الأخطاء وإصلاحها
لا تظهر CorvusPay في صفحة الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن Store ID وSecret Key للوضع الحالي مملوءان (Test Store ID وTest Secret Key في وضع الاختبار، وLive Store ID وLive Secret Key في وضع الإنتاج)، وأن عملة الدفع مدعومة من CorvusPay. وتحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المختارة، ومن أن الطلب يبلغ Minimum Total.
تمت عملية الدفع لكن الطلب بقي بلا حالة: على الأرجح أن Success URL غير مُدخل في CorvusPay Merchant Center، أو أن Secret Key في OpenCart لا يطابق المتجر. ابحث عن INVALID signature في حقل Log في صفحة الإضافة (الأخطاء تُسجَّل دائمًا). ويبقى الطلب بلا حالة أيضًا إذا أغلق العميل المتصفح قبل العودة؛ وفي هذه الحالة تحقق من الدفعة في Merchant Center واضبط حالة الطلب يدويًا.
يرى العميل Payment not confirmed: رُفض طلب Success URL: كانت حقول مطلوبة مفقودة، أو لم يُصدر رقم طلب CorvusPay عن هذا المتجر، أو كان Secret Key لذلك المتجر فارغًا، أو لم يطابق التوقيع. لا يتغير أي شيء. ويعرض السجل السبب.
يرى العميل Your payment is being confirmed لفترة طويلة: تعذّر ضبط حالة الطلب. يعرض السجل السبب؛ تحقق من الدفعة في Merchant Center.
يرى العميل This order total cannot be paid via CorvusPay: الإجمالي صفر، أو له أكثر من منزلتين عشريتين.
يرى العميل CorvusPay is not configured أو CorvusPay does not accept payments in …: Store ID أو Secret Key للوضع الحالي مفقود، أو عملة الدفع غير مدعومة.
يرى العميل This payment method is not available. Please reload the checkout page.: لم تعد جلسة الدفع مطابقة للطلب، أو أُوقفت طريقة الدفع في الأثناء. يعيد العميل تحميل صفحة الدفع.
الطلب في حالة المراجعة: اقرأ الملاحظات في تبويب VibeFox CorvusPay Gateway. إما أن Authorize only مختار، أو أن المبلغ أو العملة المدفوعين لم يطابقا الطلب، أو أن الدفعة وصلت بعد أن ألغى العميل، أو أن Order Status After Payment مضبوطة على On hold.
للمطورين: قبل توقيع النموذج تُطلق الإضافة حدث OpenCart باسم corvuspay_p_form_params مع حقول النموذج والطلب.
إلغاء التثبيت
انتقل إلى Extensions > Extensions، واختر النوع Payments، ثم انقر على Uninstall (الزر الأحمر −) بجوار VibeFox CorvusPay Gateway. يُحذف دائمًا مفتاح ترخيص هذه الإضافة وحالة الترخيص. ويحذف OpenCart دائمًا إعدادات الإضافة الخاصة به: Enable/Disable وSort Order وGeo Zone وMinimum Total وحالات قسم Order statuses، التي تعود إلى قيمها الافتراضية عند إعادة التثبيت. ويُحذف أيضًا حدث OpenCart الخاص بالإضافة (وفي OpenCart 4 أحداثها وإجراء بدء التشغيل الخاص بها، الذي يسمح لـ CorvusPay بالمرور في وضع الصيانة). وإذا كان Delete Data مفعّلًا، تُحذف بقية إعدادات البوابة (العنوان والوصف وStore ID وSecret Key ووضع الاختبار وإعدادات الدفع وتسجيل السجل) وملفات السجل. وإذا كان معطّلًا، تُحفظ لإعادة التثبيت لاحقًا. تُحفظ دائمًا بيانات معاملات CorvusPay، لذلك يعود تبويب CorvusPay للطلبات القديمة بعد إعادة التثبيت. وتحتفظ الطلبات الحالية بملاحظات الدفع الخاصة بها.
في OpenCart 4، لحذف ملفات الإضافة أيضًا، انتقل إلى Extensions > Installer بعد إلغاء التثبيت، وانقر على Uninstall (الزر البرتقالي −) بجوار VibeFox CorvusPay Gateway في قائمة الإضافات المثبتة، ثم على Delete (زر سلة المهملات الأحمر) لحذف الحزمة المرفوعة.
CorvusPay علامة تجارية مسجلة لمالكها. هذه الإضافة غير تابعة لـ CorvusPay ولا تحظى بتأييدها.