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

المتطلبات

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

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

العملة: اليورو (EUR) فقط. يجب تفعيل عملة EUR في متجرك، ولا تظهر طريقة الدفع إلا عندما يدفع العميل باليورو. تقبل ifthenpay مبالغ من 0.01 إلى 99,999.99 EUR.

حساب ifthenpay: سجّل في ifthenpay.com. تحتاج إلى مفتاح الطريقة التي تقدمها: Multibanco أو MB WAY أو Credit Card (بالصيغة ABC-123456). تُعرض المفاتيح في لوحة إدارة ifthenpay (backoffice.ifthenpay.com)، أو ترسلها ifthenpay عند تفعيل الطريقة لحسابك. يجب أن تفعّل ifthenpay أيضًا الاستدعاء العكسي (callback) لمفتاحك (انظر الإعداد)، ويجب أن يكون متجرك متاحًا من الإنترنت.

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

التثبيت

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

OpenCart 3

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

2. انتقل إلى Extensions > Extensions، واختر النوع Payments. اعثر على VibeFox ifthenpay Gateway، وانقر على Install (الزر الأخضر +). يحتاج مستخدم الإدارة إلى صلاحية تعديل قائمة إضافات الدفع. تُنشئ الإضافة مفتاح anti-phishing الخاص بها عند التثبيت.

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

4. اختر Payment Method، وأدخل مفتاح ifthenpay الخاص بها، ثم انقر على Save، بحيث يتطابق Callback URL مع الطريقة المختارة.

5. انسخ Anti-phishing Key وCallback URL من قسم Callback، واطلب من ifthenpay تفعيل الاستدعاء العكسي لمفتاحك (في لوحة الإدارة أو عبر دعم ifthenpay).

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

OpenCart 4

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

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

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

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

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

الإعداد

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox ifthenpay Gateway > Edit. تظهر الأقسام في القائمة على اليسار، ويحفظ الزر Save أسفل القائمة الصفحة كاملة. من دون مفتاح الطريقة المختارة، لا تظهر طريقة الدفع في صفحة الدفع. وبينما تكون البوابة مفعّلة من دون هذا المفتاح، تعرض الصفحة ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. ومن دون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

ifthenpay

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

Title: عنوان طريقة الدفع الذي يظهر في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: ifthenpay. إذا تركته فارغًا، تعرض صفحة الدفع الاسم ifthenpay.

Description: النص الذي يراه العميل في خطوة Confirm Order أعلى زر التأكيد. الافتراضي: Pay via Multibanco, MB WAY or Credit Card. غيّره ليطابق الطريقة التي تقدمها.

Payment Method: الطريقة المعروضة في صفحة الدفع. مفتاح هذه الطريقة وحده مطلوب.

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

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

Total: إجمالي الدفع، بعملة المتجر الافتراضية، الذي يجب أن يصل إليه الطلب قبل عرض ifthenpay. اتركه فارغًا لعرض ifthenpay بأي إجمالي. لا تُعرض ifthenpay نفسها إلا عندما يدفع العميل باليورو، لمبالغ من 0.01 إلى 99,999.99 EUR.

مفاتيح ifthenpay

تُعرض المفاتيح (بالصيغة ABC-123456) في لوحة إدارة ifthenpay (يحتوي القسم على رابط إليها)، أو ترسلها ifthenpay عند تفعيل طريقة الدفع لحسابك.

Multibanco Key: مفتاح ifthenpay Multibanco (MB) الخاص بك للمراجع الديناميكية.

MB WAY Key: مفتاح ifthenpay MB WAY الخاص بك.

Credit Card Key: مفتاح ifthenpay Credit Card الخاص بك. كما يتحقق من توقيع عودة العميل من صفحة البطاقة.

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

Callback

يُخبر الاستدعاء العكسي (callback) متجرك بأن دفعة قد تمت. اطلب من ifthenpay تفعيل الاستدعاء العكسي لكل مفتاح تستخدمه، مع مفتاح anti-phishing وعنوان الاستدعاء العكسي من هذا القسم. لا تُؤكَّد طلبات Multibanco وMB WAY إلا عبر الاستدعاء العكسي؛ أما مدفوعات البطاقات فتُؤكَّد أيضًا بالعودة الموقّعة من صفحة البطاقة.

Anti-phishing Key: تُنشئه الإضافة، وتُعرض لنسخها. ترسله ifthenpay مع كل استدعاء عكسي؛ وتُرفض الاستدعاءات التي لا تتضمنه.

