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

المتطلبات

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

PHP: 8.0 أو أحدث.

حساب PayPal: حساب PayPal Business مع تطبيق REST API في PayPal Developer Dashboard. تحتاج إلى Client ID وSecret للتطبيق. تختلف بيانات الاعتماد بين تطبيقات sandbox والتطبيقات الفعلية. لا حاجة إلى webhook: تؤكد الإضافة كل دفعة على خادمك أثناء وجود العميل في الدفع.

العملة: إحدى العملات التي تدعمها PayPal: AUD وBRL وCAD وCHF وCNY وCZK وDKK وEUR وGBP وHKD وHUF وILS وJPY وMXN وMYR وNOK وNZD وPHP وPLN وSEK وSGD وTHB وTWD أو USD.

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

التثبيت

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

OpenCart 3

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

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

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

4. في PayPal Developer Dashboard أنشئ تطبيق REST API (sandbox و/أو فعلي)، وانسخ Client ID وSecret الخاصين به إلى قسم API credentials.

5. اختر Capture أو Authorize، وفعّل Enable/Disable، وانقر على Save.

6. اختبر بحساب مشترٍ تجريبي في PayPal sandbox، ثم أوقف Sandbox mode وأدخل بيانات الاعتماد الفعلية.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص وبيانات اعتماد PayPal وإجراء الدفع كما في الخطوات من 3 إلى 6 لـ OpenCart 3. صفحة الإعدادات وحقولها متماثلة في الإصدارين. لا تمسّ الإضافة إضافة PayPal المرفقة مع OpenCart 4: يمكن تثبيت الإضافتين في المتجر نفسه.

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

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox PayPal Gateway > Edit. تُعرض الأقسام في الجهة اليسرى؛ وزر Save أسفل القائمة يحفظ الصفحة كاملة. فوق الإعدادات تحذّرك الصفحة عندما تكون طريقة الدفع مفعّلة لكن Client ID أو Secret للوضع المحدد فارغان، وعندما لا تدعم PayPal العملة الافتراضية للمتجر. في الحالتين تُخفى طريقة الدفع عند الدفع. وما دام وضع sandbox مفعّلًا تعرض الصفحة Sandbox mode is on: payments go to the PayPal sandbox, no real money is moved. وبدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

عام

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

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

Description: النص الذي يراه العميل في خطوة Confirm Order فوق زر PayPal. الافتراضي: Pay with your PayPal account or a card via PayPal.

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

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

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

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

أنشئ تطبيق REST API في PayPal Developer Dashboard وانسخ Client ID وSecret الخاصين به. يحتوي القسم على روابط لتطبيقات sandbox والتطبيقات الفعلية. تُعرض حقول الوضع المحدد فقط؛ وتبقى بيانات اعتماد الوضعين محفوظة.

Sandbox mode: تذهب المدفوعات إلى PayPal sandbox باستخدام بيانات اعتماد sandbox؛ ولا يُنقل أي مال حقيقي. الافتراضي: مفعّل. أوقفه لقبول مدفوعات فعلية. تستخدم التحصيلات والإلغاءات والاستردادات دائمًا البيئة التي دُفع فيها الطلب. وما دام مفعّلًا يرى العميل في خطوة Confirm Order الرسالة Sandbox mode: pay with a PayPal sandbox buyer account — no real money is charged.

Sandbox Client ID: Client ID لتطبيق REST API الخاص بـ sandbox.

Sandbox Secret: Secret لتطبيق REST API الخاص بـ sandbox.

Live Client ID: Client ID لتطبيق REST API الفعلي.

Live Secret: Secret لتطبيق REST API الفعلي.

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

الدفع

Payment action: ما يحدث عندما يوافق العميل على الدفع. الافتراضي: Capture.

الطلبات

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

Order Status After Payment: اكتمل التحصيل، وكذلك عند تحصيل تفويض أو إكمال تحصيل معلّق في تبويب الطلب. الافتراضي: Processing.

