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

المتطلبات

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

PHP: ‏8.0 أو أحدث.

حساب Braintree: تحتاج إلى Merchant ID وPublic Key وPrivate Key لحساب Braintree الخاص بك. توجد هذه البيانات في Braintree Control Panel ضمن أيقونة الترس، ثم API، ثم API Keys (بيئة الاختبار sandbox: ‏sandbox.braintreegateway.com، والبيئة الفعلية: ‏www.braintreegateway.com). لحسابات الاختبار والحسابات الفعلية مفاتيح مختلفة. يجب تفعيل 3-D Secure لحساب التاجر الخاص بك في Braintree، ما لم تضبط 3-D Secure على Disabled. لا حاجة إلى webhook: تُؤكَّد مدفوعات البطاقات فورًا.

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

التثبيت

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

OpenCart 3

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

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

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

4. انسخ Merchant ID وPublic Key وPrivate Key من Braintree Control Panel إلى حقول بيئة الاختبار (sandbox) أو الحقول الفعلية.

5. فعّل Enable/Disable وانقر على Save. أبقِ Sandbox mode مفعّلًا، وأجرِ طلبًا تجريبيًا ببطاقة اختبار من بيئة Braintree التجريبية، مثل 4111 1111 1111 1111. ثم أدخل بيانات الاعتماد الفعلية وأوقف Sandbox mode لاستقبال مدفوعات حقيقية.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص وبيانات اعتماد Braintree، واختبر الدفع كما في الخطوات من 3 إلى 5 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين.

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

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Braintree Gateway > Edit. تظهر الأقسام في القائمة على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة بأكملها. إذا كانت طريقة الدفع مفعّلة لكن Merchant ID أو Public Key أو Private Key للبيئة المحددة مفقود، تحذّرك الصفحة من أن طريقة الدفع تُخفى عند الدفع إلى أن تُملأ هذه الحقول. وطالما كان وضع sandbox مفعّلًا، تعرض الصفحة Sandbox mode is on: test payments, no real money. وبدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

Braintree

Enable/Disable: يفعّل مدفوعات البطاقات عبر Braintree أو يوقفها. تُخفى طريقة الدفع عند الدفع إلى أن تُملأ حقول Merchant ID وPublic Key وPrivate Key للبيئة المحددة. الافتراضي: متوقف.

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

Description: النص الذي يظهر للعميل في خطوة Confirm Order، فوق نموذج البطاقة. الافتراضي: Pay securely with your credit or debit card via Braintree.

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

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

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

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

سجّل الدخول إلى Braintree Control Panel (وضع sandbox أو الوضع الفعلي، والروابط موجودة في هذا القسم)، وانقر على أيقونة الترس، ثم على API وAPI Keys. تظهر المفاتيح العامة والخاصة هناك، ويظهر Merchant ID في الصفحة نفسها. تعرض الصفحة حقول بيانات الاعتماد للبيئة المحددة فقط؛ وتبقى المجموعتان محفوظتين.

Sandbox mode: يستخدم بيئة الاختبار sandbox الخاصة بـ Braintree (مدفوعات تجريبية، دون أموال حقيقية). الافتراضي: مفعّل. أوقفه لاستقبال مدفوعات حقيقية ببيانات الاعتماد الفعلية. تستخدم الاستردادات والتحصيل والإلغاء دائمًا البيئة التي دُفع فيها الطلب. وطالما كان مفعّلًا، يرى العملاء في خطوة Confirm Order الرسالة SANDBOX / TEST MODE — no real money is charged.

Sandbox Merchant ID وLive Merchant ID: ‏Merchant ID الخاص بحساب الاختبار أو الحساب الفعلي.

Sandbox Public Key وLive Public Key: المفتاح العام لذلك الحساب.

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

Sandbox merchant account ID(s) وLive merchant account ID(s): ‏اختياري. تفرض Braintree الرسوم بعملة حساب التاجر. اتركه فارغًا لاستخدام حساب التاجر الافتراضي، أو أدخل معرّفًا واحدًا (مثل mystore_EUR)، أو معرّفًا لكل عملة: EUR=mystore_EUR، USD=mystore_USD. إذا لم تتطابق عملة الخصم مع عملة الطلب، فتُلغى المعاملة تلقائيًا ولا يُخصم من العميل أي مبلغ.

الدفع

Transaction type: كيفية خصم المبلغ من البطاقة.

