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

المتطلبات

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

PHP: 8.0 أو أحدث مع امتداد OpenSSL. تُنشئ الإضافة مفاتيح RSA الخاصة بها باستخدام OpenSSL.

العملة: EUR. لا تحصّل Satispay إلا باليورو. يجب تفعيل عملة EUR في System > Localisation > Currencies، ولا تظهر طريقة الدفع إلا عندما يكون العميل قد اختار EUR.

حساب Satispay: حساب Satispay Business. لا تنسخ أي مفاتيح API: تتصل الإضافة برمز تفعيل لمرة واحدة تنشئه من Satispay Business Dashboard (راجع Configuration). للاختبار تحتاج إلى حساب sandbox من Satispay، تطلبه من Satispay للمطورين.

المتجر العام: يجب أن يكون متجرك متاحًا من الإنترنت، حتى تتمكن Satispay من استدعائه عند تغيّر حالة الدفع. لا يلزم إعداد أي شيء في Satispay لهذا الغرض.

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

التثبيت

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

OpenCart 3

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

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

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

4. اختر البيئة: فعّل Sandbox Mode للاختبارات، واتركه معطّلًا للمدفوعات الحقيقية.

5. الصق رمز تفعيل لتلك البيئة في Activation Code واضغط Save. سيعرض حقل Status بعدها Connected مع Key ID.

6. فعّل Enable/Disable واضغط Save. اختبر دفعة في sandbox، ثم عطّل Sandbox Mode واربط بيئة الإنتاج برمز تفعيل إنتاج.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص، واختر البيئة، واربطها برمز تفعيل كما في الخطوات من 3 إلى 6 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين. الرابط الوحيد المختلف هو عنوان callback (انظر Payment notifications).

يبدأ التثبيت الجديد بطريقة الدفع معطّلة وببيئة الإنتاج محددة.

الإعدادات

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

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

الدفع

Enable/Disable: Enable Satispay payment يشغّل طريقة الدفع أو يوقفها. Default: off.

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

Description: النص الذي يظهر للعميل في خطوة Confirm Order، فوق زر التأكيد. Default: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

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

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

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

اتصال Satispay

Status: حالة البيئتين، مثلًا Live: Connected مع Key ID أو Sandbox: Not connected، وأي البيئتين in use. طالما أن البيئة المستخدمة غير متصلة، يقول الحقل: Satispay is hidden at checkout until the environment in use is connected.

Sandbox Mode: يستخدم بيئة Satispay التجريبية (sandbox). لا تُحصَّل مدفوعات sandbox. Default: off. لكل من sandbox والإنتاج مفاتيحه المنفصلة: اربط كل بيئة برمز تفعيل من البيئة نفسها. أثناء استخدام sandbox يرى العملاء في خطوة Confirm Order الرسالة Sandbox mode: no real money is charged.

Activation Code: لربط البيئة المحددة أعلاه، الصق رمز تفعيل جديدًا مكونًا من 6 أحرف واضغط Save. تُنشأ رموز الإنتاج في Satispay Business Dashboard، ضمن قسم Online shop (يحتوي الحقل على رابط إليه). تأتي رموز sandbox مع حساب sandbox من Satispay. يُستخدم الرمز مرة واحدة ولا يُخزَّن. اترك الحقل فارغًا للإبقاء على الاتصال الحالي.

عند الحفظ مع رمز، تُحفظ الإعدادات أولًا. ثم تُنشئ الإضافة زوج مفاتيح RSA، وترسل المفتاح العام والرمز إلى Satispay، وتخزّن Key ID ومفاتيح البيئة المستخدمة. لا تُعرض المفاتيح الخاصة ولا تُصدَّر أبدًا. عند النجاح تعرض الصفحة، على سبيل المثال، Satispay Live connected. Key ID: متبوعًا بالمعرّف. إذا رفضت Satispay الرمز، تعرض الصفحة Satispay activation failed: مع رسالة Satispay، وتطلب منك التحقق من أن الرمز يخص هذه البيئة ولم يُستخدم بعد؛ ويبقى الاتصال الحالي كما هو. يُرفض الرمز الذي لا يتكون من 4 إلى 64 حرفًا وأرقامًا قبل إرسال أي شيء. وحفظ رمز جديد لبيئة ما يستبدل اتصالها السابق.