Callback URL: عنوان الاستدعاء العكسي للطريقة المختارة، مع العناصر النائبة (placeholders) من ifthenpay، ويُعرض لنسخه. يبدأ في OpenCart 3 بـ https://your-store/index.php?route=extension/payment/wcp_ifthenpay_gateway/callback، وفي OpenCart 4 بـ https://your-store/index.php?route=extension/wcp_ifthenpay_gateway/payment/wcp_ifthenpay_gateway.callback، ويُبنى من عنوان الواجهة الأمامية لتثبيت OpenCart لديك، ويتبعه معاملات الطريقة. انسخ العنوان كاملًا تمامًا كما تعرضه الإعدادات. وإذا غيّرت Payment Method، فاحفظ ثم انسخ العنوان الجديد.

يُقارَن مفتاح anti-phishing في كل استدعاء عكسي بمفتاحك. ويُجاب على المفتاح المفقود أو الخاطئ بالرمز 403، ولا يتغير الطلب. ويجب أن يطابق الاستدعاء العكسي أيضًا دفعة من هذه الإضافة: في Multibanco بالكيان والمرجع، وفي MB WAY بالطلب وأحد طلباته من MB WAY، وفي Credit Card بالطلب وأحد طلبات البطاقة الخاصة به. ومن دون استدعاء عكسي يعمل، لا تُؤكَّد طلبات Multibanco وMB WAY أبدًا، ولا تُؤكَّد مدفوعات البطاقات إلا بالعودة الموقّعة. ويعمل الاستدعاء العكسي أيضًا والمتجر في وضع الصيانة: يسمح OpenCart 3 بمرور طلبات إضافات الدفع، وفي OpenCart 4 تضيف الإضافة إجراء بدء تشغيل يسمح بمرور الاستدعاء العكسي وعودة العميل من صفحة البطاقة.

Orders

ينشئ OpenCart الطلب في خطوة Confirm Order بدون حالة (طلب مفقود). مع Multibanco وMB WAY يحصل الطلب على حالة الانتظار بمجرد أن تُصدر ifthenpay المرجع أو طلب MB WAY؛ ومع Credit Card لا يحصل الطلب على حالة إلا من الاستدعاء العكسي أو العودة الموقّعة. ولا يُعلَّم الطلب كمدفوع إلا عندما يطابق المبلغ إجمالي الطلب حتى الفلس. وتسرد كل حقول أدناه حالات طلبات OpenCart لديك.

Order Status After Payment: الحالة التي تُعيَّن عند تأكيد الدفع. الافتراضي: قيد المعالجة.

Awaiting payment status: صدر مرجع Multibanco أو طلب MB WAY، ولا يزال على العميل أن يدفع. تُرسل تفاصيل Multibanco مع هذه الحالة، في بريد الطلب وفي سجل طلبات العميل. الافتراضي: قيد الانتظار.

Payment on hold status: أبلغت ifthenpay عن دفعة لا تطابق الطلب (المبلغ، العملة)، أو عن دفعة وصلت بعد إلغاء الطلب، أو عن دفعة لطلب كانت سلته مدفوعة بالفعل. توضح ملاحظة السبب. الافتراضي: قيد الانتظار، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

متقدم

Test Mode: تستخدم Credit Card وMultibanco نقاط نهاية sandbox الخاصة بـ ifthenpay؛ لا يُخصم أي مبلغ حقيقي، وتستخدم مفاتيح الاختبار التي توفرها ifthenpay. لا تملك MB WAY بيئة sandbox: اختبرها بمفتاح اختبار من ifthenpay. تعرض خطوة Confirm Order شارة TEST MODE. الافتراضي: معطّل.

Debug Log: تُكتب طلبات API والاستدعاءات العكسية في الملف ifthenpay_p_debug.log.php داخل مجلد سجلات OpenCart (storage/logs). لا يمكن فتح الملف من الويب، ويُدوَّر عند بلوغه 5 ميغابايت. تُسجَّل الأخطاء دائمًا. ولا تُسجَّل المفاتيح ومفتاح anti-phishing وأرقام الهواتف الكاملة أبدًا. الافتراضي: معطّل.

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

Delete Data on Uninstall: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة ومفتاح anti-phishing والسجل. تبقى الطلبات وسجلات الدفع الخاصة بـ ifthenpay دائمًا. الافتراضي: معطّل.

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

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

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

صفحة الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا ifthenpay). وفي خطوة Confirm Order يرى العميل وصفك وتلميح الطريقة. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بلا حالة.

في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في نافذة Payment method options، وينقر على Confirm Order في أسفل صفحة الدفع.