3-D Secure: يُعد 3-D Secure 2 (المصادقة القوية للعميل، SCA) إلزاميًا لمعظم مدفوعات البطاقات في المنطقة الاقتصادية الأوروبية والمملكة المتحدة. ويجب أن يكون مفعّلًا لحساب Braintree الخاص بك أيضًا (تواصل مع دعم Braintree إذا فشلت المدفوعات بخطأ في إعداد 3-D Secure).

تُفحص نتيجة 3-D Secure على الخادم، لا في المتصفح فقط، قبل خصم المبلغ من البطاقة.

الطلبات

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

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

Authorized Status: التفويض فقط: المبلغ محجوز وغير مدفوع بعد. الافتراضي: بانتظار الدفع، لأن OpenCart لا يحتوي على حالة قيد الانتظار؛ وتوضح ذلك ملاحظة الطلب وعلامة تبويب الطلب. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

On Hold (Review) Status: أعادت Braintree حالة معاملة غير متوقعة، أو لم يتطابق المبلغ أو العملة المخصومان وفشل الإلغاء التلقائي. تشرح الملاحظة ما يجب التحقق منه. الافتراضي: بانتظار الدفع.

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

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

متقدم

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

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

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

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

Export: Download JSON يحفظ الإعدادات في ملف JSON. لا يتم تصدير المفاتيح الخاصة.

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Credit / debit card). وفي خطوة Confirm Order يرى العميل وصفك ونموذج بطاقة Braintree الذي تحمّله Braintree بلغة المتجر. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال دون حالة. عندما ينقر العميل على Confirm Order، يتحقق النموذج من البطاقة، وإذا كان 3-D Secure مفعّلًا يُكمل العميل التحقق لدى بنكه؛ وتُمرَّر إلى النموذج قيمة الطلب الإجمالية والبريد الإلكتروني وعنوان الفوترة. لا يصل إلى متجرك إلا رمز لمرة واحدة. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، ضمن النافذة Payment method options. ويظهر نموذج البطاقة بعد ذلك في كتلة التأكيد أسفل صفحة الدفع، فوق زر Confirm Order. وإذا لم يطلب المتجر عنوان الدفع (وهو الافتراضي في OpenCart 4)، فإن فحص 3-D Secure يأخذ عنوان الشحن بدلًا منه.

ثم تُحصّل الإضافة قيمة الرمز عبر واجهة API الخاصة بـ Braintree بإجمالي الطلب بعملة الطلب، ويُستخدم رقم طلب OpenCart بوصفه معرّف الطلب في Braintree. تُقارَن العملة والمبلغ المخصومان مع الطلب. لا يحصل الطلب على حالته إلا بعد أن تقبل Braintree الدفعة، بالطريقة القياسية في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون. تُفرَّغ السلة ويرى العميل صفحة نجاح الطلب في OpenCart.

إذا فشلت الدفعة، يبقى الطلب دون حالة، وتُضاف إليه ملاحظة تتضمن السبب، ويبقى العميل في خطوة Confirm Order مع رسالة، مثل Your card was declined. Please use another card or contact your bank. أو 3-D Secure authentication failed. Please try again or use another card. أو The card security code or billing address could not be verified. Please check your details and try again. يمكن للعميل إعادة إدخال البطاقة وإعادة المحاولة فورًا. إذا لم تتطابق العملة أو المبلغ المخصومان مع الطلب، تُلغى المعاملة ويرى العميل This payment could not be processed in the currency of your order. Your card has not been charged. Please choose another payment method or contact us.

لا يُخصم من الطلب مرتين أبدًا. الإرسال الثاني أثناء جريان الدفع يعرض This order is already being paid. Please wait a moment and check your e-mail before trying again. وتأكيد طلب مدفوع من جديد ينقل العميل مباشرة إلى صفحة النجاح؛ وبالنسبة إلى دفعة مفوّضة يعرض A payment for this order has already been received and is awaiting review. إذا خُصمت البطاقة لكن OpenCart لم يتمكن من تعيين حالة الطلب، يرى العميل 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 طلبًا واحدًا للدفع ويحدّثه، لذلك بعد رفض البطاقة يدفع العميل الطلب نفسه): بمجرد دفع أحدها، لا يُخصم من طلب آخر من السلة نفسها، ويرى العميل This cart has already been paid with order #…. Please check your order history — do not pay again.

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

تقبل الإضافة مدفوعات البطاقات فقط. لا تتضمن البطاقات المحفوظة، ولا الاشتراكات أو المدفوعات المتكررة، ولا PayPal وVenmo وApple Pay وGoogle Pay أو طرق الدفع المحلية، ولا webhooks من Braintree.

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

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

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

