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

المتطلبات

OpenCart: ‏3.0.x (تم اختباره على 3.0.5.0) أو 4.0.2 وما بعده (تم اختباره على 4.1.0.3).

PHP: ‏8.0 أو أحدث.

مشروع Paysera: تحتاج إلى معرّف المشروع وكلمة مرور المشروع (مفتاح التوقيع) لمشروع Paysera الخاص بك. طرق الدفع التي يراها العميل هي الطرق المفعّلة في هذا المشروع. لا يلزم إعداد أي شيء في Paysera لرد الاتصال: يُرسل عنوانه مع كل طلب دفع.

متجر متاح: تحصل الطلبات على حالتها من رد اتصال Paysera، لذلك يجب أن يكون متجرك متاحًا من الإنترنت، لا خلف تسجيل دخول أو مصادقة أساسية أو جدار حماية. يعمل رد الاتصال أيضًا أثناء وضع الصيانة للمتجر.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل Project ID وProject password من حسابك في Paysera (انظر الإعدادات).

5. اختياري: فعّل Allow test payments في مشروع Paysera وTest payments في الإضافة لتجربة العملية دون خصم أموال. أوقفه قبل بدء البيع.

6. فعّل Enable/Disable وانقر على Save.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص ومعرّف المشروع وكلمة المرور وإعدادات الاختبار كما في الخطوات من 3 إلى 6 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين. الفرق الوحيد هو عنوان رد الاتصال (انظر مشروع Paysera).

تبدأ عملية التثبيت الجديدة وطريقة الدفع معطّلة، ودفعات الاختبار معطّلة، والبيئة Production.

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Paysera Payment > Edit. تُدرج الأقسام على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة بأكملها. وفوق الإعدادات تعرض الصفحة Paysera is hidden at checkout until the project ID and the project password are entered. ما دام أحدهما مفقودًا، وتعرض Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders. ما دامت دفعات الاختبار أو بيئة التجربة مفعّلة. وبدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

Paysera

Enable/Disable: Enable Paysera Payment يفعّل طريقة الدفع أو يوقفها. الافتراضي: معطّل.

Title: اسم طريقة الدفع الذي يراه العملاء عند الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Paysera. مطلوب، حتى 128 حرفًا.

Description: النص الذي يراه العميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely via Paysera.

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

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

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

مشروع Paysera

تجد معرّف المشروع وكلمة مرور المشروع في حسابك في Paysera، ضمن Projects and activities، ثم مشروعك، ثم General project settings. يحتوي القسم على رابط لحساب Paysera.

Callback URL: العنوان الذي تستخدمه Paysera لتأكيد كل دفعة. في OpenCart 3 يبدو هكذا: https://your-store/index.php?route=extension/payment/wcp_paysera_payment/callback، وفي OpenCart 4: https://your-store/index.php?route=extension/wcp_paysera_payment/payment/wcp_paysera_payment.callback. ويُبنى من عنوان الواجهة الأمامية لتثبيت OpenCart الخاص بك. يُرسل تلقائيًا مع كل دفعة، لذلك لا يلزم إعداد أي شيء في Paysera، لكن يجب أن يكون متاحًا من الإنترنت. لا تحصل الطلبات على حالتها إلا من ردود الاتصال الموقّعة أو المشفّرة هذه.

Project ID: المعرّف الرقمي لمشروع Paysera الخاص بك. تُقبل الأرقام فقط: أي قيمة أخرى تعطي الخطأ Project ID must contain digits only: the numeric ID of your Paysera project. ولا يُحفظ شيء.

Project password: كلمة مرور المشروع (مفتاح التوقيع). تُوقّع طلبات الدفع وتتحقق من ردود اتصال Paysera. كلمة المرور المحفوظة لا تُعرض مرة أخرى. يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها. لإزالة كلمة المرور المحفوظة، فعّل Clear saved password (tick and save; an empty field keeps the saved value) أسفل الحقل، ثم انقر على Save.

الاختبار

Test payments: يرسل الدفعات في وضع الاختبار، فلا يُخصم أي مبلغ. تعيد Paysera دفعة اختبار ناجحة دون خصم العميل. فعّل أولًا Allow test payments في إعدادات مشروع Paysera. ما دام هذا الخيار مفعّلًا، تُعلِّم دفعات الاختبار الطلبات كمدفوعة؛ وعند إيقافه، تضع دفعة الاختبار الطلب في حالة الانتظار. الافتراضي: معطّل. وطالما هو مفعّل يرى العميل TEST MODE — no money will be charged. في خطوة Confirm Order.