Multibanco. يرى العميل الرسالة You will receive a Multibanco reference to complete the payment. عندما ينقر العميل على Confirm Order، تنشئ الإضافة مرجع Multibanco ديناميكيًا لإجمالي الطلب، ويحصل الطلب على Awaiting payment status. تعرض صفحة نجاح الطلب Multibanco Payment Details: الكيان والمرجع والمبلغ، مع العبارة Please use these details to pay at any Multibanco ATM or through your online banking. وتُرسل التفاصيل نفسها في بريد الطلب، وتظهر في سجل طلبات العميل. وإذا كان قد صدر للطلب مرجع بالمبلغ نفسه، أُعيد استخدامه. ويُدفع الطلب عندما ترسل ifthenpay استدعاء الدفع العكسي.

MB WAY. يُدخل العميل MB WAY phone number (912 345 678 أو +351 912 345 678 أو 351#912345678 للدول الأخرى)؛ ويُملأ هاتف الطلب تلقائيًا. ترسل الإضافة طلب دفع إلى الهاتف، ويحصل الطلب على Awaiting payment status. تقول صفحة نجاح الطلب A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. ويُدفع الطلب عندما ترسل ifthenpay الاستدعاء العكسي. ولا يُخزَّن سوى رقم هاتف مُخفى جزئيًا. افتراضيًا لا يطلب OpenCart 4 رقم هاتف في صفحة الدفع؛ يبقى الحقل فارغًا ويُدخل العميل الرقم.

Credit Card. يرى العميل الرسالة You will be redirected to a secure page to enter your card details. ويُنقل إلى صفحة البطاقة الخاصة بـ ifthenpay. يبقى الطلب بلا حالة، ويُحفظ السلة. وبعد الدفع الناجح يعود العميل إلى متجرك. لا تُقبل العودة إلا بتوقيع صالح من ifthenpay، وسر خاص بتلك المحاولة، وطلب بطاقة للطلب؛ عندها يُعلَّم الطلب كمدفوع، ويرى العميل صفحة نجاح طلب OpenCart. وإذا تعذّر التحقق من العودة فلا يتغير شيء، وتعرض صفحة Payment confirmation الرسالة Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. مع الزرين Check again وBack to checkout؛ ويؤكد الاستدعاء العكسي الدفعة فور وصوله. وإذا فشل الدفع بالبطاقة أو أُلغي، يعود العميل إلى صفحة الدفع مع الرسالة The card payment was not completed. You can try again or choose another payment method. أو The card payment was cancelled. You can try again or choose another payment method. وتُحفظ كل محاولة بطاقة للطلب، لذلك تُقبل دفعة أُجريت من تبويب أقدم. في OpenCart 4 تظهر هذه الرسائل أعلى صفحة الدفع.

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

في OpenCart 4 يبقى الطلب في صفحة الدفع حتى تظهر صفحة النجاح. وإذا أُغلق الطلب في الأثناء دون دفع (مثلًا، ألغيت طلبًا بانتظار دفعة Multibanco)، يُعاد العميل إلى صفحة الدفع مع الرسالة Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. وإذا كان الطلب قد أُودع بالفعل ثم تغيّرت السلة بعد ذلك، فالرسالة هي Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. وفي الحالتين يدفع Confirm Order التالي طلبًا جديدًا للسلة.

إذا تعذّر بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل The Multibanco reference could not be created. Please try again or choose another payment method. أو The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. أو The payment service is temporarily unavailable. Please try again in a few minutes. ويُكتب السبب التقني في السجل.

تعرض الإضافة طريقة واحدة من ifthenpay في كل مرة. ولا تدعم Payshop أو Cofidis Pay أو Apple Pay أو Google Pay أو PIX أو Pay-by-Link، ولا الاشتراكات أو البطاقات المحفوظة، ولا انتهاء المراجع غير المدفوعة من Multibanco أو إلغاؤها تلقائيًا، ولا الاستعلام الدوري عن حالة الدفع.

الطلبات

حالات الطلب

No status (missing order): بدأت دفعة بالبطاقة ولم تُؤكَّد بعد، أو فشلت أو أُلغيت. تظهر هذه الطلبات في Sales > Orders فقط عند ضبط الفلتر Order Status على Missing Orders.

Awaiting payment status (default Pending): صدر مرجع Multibanco أو أُرسل طلب MB WAY. لا تُلغي المراجع غير المدفوعة وطلبات MB WAY المرفوضة الطلب تلقائيًا؛ ألغِ مثل هذه الطلبات بنفسك عند الحاجة.

Order Status After Payment (default Processing): تأكد الدفع. تعرض ملاحظة مرجع Multibanco أو معاملة MB WAY أو معرّف طلب البطاقة، وكيفية التأكيد.

Payment on hold status (default Pending): المبلغ المستلم كان مختلفًا عن إجمالي الطلب (مثلًا، تغيرت السلة بعد بدء دفعة البطاقة)، أو وصلت الدفعة بعد إلغاء الطلب، أو كان طلب آخر من السلة نفسها مدفوعًا بالفعل. توضح الملاحظة ذلك، ولا يُطلب من العميل أن يدفع مرة أخرى. تحقق من الدفعة في لوحة إدارة ifthenpay، ثم أكمل الطلب أو استرد المبلغ يدويًا. ولا تغيّر الدفعة الصحيحة اللاحقة لمثل هذا الطلب.

لا تؤدي الدفعة الثانية لطلب مدفوع بالفعل إلا إلى إضافة ملاحظة للتحقق من وجود دفعة مكررة في لوحة إدارة ifthenpay. ولا يُعاد فتح طلب نقلته إلى حالة أخرى (مثل مسترد)؛ بل تُضاف ملاحظة فقط.

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

تبويب VibeFox ifthenpay Gateway

في Sales > Orders افتح طلبًا دُفع عبر ifthenpay. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox ifthenpay Gateway قائمة بمحاولات الدفع الخاصة بالطلب (التاريخ، والطريقة، والوسم Sandbox للدفعات التجريبية، والمبلغ، والكيان والمرجع في Multibanco أو رقم MB WAY المُخفى جزئيًا، ومعرّف طلب ifthenpay والحالة)، وتحذيرًا Payment on hold ما دام الطلب معلّقًا، وifthenpay notes الخاصة بالطلب. التبويب للقراءة فقط، ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

الاستردادات من OpenCart غير مدعومة. استرد الدفعة في لوحة إدارة ifthenpay وسجّلها يدويًا في OpenCart. ولا ترسل مرتجعات المنتجات في Sales > Returns الأموال عبر ifthenpay. ولا يضيف الاستدعاء العكسي الخاص بالاسترداد (DEVOLVIDO) سوى ملاحظة. كما لا تضيف الحالات الأخرى التي تبلغ عنها ifthenpay سوى ملاحظة.

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

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

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

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

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

لا تظهر ifthenpay في صفحة الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن مفتاح Payment Method المختارة مملوء، وأن العميل يدفع باليورو، وأن الإجمالي بين 0.01 و99,999.99 EUR. وتحقق أيضًا من أن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يصل إلى Total المضبوط في الإعدادات.

دفع العميل، لكن الطلب بقي في حالة الانتظار أو بلا حالة: لا يصل الاستدعاء العكسي إلى متجرك. تحقق من أن ifthenpay فعّلت عنوان الاستدعاء العكسي ومفتاح anti-phishing للمفتاح الذي تستخدمه، ومن أن العنوان هو عنوان الطريقة المختارة. ويجب أن يكون المتجر متاحًا من الإنترنت، لا على localhost ولا خلف تسجيل دخول. فعّل Debug Log وانظر إلى الحقل Log في صفحة الإضافة.

يرد الاستدعاء العكسي بالرمز 403 Forbidden: مفتاح anti-phishing في الاستدعاء مفقود أو يختلف عن المفتاح في الإعدادات. أرسل إلى ifthenpay المفتاح المعروض في الإعدادات مرة أخرى.

يرد الاستدعاء العكسي بالرمز 503 Not configured: لم يُنشأ مفتاح anti-phishing بعد. افتح إعدادات الإضافة مرة واحدة؛ ستعيد ifthenpay محاولة الاستدعاء العكسي.

يرد الاستدعاء العكسي بالرمز 503 Busy: كان الطلب نفسه يُعالَج بطلب آخر في تلك اللحظة. ستعيد ifthenpay محاولة الاستدعاء العكسي.

يرد الاستدعاء العكسي بالرسالة Order not found: المرجع أو الطلب لا ينتمي إلى دفعة من هذه الإضافة، أو أُجري الطلب بطريقة دفع أخرى.

لماذا وُضع طلب مدفوع في حالة الانتظار؟ المبلغ المستلم كان مختلفًا عن إجمالي الطلب، أو وصلت الدفعة بعد إلغاء الطلب، أو كان طلب آخر من السلة نفسها مدفوعًا بالفعل. اقرأ الملاحظات في تبويب VibeFox ifthenpay Gateway، وتحقق من الدفعة في لوحة إدارة ifthenpay، ثم أكمل الطلب أو استرده يدويًا.

تعذّر إرسال طلب MB WAY: رقم الهاتف غير مرتبط بـ MB WAY أو بصيغة خاطئة. استخدم 912 345 678، أو 351#912345678 لأرقام الدول الأخرى.

وضع الاختبار وMB WAY: لا تملك ifthenpay بيئة sandbox لـ MB WAY؛ استخدم مفتاح اختبار توفره ifthenpay.

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

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

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

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