إشعارات الدفع

لا يوجد ما يلزم إعداده في Satispay. يحمل كل دفع عنوان callback خاصًا به، تستدعيه Satispay عند تغيّر الدفع، وتعيد الإضافة قراءة الدفع من واجهة Satispay API قبل تغيير أي طلب. يعرض الحقل Callback URL مثالًا لهذا العنوان. في OpenCart 3 يبدو هكذا: https://your-store/index.php?route=extension/payment/wcp_satispay_gateway/callback&satispay_p_order={order}&payment_id={uuid}، وفي OpenCart 4 يبدو هكذا: https://your-store/index.php?route=extension/wcp_satispay_gateway/payment/wcp_satispay_gateway.callback&satispay_p_order={order}&payment_id={uuid}. ويُبنى من عنوان الواجهة الأمامية لتثبيت OpenCart الخاص بك. يجب أن يكون العنوان متاحًا من الإنترنت: لا ينبغي وجود جدار حماية أو مصادقة أساسية أمامه. لا يحجبه وضع الصيانة في OpenCart. إذا تعذّر على callback الوصول إلى متجرك، يُؤكَّد الطلب عند عودة العميل.

الطلبات

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

Order Status After Payment: الحالة التي تُعيَّن بعد قبول الدفع. Default: Processing.

Satispay Payment On Hold Status: تم استلام الأموال، لكن الطلب يحتاج إلى مراجعة (راجع Order statuses). Default: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Refunded Status: تُعيَّن بعد استرداد الدفع بالكامل من صفحة الطلب. Default: Refunded.

متقدم

Debug log: يكتب استدعاءات API وأحداث الدفع في satispay_p_debug.log.php داخل مجلد سجلات OpenCart (storage/logs). لا يمكن فتح الملف من الويب، وعند بلوغه 5 MB يُنقل إلى satispay_p_debug.old.log.php. لا تُسجَّل المفاتيح ورمز التفعيل وبيانات العملاء. تُسجَّل الأخطاء دائمًا، حتى عندما يكون هذا الخيار معطّلًا. Default: off.

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

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

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

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

Import: الصق JSON صُدِّر سابقًا واضغط Import لاستعادة الإعدادات. يبقى اتصال Satispay محفوظًا.

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Satispay). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to the Satispay page: scan the QR code with the Satispay app or confirm the payment on your phone. ينشئ OpenCart الطلب في هذه الخطوة، ما يزال بلا حالة. عندما يضغط العميل Confirm Order، تنشئ الإضافة دفعة Satispay بمبلغ إجمالي الطلب باليورو، مع رقم الطلب كمرجع، وتحوّل العميل إلى صفحة دفع Satispay. على الحاسوب يمسح العميل رمز QR بتطبيق Satispay. على الهاتف يؤكد العميل الدفع داخل التطبيق. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order في أسفل صفحة الدفع.

بعد الدفع يعود العميل إلى متجرك. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكد Satispay ذلك: تقرأ الإضافة الدفع من واجهة Satispay API، وتتحقق من أنه أُنشئ لهذا الطلب، وتقارن حالته ومبلغه (بالسنت) وعملته مع الطلب. يحدث هذا سواء استدعت Satispay عنوان callback أو عاد العميل، أيهما يحدث أولًا. ثم يحصل الطلب على حالته بالطريقة المعتادة في OpenCart، مع رسائل البريد الإلكتروني المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. إذا لم تؤكد Satispay الدفع بعد عند عودة العميل، تعرض صفحة Payment confirmation الرسالة Satispay has not confirmed your payment yet. The order will be updated automatically as soon as the confirmation arrives. وزر Check again. يحدد callback حالة الطلب فور وصوله.