Environment: الوجهة التي يُرسَل إليها العميل. أبقِ Production لمشروع Paysera العادي، حتى لدفعات الاختبار. الافتراضي: Production.

الطلبات

ينشئ OpenCart الطلب في خطوة Confirm Order بدون حالة (طلب مفقود). لا يحصل الطلب على حالة إلا من رد اتصال Paysera. الدفعة الملغاة أو غير المنفذة تترك الطلب بلا حالة، ويمكن للعميل الدفع مرة أخرى. تسرد كل خانة أدناه حالات طلبات OpenCart الخاصة بك.

Order Status After Payment: الحالة التي تُعيَّن عندما تؤكد Paysera الدفع بالمبلغ والعملة المتوقعين. الافتراضي: Processing.

Awaiting Payment Status: قبل البنك أمر الدفع لكنه لم ينفذه بعد. يُعلَّم الطلب كمدفوع عندما تؤكد Paysera الدفعة. الافتراضي: Pending.

On Hold Status: دفعة اختبار (TEST) بينما Test payments معطّل، أو مبلغ أو عملة مختلفان، أو دفعة بعد أن ألغاها العميل. لا يُعلَّم الطلب كمدفوع؛ وتشرح ملاحظة السبب. الافتراضي: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Cancelled Order Status: لا تضبط الإضافة هذه الحالة أبدًا، بل تقرأها فقط: الدفعة التي تصل لطلب في هذه الحالة لا تعيد فتح الطلب، بل تضيف ملاحظة فقط. الافتراضي: Canceled.

متقدم

Debug log: يكتب أحداث الدفع في wc_psr_debug.log.php داخل مجلد السجلات في OpenCart (storage/logs). لا يمكن فتح الملف من الويب. تُكتب الأخطاء والتحذيرات دائمًا؛ أما الخطوات الأخرى فتُكتب فقط عند تفعيل هذا الخيار. لا تُكتب كلمات المرور وبيانات العميل أبدًا. الافتراضي: معطّل.

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

Delete data: عند التفعيل، تُحذف إعدادات الإضافة وسجلها عند إلغاء تثبيتها. تبقى بيانات الطلبات (الطلبات وسجلات دفع Paysera) محفوظة دائمًا. الافتراضي: معطّل.

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

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

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Paysera). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to the Paysera payment window (bank links, cards and other Paysera methods) to complete the payment. وينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بلا حالة. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، ضمن نافذة Payment method options، وينقر على Confirm Order في أسفل صفحة الدفع. وعندما ينقر العميل على Confirm Order، تنشئ الإضافة طلب دفع موقّعًا يتضمن رقم الطلب، وإجمالي الطلب بأصغر وحدة من عملة الطلب، واسم العميل وبريده الإلكتروني وعنوان فوترته، ولغة صفحة المتجر (اللتوانية، واللاتفية، والإستونية، والروسية، والألمانية، والبولندية؛ وإلا فالإنجليزية). يُنقل العميل إلى نافذة دفع Paysera ويختار هناك بنكًا أو بطاقة أو طريقة أخرى.

تؤكد Paysera الدفع عبر رد اتصال من الخادم إلى الخادم. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكده Paysera برد اتصال موقّع؛ فعودة العميل إلى المتجر لا تدفع أي طلب أبدًا. ثم يحصل الطلب على حالته بالطريقة القياسية لـ OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون. عندما يعود العميل بعد رد الاتصال، تُعرض صفحة نجاح الطلب في OpenCart. إذا قبل البنك أمر الدفع ولم ينفذه بعد، يحصل الطلب على Awaiting Payment Status وتعرض الصفحة Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. وللطلب المعلّق تعرض الصفحة Your payment is being reviewed. We will contact you if anything else is needed.

إذا عاد العميل قبل رد الاتصال، تظهر صفحة Payment confirmation توضح أن الطلب سيُؤكَّد بمجرد أن تؤكد Paysera الدفع، وتعرض الخيارين Check again وBack to checkout.

إذا ألغى العميل في نافذة Paysera، يعود إلى الدفع مع الرسالة The Paysera payment was cancelled. You can try again or choose another payment method. وإذا أبلغت Paysera أن الدفعة لم تُنفَّذ، تكون الرسالة The payment was not completed. You can try again or choose another payment method. وتبقى السلة محفوظة في الحالتين. وفي OpenCart 4 تظهر هذه الرسائل أعلى صفحة الدفع. ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، بينما يحدّث OpenCart 4 طلب الدفع (المحاولة الجديدة تدفع الطلب نفسه)؛ وإذا كان طلب آخر من السلة نفسها مدفوعًا أو بانتظار الدفع أو معلّقًا، تنتقل المحاولة الجديدة مباشرة إلى صفحة النجاح بدلًا من دفعة ثانية. ويُعد أي تغيير في السلة، بما في ذلك تغيير الكمية، سلة جديدة تحتاج إلى دفعة خاصة بها.