Awaiting Payment Status: التحصيل في حالة PENDING لدى PayPal (مراجعة الدفع، والأموال لم تُسوَّ بعد). الافتراضي: Pending.

Authorized Status: إجراء الدفع Authorize: الأموال محجوزة لكنها لم تُدفع بعد. الافتراضي: Pending.

On Hold (Review) Status: خصمت PayPal مالًا، لكن تعذّر قراءة الدفعة، أو لا يطابق المبلغ أو العملة الطلب. تشرح ملاحظة ما يجب التحقق منه. الافتراضي: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالاتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Voided Status: أُلغي التفويض في تبويب الطلب وأُفرجت الأموال المحجوزة. الافتراضي: Canceled.

Refunded Status: الدفعة مستردة بالكامل. الاستردادات الجزئية تضيف ملاحظة فقط. الافتراضي: Refunded.

Failed Status: رفضت PayPal تحصيلًا معلّقًا. الافتراضي: Failed.

متقدم

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

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

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

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

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

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

الدفع

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

يوافق العميل على الدفع في نافذة PayPal بحساب PayPal أو بمصدر تمويل آخر تقدمه PayPal. ثم يعرض الدفع PayPal payment approved. Completing your order… ويُكمل الطلب بنفسه. إذا نقر العميل على Confirm Order دون الموافقة على دفعة، فالرسالة هي Please click the PayPal button and approve the payment first.

ثم يقرأ خادمك طلب PayPal ويتحقق من أنه موافَق عليه، وأنه أُنشئ في هذا الدفع، وأنه لا ينتمي إلى طلب آخر، وأن مبلغه وعملته يطابقان الطلب. عندئذٍ فقط تُحصَّل الدفعة (أو تُفوَّض). لا يُعلَّم الطلب كمدفوع إلا بعد تأكيد PayPal. ثم يحصل الطلب على حالته بالطريقة المعيارية في OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون، ويُفرغ السلة، ويرى العميل صفحة نجاح الطلب في OpenCart.

إذا تغير إجمالي الطلب بعد الموافقة، فلا يُحصَّل أي مبلغ. يرى العميل الرسالة The order total changed after you approved the payment in PayPal. Please click the PayPal button again to approve the new total. إذا رفضت PayPal الدفعة، يبقى الطلب دون حالة، ويُطلب من العميل النقر على زر PayPal مجددًا أو اختيار طريقة دفع أخرى. إذا أغلق العميل نافذة PayPal، يعرض الدفع You cancelled the PayPal payment.

إذا لم ترد PayPal أثناء التحصيل، يرى العميل We could not confirm your PayPal payment yet. Please try again in a moment — you will not be charged twice. تُحفظ الموافقة لهذه السلة، حتى بعد إعادة تحميل الصفحة: يعرض الدفع PayPal payment approved. Click "Confirm Order" to complete it. وتستخدم Confirm Order الموافقة مجددًا. إذا كانت PayPal قد أكملت المحاولة السابقة، تُستخدم تلك الدفعة ولا يُحصَّل تفويض جديد. إذا خُصمت الدفعة لكن تعذّر ضبط حالة الطلب، يرى العميل Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. وتضبط المحاولة التالية الحالة من الدفعة المحفوظة دون خصم جديد.

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

يحتفظ OpenCart 4 بالطلب في الدفع حتى تُعرض صفحة النجاح. إذا أُغلق ذلك الطلب في الأثناء (مثلًا ألغيته أو رُفض التحصيل المعلّق)، أو كان قد دُفع مسبقًا لسلة سابقة، يرى العميل Your previous order of this checkout is already closed or paid. Please refresh the page and confirm the order again — a new order will be created. وبعد إعادة تحميل الصفحة تدفع الدفعة التالية طلبًا جديدًا. لا يظهر الطلب المدفوع أبدًا كمدفوع لسلة مختلفة.