إذا غادر العميل صفحة Satispay دون أن يدفع، تلغي الإضافة الدفع لدى Satispay، بحيث لا يمكن دفع الصفحة المهجورة بعد ذلك. يعود العميل إلى الدفع مع الرسالة Your Satispay payment was cancelled and nothing was charged. You can try again or choose another payment method. وتظهر الرسالة نفسها عندما يرفض العميل الدفع في التطبيق. تبقى السلة محفوظة.

ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، ويحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، فيُدفع الطلب نفسه بدفعة Satispay جديدة بعد إلغاء الدفعة السابقة. قبل إنشاء دفعة Satispay جديدة، تُفحص الدفعات السابقة للسلة: تُلغى الدفعة المعلّقة لدى Satispay، وإذا كانت إحداها مدفوعة بالفعل فإنها تؤكد طلبها، ولا تُجرى دفعة ثانية ويذهب العميل مباشرة إلى صفحة النجاح.

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

إذا تعذّر بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر: Satispay is not available at the moment. Please choose another payment method. عندما ترفض Satispay المفاتيح؛ وSatispay supports EUR currency only. لطلب بعملة أخرى؛ أو Unable to create the Satispay payment. Please try again or choose another payment method. للأخطاء الأخرى. يُكتب السبب في السجل.

يعمل callback وعودة العميل أثناء وضع الصيانة في المتجر: يسمح OpenCart 3 بمرور طلبات إضافات الدفع، وفي OpenCart 4 تضيف الإضافة إجراء بدء التشغيل لهذه الطلبات.

تقبل الإضافة المدفوعات الفردية باليورو فقط. ليس فيها اشتراكات ولا طرق دفع محفوظة ولا تفويضات مسبقة ولا قسائم طعام. لا يوجد فحص مجدول للمدفوعات المعلّقة: إذا لم يصل callback من Satispay ولا عودة العميل إلى متجرك، يبقى الطلب بلا حالة، ويكون الدفع مرئيًا في Satispay Dashboard.

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

حالات الطلب

No status (missing order): أُرسل العميل إلى Satispay ولم يدفع، أو لم تؤكد Satispay الدفع بعد. في Sales > Orders لا تظهر هذه الطلبات إلا مع فلتر Order Status المضبوط على Missing Orders. يترك الدفع الملغى لدى Satispay الطلب بلا حالة، ويمكن للعميل أن يدفع مجددًا.

Order Status After Payment (default Processing): تم قبول الدفع. تعرض ملاحظة دفع Satispay والمبلغ والطريقة التي جرى بها التحقق (callback أو redirect أو checkout).

Satispay Payment On Hold Status (default Pending): أبلغت Satispay عن مبلغ أو عملة تختلف عن إجمالي الطلب، أو قُبل الدفع بعد أن حصل الطلب على حالة أخرى (مثلًا ملغى). تشرح الملاحظة ذلك. تحقق من الدفع في Satispay Dashboard، ثم أتمّ الطلب أو استرد الدفع. إذا قُبل دفع آخر للسلة نفسها بالمبلغ الصحيح لاحقًا، ينتقل الطلب إلى Order Status After Payment.

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

إذا قُبل دفع ثانٍ لطلب مدفوع بالفعل، أو لطلب آخر من السلة نفسها، فلن يتغير الطلب المدفوع. تطلب منك الملاحظة استرداد الدفع المكرر من Satispay Dashboard.

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

VibeFox Satispay Gateway tab

في Sales > Orders افتح طلبًا دُفع عبر Satispay. في أسفل صفحة الطلب، بجانب History وAdditional، تعرض علامة التبويب VibeFox Satispay Gateway الحقل Satispay payment ID مع الوسم Sandbox لمدفوعات sandbox، والحقل Status للدفع، والمبالغ Paid / refunded، ونموذج الاسترداد، وسجل Refunds، وقائمة Satispay payments of this cart مع كل محاولة دفع وطلبها وبيئتها، والملاحظات Satispay notes الخاصة بالطلب. تظهر علامة التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