يبقى الطلب في OpenCart 4 ضمن الدفع حتى تُعرض صفحة النجاح. وإذا أُغلق ذلك الطلب في الأثناء (مثلًا إذا ألغيت طلبًا كان ينتظر الدفع البنكي)، يعود العميل إلى الدفع مع الرسالة Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. وتدفع Confirm Order التالية طلبًا جديدًا. وإذا كان ذلك الطلب قد دُفع من قبل لسلة سابقة وتغيّرت السلة منذ ذلك الحين، يعود العميل إلى الدفع، وتدفع Confirm Order التالية طلبًا جديدًا للسلة الحالية. ولا يظهر الطلب المُغلق أبدًا كمدفوع.

إذا تعذّر بدء الدفعة، يبقى العميل في خطوة Confirm Order مع Paysera payments are temporarily unavailable. Please choose another payment method. أو، لإجمالي طلب غير صالح، مع This order cannot be paid via Paysera. ويُكتب السبب في السجل.

يعمل رد الاتصال أيضًا أثناء وضع الصيانة للمتجر، لأن OpenCart يسمح بمرور طلبات إضافات الدفع (في OpenCart 4 تضيف الإضافة إجراء بدء تشغيل خاصًا بذلك، يسمح أيضًا للعميل بالعودة من Paysera).

لا تتضمن الإضافة استردادات من لوحة الإدارة، ولا اختيار بنك أو طريقة دفع في صفحة الدفع، ولا اشتراكات، ولا بطاقات محفوظة، ولا خدمات توصيل أو مندوبين تابعة لـ Paysera.

الطلبات

حالات الطلب

بدون حالة (طلب مفقود): أُرسل العميل إلى Paysera ولم يصل رد الاتصال بعد، أو ألغى العميل، أو لم تُنفَّذ الدفعة. في Sales > Orders لا تظهر هذه الطلبات إلا عند ضبط فلتر Order Status على Missing Orders.

Order Status After Payment (الافتراضي Processing): أكّدت Paysera الدفع بالمبلغ والعملة المطابقين. تعرض ملاحظة الطلب وطريقة الدفع، وتُوسم بـ (TEST — no money charged) لدفعات الاختبار.

Awaiting Payment Status (الافتراضي Pending): قبلت Paysera أمر الدفع، لكن البنك لم ينفذه بعد. ينتقل الطلب إلى Order Status After Payment عندما تؤكد Paysera الدفع.

On Hold Status (الافتراضي Pending): تحتاج الدفعة إلى مراجعة يدوية. المبلغ أو العملة المدفوعان يختلفان عن إجمالي الطلب؛ أو وصلت دفعة اختبار (TEST) بينما Test payments معطّل (لم يُخصم أي مال)؛ أو أُكّدت الدفعة بعد أن ألغاها العميل. تشرح الملاحظة السبب، وتطلب لوحة الطلب منك التحقق من الدفعة في حسابك في Paysera، ثم ضبط الطلب على الحالة المدفوعة أو إلغائه واسترداد الدفعة في Paysera. وأي دفعة صحيحة لاحقة للطلب نفسه تعلّمه كمدفوع.

Cancelled Order Status (الافتراضي Canceled): الدفعة التي تُؤكَّد لاحقًا لطلب ملغى لا تغيّر حالته. تطلب ملاحظة استعادة الطلب (بضبطه على الحالة المدفوعة) أو استرداد الدفعة في Paysera. وإذا لم تعد طريقة دفع الطلب Paysera، فالدفعة المؤكدة تضيف ملاحظة فقط.

إذا وصلت دفعة ناجحة أخرى لطلب مدفوع بالفعل، أو لطلب آخر من سلة مدفوعة بالفعل، فلا يُعدَّل الطلب المدفوع، وتطلب ملاحظة استرداد المكرر في حسابك في Paysera. أما الحالات الأخرى في Paysera (الدفعة غير منفذة، معلومات إضافية) فتضيف ملاحظة فقط. والملاحظات هي إدخالات في History الطلب، ولا يراها العميل.

تبويب VibeFox Paysera Payment