Order Status After Payment (الافتراضي Processing): خُصمت قيمة البطاقة (Sale)، أو حُصّل التفويض. تعرض الملاحظة المبلغ ومعرّف معاملة Braintree ونتيجة 3-D Secure.

Authorized Status (الافتراضي Pending): الأموال مفوّضة فقط (Authorize only). تطلب منك الملاحظة تحصيل الدفعة من صفحة الطلب قبل الشحن.

On Hold (Review) Status (الافتراضي Pending): أعادت Braintree حالة معاملة غير متوقعة، أو تعذّر الإلغاء التلقائي لخصم بعملة أو مبلغ خاطئين. تشرح الملاحظة ما يجب التحقق منه في Braintree Control Panel.

Voided Status (الافتراضي Canceled): أُلغي تفويض.

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

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

علامة تبويب VibeFox Braintree Gateway

في Sales > Orders افتح طلبًا دُفع عبر Braintree. في أسفل صفحة الطلب، بجوار History وAdditional، تعرض علامة التبويب VibeFox Braintree Gateway معرّف المعاملة Transaction ID (مرتبطًا بالمعاملة في Braintree Control Panel لبيئتها) مع التسمية Sandbox لمدفوعات sandbox، وStatus المعاملة، وAmount وحساب التاجر، ونتيجة 3-D Secure، والمبالغ Charged / refunded، وأزرار التحصيل والإلغاء والاسترداد، وسجل الاستردادات، وBraintree notes الخاصة بالطلب. تظهر علامة التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة؛ وتحتاج الأزرار إلى صلاحية تعديلها (وتُضبط في System > Users > User Groups).

التحصيل والإلغاء

بالنسبة إلى دفعة مفوّضة، انقر على Capture Braintree payment لتحصيل إجمالي الطلب، أو على Void Braintree authorization لإطلاق المبلغ المحجوز وإلغاء الطلب. يضبط التحصيل الطلب على Order Status After Payment؛ ويضبطه الإلغاء على Voided Status. إذا فشل الإجراء، يظهر الخطأ في علامة التبويب ويُضاف إلى ملاحظات الطلب.

الاستردادات

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

لا تعيد المرتجعات في Sales > Returns الأموال عبر Braintree. لا تتم مزامنة النزاعات (chargebacks) وإخفاقات التسوية والاستردادات التي تُجرى في Braintree Control Panel مع OpenCart.

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

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

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

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

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

لا يظهر Braintree عند الدفع: تحقّق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن البيئة المحددة فيها Merchant ID وPublic Key وPrivate Key (تعرض صفحة الإعدادات تحذيرًا عند غياب أحد المفاتيح). وتحقق من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

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

يعرض نموذج البطاقة Could not initialize payment form: مفاتيح البيئة المحددة غير صحيحة، أو معرّف حساب التاجر غير موجود في ذلك الحساب. تحقق من المفاتيح ومعرّفات حسابات التاجر، ثم أعد تحميل الصفحة.

يرى العميل Your session has expired. Please refresh the page and try again.: تغيّرت جلسة الدفع أثناء فتح النموذج. على العميل إعادة تحميل صفحة الدفع.

يفشل 3-D Secure في كل دفعة: يجب تفعيل 3-D Secure لحساب التاجر الخاص بك في Braintree. تواصل مع دعم Braintree، أو اضبط 3-D Secure على Disabled (غير مستحسن في المنطقة الاقتصادية الأوروبية والمملكة المتحدة، حيث تكون SCA إلزامية).

يُبلَّغ العميل بأنه تعذّرت معالجة الدفع بعملة الطلب: خصمت Braintree بعملة حساب التاجر. أدخل معرّف حساب التاجر الخاص بعملة الطلب في حقل حساب التاجر للبيئة الحالية.

يرى العميل The order total must be greater than zero to pay by card.: إجمالي الطلب صفر، على سبيل المثال بعد تطبيق قسيمة. لا يمكن دفع مثل هذه الطلبات بالبطاقة.

يفشل الاسترداد الجزئي مباشرة بعد الدفع: لا يمكن لـ Braintree استرداد إلا المعاملات المسوّاة، وعادةً خلال 24 ساعة. استرد المبلغ كاملًا لإلغاء المعاملة الآن، أو نفّذ الاسترداد الجزئي بعد التسوية.

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

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

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

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

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