لا تتضمن الإضافة webhooks من PayPal، ولا رسائل Pay Later، ولا حقول بطاقة، ولا Venmo أو Apple Pay أو Google Pay أو Fastlane، ولا طرق دفع محفوظة أو اشتراكات، ولا أزرار في صفحات المنتج أو السلة. تُستخدم العناوين المُدخلة في دفع OpenCart، وليس عنوانًا من PayPal.

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

حالات الطلبات

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

حالة الطلب بعد الدفع (الافتراضي Processing): اكتمل التحصيل. تعرض ملاحظة الدفعة والمبلغ وطلب PayPal والتحصيل.

حالة المفوَّض (الافتراضي Pending): فُوِّضت الدفعة وتنتظر التحصيل (إجراء الدفع Authorize).

حالة انتظار الدفع (الافتراضي Pending): التحصيل في حالة PENDING لدى PayPal، مثلًا لمراجعة الدفع.

حالة المراجعة (الافتراضي Pending): المبلغ أو العملة المدفوعان يختلفان عن الطلب، أو تعذّرت قراءة الدفعة من رد PayPal. تشرح الملاحظة ذلك. راجع الطلب وأتمّه أو استرد المدفوع.

حالة الإلغاء (الافتراضي Canceled): أُلغي التفويض باستخدام Void PayPal authorization.

حالة الفشل (الافتراضي Failed): رُفض تحصيل معلّق أو فشل.

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

إذا وصلت دفعة ثانية لسلة مدفوعة بالفعل، فلا يتغير الطلب المدفوع. تطلب منك ملاحظة مراجعة ذلك في حساب PayPal الخاص بك واسترداده.

الملاحظات هي إدخالات في History الطلب التي لا يراها العميل. تُكتب تغييرات الحالة التي تتم في تبويب الطلب (التحصيل، والإلغاء، وفحص الحالة، والاسترداد) مباشرة، دون إشعار العميل ودون تغيير المخزون.

تبويب VibeFox PayPal Gateway

في Sales > Orders افتح طلبًا دُفع عبر PayPal. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox PayPal Gateway معرّف طلب PayPal ونيته (intent) مع التسمية Sandbox للدفعات التجريبية، وCapture ID (مرتبط بالدفعة في حساب PayPal الخاص بك، sandbox أو فعلي)، وAuthorization ID، وحالة الدفع Status، والمبلغ Amount، والمبالغ Paid / refunded، وسجل الاستردادات، وPayPal notes الخاصة بالطلب. يُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة؛ وتحتاج أزراره إلى صلاحية تعديل الإضافة (تُضبط في System > Users > User Groups). تظهر نتيجة كل إجراء في التبويب.

الاستردادات

في تبويب VibeFox PayPal Gateway أدخل المبلغ (تُملأ القيمة التي لم تُسترد بعد)، واختياريًا Reason (optional, sent to the buyer)، ثم انقر على Refund via PayPal. أكّد السؤال Refund this amount through PayPal? This cannot be undone. يُدعم الاسترداد الكامل والجزئي. يُرسل السبب إلى PayPal كملاحظة للمشتري. تُجرى الاستردادات بالمبلغ والعملة اللذين حصّلتهما PayPal، لذلك بعد عدم تطابق المبلغ أو العملة يمكنك الاسترداد حتى ما دفعه العميل فعلًا، لا إجمالي الطلب. يُرسل الاسترداد إلى بيئة PayPal التي تمت فيها الدفعة (sandbox أو فعلية)، لذا يجب ضبط بيانات اعتماد تلك البيئة. إذا لم تقبل PayPal الاسترداد، يعرض التبويب الخطأ ولا يُسجَّل أي استرداد. يُضاف الاسترداد الناجح إلى سجل الاستردادات والملاحظات مع معرّف الاسترداد في PayPal وحالته؛ والاسترداد في حالة PENDING تُكمله PayPal لاحقًا. يضع الاسترداد الكامل الطلب في Refunded Status. لا يغيّر الاسترداد الجزئي الحالة.