في Sales > Orders افتح طلبًا دُفع عبر Paysera. في أسفل صفحة الطلب، بجانب History وAdditional، يعرض التبويب VibeFox Paysera Payment معرّف الطلب في Paysera Paysera order ID (رقم الطلب والمحاولة)، وPaysera request ID، وEnvironment وعلامة TEST payment، وStatus الدفعة، والمبالغ Requested / paid، وPayment method، وNotes الإضافة. وللطلب المعلّق يعرض ما يجب التحقق منه. التبويب يعرض معلومات فقط، ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاسترداد

الاسترداد من لوحة الإدارة غير مدعوم: بروتوكول نافذة الدفع الخاصة بـ Paysera لا يحتوي على واجهة برمجية للاسترداد. نفّذ الاسترداد من حسابك في Paysera. عندما تبلغ Paysera عن استرداد، تُضاف ملاحظة بالمبلغ المسترد إلى الطلب، ولا تتغير حالة الطلب. سجّل الاسترداد في OpenCart يدويًا إذا لزم الأمر. ولا ترسل مرتجعات المنتجات في Sales > Returns أموالًا عبر Paysera.

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

تعمل الإضافة مع مفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox Paysera Payment هي أول كتلة في صفحة Extensions > Extensions > Payments > VibeFox Paysera Payment > Edit، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مموّهًا، والحالة (مثل تاريخ انتهاء الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها السطر Product: opencart-payment-paysera والرابط 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.

بدون مفتاح نشط لا تُعرض Paysera للعملاء عند الدفع. وإذا بدأت دفعة مع ذلك، يرى العميل 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. يحذف إلغاء تثبيت الإضافة دائمًا مفتاح الترخيص وحالة الترخيص.

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

لا تظهر Paysera عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن Project ID وProject password مُدخلان كلاهما. تعرض صفحة الإعدادات تحذيرًا ما دام أحدهما فارغًا. وتحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المختارة، وأن الطلب يبلغ Total المحدد في الإعدادات.

تمت الدفعة لكن الطلب يبقى بلا حالة: يحصل الطلب على حالته من رد اتصال Paysera، وليس من عودة العميل. تحقق من أن متجرك متاح من الإنترنت عند Callback URL الظاهر في الإعدادات (وليس خلف تسجيل دخول أو مصادقة أساسية أو جدار حماية)، وراجع حقل Log في صفحة الإضافة.

يرد رد الاتصال بـ Invalid signature: Project password لا يطابق المشروع، أو أن رد الاتصال ليس من Paysera. انسخ كلمة مرور المشروع مرة أخرى. وإذا غيّرت المشروع أو كلمة المرور، فلا يمكن التحقق من الدفعات التي بدأت قبل التغيير.

يرد رد الاتصال بـ Project ID mismatch: Project ID في الإعدادات يختلف عن المشروع الذي أجرى الدفعة.

يرد رد الاتصال بـ Order not found: الطلب في رد الاتصال ليس له دفعة Paysera في هذا المتجر، مثلًا لأن الدفعة بدأت في متجر آخر بالمشروع نفسه.

يرد رد الاتصال بـ Gateway not configured أو Busy أو Temporary error: معرّف المشروع أو كلمة المرور فارغ، أو ما زال رد اتصال آخر لنفس السلة يعمل، أو تعذّر ضبط حالة الطلب. تعيد Paysera المحاولة. فعّل Debug log لمعرفة السبب.

ترفض Paysera نافذة الدفع أو تقول إن المشروع غير موجود: تحقق من Environment. يعمل المشروع العادي لـ Paysera مع Production فقط؛ أما Sandbox فيحتاج إلى مشروع أُنشئ في بيئة التجربة الخاصة بـ Paysera.

دفعة الاختبار لا تدفع الطلب: دفعة الاختبار (TEST) تدفع الطلب فقط بينما Test payments مفعّل. وإلا يُوضع الطلب في حالة الانتظار مع ملاحظة بأنه لم يُخصم أي مال. فعّل أيضًا Allow test payments في مشروع Paysera.

الطلب في حالة الانتظار مع ملاحظة عن اختلاف المبلغ أو العملة: أكّدت Paysera دفعة مبلغها أو عملتها يختلفان عن إجمالي الطلب. قارن الدفعة في حسابك في Paysera، ثم اقبل الطلب أو استرد الدفعة يدويًا.

يرى العميل Paysera payments are temporarily unavailable: راجع حقل Log. قد يكون معرّف المشروع أو كلمة المرور فارغًا، أو قد يتجاوز أحد عناوين المتجر المرسلة إلى Paysera 255 حرفًا.

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

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

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

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

Paysera علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ Paysera ولا معتمدة منها.