في علامة التبويب VibeFox Satispay Gateway أدخل Amount (يُملأ المبلغ الذي لم يُسترد بعد تلقائيًا)، واختياريًا Reason (optional)، ثم اضغط Refund via Satispay. أكّد السؤال Refund this amount through Satispay? This cannot be undone. الاستردادات الكاملة والجزئية مدعومة. تحتاج إلى صلاحية تعديل الإضافة (تُضبط في System > Users > User Groups). تقتصر الاستردادات على المبلغ الذي حصّلته Satispay للدفع، لذلك بعد وجود اختلاف في المبلغ يمكنك الاسترداد حتى المبلغ الذي دفعه العميل فعلًا، لا إجمالي الطلب. يُرسل الاسترداد إلى البيئة التي تمّ فيها الدفع (الإنتاج أو sandbox)، لذلك يجب أن تظل هذه البيئة متصلة. لا يُعتبر الاسترداد منجزًا إلا عندما تقبله Satispay: يُضاف الاسترداد الناجح إلى السجل والملاحظات مع معرّف استرداد Satispay والسبب. إذا لم تقبل Satispay الاسترداد، تعرض علامة التبويب الخطأ ولا يُسجَّل أي استرداد. يضع الاسترداد الكامل الطلب على Refunded Status دون إشعار العميل ودون إعادة المنتجات إلى المخزون، كما هو الحال في تغيير الحالة يدويًا. لا يغيّر الاسترداد الجزئي الحالة. تتوفر الاستردادات بعد أن تقبل Satispay الدفع.

لا تعيد مرتجعات المنتجات في Sales > Returns الأموال عبر Satispay. لا تُسجَّل في OpenCart الاستردادات التي تتم في Satispay Dashboard. حدّث الطلب يدويًا عند الحاجة.

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

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

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

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

لا تظهر Satispay عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن البيئة المستخدمة متصلة (يعرض الحقل Status الحالة Connected لها)، وأن العميل اختار EUR. تحقق أيضًا من أن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

تم الدفع، لكن الطلب يبقى بلا حالة: يحصل الطلب على حالته عندما تستدعي Satispay متجرك أو عندما يعود العميل. تحقق من أن متجرك متاح من الإنترنت، وأنه لا يوجد جدار حماية أو مصادقة أساسية أمام عنوان callback، وفعّل Debug log لرؤية الاستدعاءات في الحقل Log. الدفع مرئي في Satispay Dashboard.

يجيب callback بـ Payment status unavailable, retry later. أو Not configured.: تعذّرت على الإضافة قراءة الدفع من Satispay، أو أن بيئة الدفع غير متصلة. لا يتغير أي طلب. ستستدعي Satispay مرة أخرى. تحقق من حالة الاتصال والسجل.

يجيب callback بـ Busy, retry later.: كانت السلة تُؤكَّد بطلب آخر في اللحظة نفسها، أو تعذّر تعيين حالة الطلب. ستستدعي Satispay مرة أخرى. يعرض السجل السبب.

يجيب callback بـ Unknown payment. أو Missing or invalid payment_id.: لم يُنشئ هذا المتجر الدفع لهذا الطلب، أو أن الطلب ليس callback من Satispay. لا يتغير شيء.

فشل التفعيل: رموز التفعيل تُستخدم مرة واحدة فقط. تحقق من أن الرمز يخص البيئة المحددة في Sandbox Mode (رمز إنتاج للإنتاج، ورمز sandbox لـ sandbox)، وأنشئ رمزًا جديدًا ثم احفظ مرة أخرى. إذا أفادت الصفحة بأنه تعذّر إنشاء زوج مفاتيح RSA، فاطلب من مزوّد الاستضافة تفعيل امتداد PHP OpenSSL. إذا تعذّر الوصول إلى Satispay، فتحقق من أن خادمك يستطيع فتح اتصالات HTTPS صادرة.

اختفت Satispay من صفحة الدفع بعد التبديل من sandbox إلى الإنتاج: يستخدم sandbox والإنتاج مفاتيح مختلفة. الصق رمز تفعيل إنتاج مع إيقاف Sandbox Mode واحفظ.

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

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

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

يفشل الاسترداد لأن البيئة لم تعد متصلة: تمّ الدفع في الإنتاج أو في sandbox، ولم تعد لتلك البيئة مفاتيح. أعد ربطها برمز تفعيل، أو استرد الدفع من Satispay Dashboard.

يفشل الاسترداد برسالة Satispay did not accept the refund: أعادت Satispay حالة غير accepted. لم يسجّل OpenCart الاسترداد، وتوضح ملاحظة ذلك. تحقق منه في Satispay Dashboard.

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

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

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

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