لا يمكن استرداد دفعة مُفوَّضة فقط: استخدم Void PayPal authorization بدلًا من ذلك. لا ترسل مرتجعات المنتجات في Sales > Returns أي أموال عبر PayPal. لا تتم مزامنة الاستردادات والنزاعات واسترجاعات الرسوم التي تجري في حساب PayPal الخاص بك مع OpenCart.

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

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

بدون مفتاح فعّال لا يظهر PayPal للعملاء في الدفع. وإذا بدأ الدفع رغم ذلك، يرفض المتجر إنشاء طلب PayPal ويرى العميل An error occurred during PayPal checkout. Please try again. ويستمر مستخدم الإدارة الذي سجّل الدخول إلى لوحة الإدارة في المتصفح نفسه في رؤية طريقة الدفع في المتجر، مع علامة (unlicensed — visible to admins only)، لتتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. في OpenCart 4 لا تتوفر هذه المعاينة: لا يرى المتجر تسجيل دخول الإدارة، لذلك بدون مفتاح فعّال تُخفى طريقة الدفع عن الجميع. بعد أن تفتح صفحة Edit مرة واحدة يظهر تذكير في Dashboard الإدارة. أغلقه بالزر × ليختفي لمدة 7 أيام. الطلبات الحالية لا تتأثر: تستمر الاستردادات وإجراءات تبويب الطلب في العمل.

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

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

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

تمت الدفعة لكن الطلب يبقى دون حالة: لا تملك الإضافة webhook، لذلك لا تُؤكَّد الدفعة إلا أثناء الدفع. يحدث هذا عندما لا ترد PayPal أثناء التحصيل أو تعذّر ضبط حالة الطلب. فعّل Debug log وراجع حقل Log، وتحقق من الدفعة في حساب PayPal الخاص بك، أو دع العميل يحاول مجددًا: لا تُخصم المحاولة الجديدة مرتين أبدًا وتضبط الحالة من الدفعة المحفوظة.

تعذّر تحميل PayPal: لم يُحمَّل نص PayPal في المتصفح، مثلًا لأن إضافة في المتصفح تحجب www.paypal.com أو بسبب مشكلة في الشبكة.

PayPal غير متاحة حاليًا: بيانات الاعتماد خاطئة أو تتبع الوضع الآخر. انسخ Client ID وSecret للتطبيق الصحيح مرة أخرى.

تعذّرت مطابقة موافقتك في PayPal مع هذا الدفع: لم يُنشأ طلب PayPal في هذا الدفع، مثلًا بعد انتهاء الجلسة. ينقر العميل على زر PayPal مجددًا.

انتهت جلستك. يرجى تحديث الصفحة والمحاولة مرة أخرى: بقيت صفحة الدفع مفتوحة مدة طويلة. يعيد العميل تحميل الصفحة.

هذه الدفعة قيد المعالجة بالفعل: أُرسلت السلة نفسها مرتين في اللحظة نفسها. ينتظر العميل لحظة ويتحقق من بريده الإلكتروني قبل المحاولة مجددًا.

الطلب في حالة المراجعة أو الانتظار بعد الدفع: اقرأ الملاحظات في تبويب VibeFox PayPal Gateway. الدفعة مفوَّضة (حصّلها عبر Capture PayPal payment)، أو التحصيل في حالة PENDING لدى PayPal (استخدم Check PayPal payment status لاحقًا)، أو لم يطابق المبلغ أو العملة المدفوعان الطلب (أتمم الطلب أو استرد المدفوع).

يفشل تحصيل تفويض: قد يكون التفويض أقدم من 29 يومًا أو مُلغًى بالفعل. يعرض التبويب والملاحظات خطأ PayPal.

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

يفشل الاسترداد: الطلب ليس فيه تحصيل من PayPal (تفويض فقط)، أو المبلغ يتجاوز المتبقي للاسترداد، أو بيانات اعتماد البيئة التي تمت فيها الدفعة مفقودة. يوضح التبويب أيّ حالة هي.

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

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

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

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