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

لم يتم استلام الدفعة

الأعراض

• يقول العميل أنه دفع، ولكن المعاملة تظهر "معلقة" أو لا تظهر أي معاملة.

خطوات التشخيص

1. تحقق من البلوك تشين: استخدم مستكشف البلوك تشين (مثل Etherscan أو Blockchain.com) للتحقق من تجزئة المعاملة. تأكد من إرسال الدفعة إلى العنوان الصحيح.

1. تحقق من التأكيدات: قد تكون الدفعة في انتظار العدد المطلوب من التأكيدات. انتقل إلى لوحة التحكم الخاصة بك ← المعاملات وابحث عن حالة المعاملة.

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

1. تحقق من العنوان: تأكد من أن العميل أرسل إلى عنوان المحفظة الصحيح وعلى الشبكة الصحيحة. من الأخطاء الشائعة إرسال رموز ERC-20 إلى عنوان TRC-20 (شبكات مختلفة، قد تضيع الأموال).

1. تحقق من العملة المشفرة: تحقق من أن العميل دفع بالعملة المشفرة التي اختارها، وليس رمزًا مختلفًا على نفس الشبكة.

الحل

• إذا تم تأكيد المعاملة على البلوك تشين ولكنها لم تنعكس في QuantaPay، فاستخدمcheck-transactionAPI لإجبار إعادة الفحص.
• إذا تم إرسال الدفعة إلى عنوان خاطئ أو شبكة خاطئة، فلا يمكن لـ QuantaPay استعادة الأموال.

عدم تشغيل Webhook

الأعراض

• تكتمل المدفوعات في لوحة معلومات QuantaPay ولكن الخادم الخاص بك لا يتلقى إشعارات webhook.

خطوات التشخيص

1. تحقق من عنوان URL الخاص بـ webhook: انتقل إلى الإعدادات ← المدفوعات ← Webhook وتأكد من أن عنوان URL صحيح.

1. تحقق من إمكانية الوصول إلى نقطة النهاية: تأكد من أن نقطة نهاية webhook الخاصة بك يمكن الوصول إليها بشكل عام عبر HTTPS. اختبر باستخدام curl:

   curl -X POST https://yoursite.com/wp-json/quantapay/webhook \
     -H "Content-Type: application/json" \
     -d '{"test": true}'

1. تحقق من سجلات الخادم: ابحث عن طلبات POST الواردة إلى نقطة نهاية webhook الخاصة بك. إذا لم يكن هناك أي منها، فالمشكلة تكمن في التسليم. إذا كانت هناك أخطاء 500، فالمشكلة تكمن في كود المعالج الخاص بك.

1. جدار الحماية / WAF: إذا كنت تستخدم Cloudflare، فتأكد من السماح بنقطة نهاية webhook (راجعWordPress / WooCommerceلتكوين Cloudflare).

1. تحقق من حالة webhook: في لوحة التحكم الخاصة بك ← المعاملات، يعرض عمود "Webhook"1إذا تم إرسال webhook لتلك المعاملة.

الحل

• قم بإصلاح عنوان URL الخاص بـ webhook أو إمكانية الوصول إلى نقطة النهاية.
• استخدم مؤقتًا خدمة اختبار webhook (webhook.site) للتأكد من أن QuantaPay يرسل webhooks.
• كحل بديل، قم باستطلاعget-checkout-sessionAPI للتحقق من حالة الدفع.

أخطاء اتصال API

الأعراض

• ترجع استدعاءات واجهة برمجة التطبيقات (API) أخطاءً أو مهلات أو استجابات غير متوقعة.

المشكلات الشائعة

نصائح لتصحيح الأخطاء

1. الاختبار باستخدام curl: استخدم curl لعزل ما إذا كانت المشكلة في التعليمات البرمجية الخاصة بك أو في واجهة برمجة التطبيقات (API):

   curl -X POST https://cloud.quantapay.app/api.php \
     -d "function=get-balances" \
     -d "api-key=YOUR_API_KEY"

1. تحقق من تنسيق الاستجابة: تتبع جميع الاستجابات التنسيق{"success": true/false, ...}. قم بتحليل الحقلsuccessقبل الوصول إلىresponse.

1. سجل الطلبات: سجل الطلب والاستجابة الكاملين لتصحيح الأخطاء.

مشكلات في إضافة WordPress

حالة الطلب لا يتم تحديثها

• تحقق من أن عنوان URL الخاص بـ webhook مُكوَّن في كل من WordPress و QuantaPay Cloud.
• تحقق من سجل تصحيح أخطاء WordPress (wp-content/debug.log) بحثًا عن الأخطاء.
• تأكد من وجود طلب WooCommerce وأن حالته "معلقة".

إعدادات البرنامج المساعد لا يتم حفظها

• قم بمسح أي إضافات تخزين مؤقت (WP Super Cache، W3 Total Cache، إلخ).
• تحقق من أذونات الملفات علىwp-content/.
• تحقق من أن مستخدم قاعدة البيانات لديه أذونات الكتابة.

إعادة توجيه صفحة الدفع لا يعمل

• تأكد من أن شهادة SSL الخاصة بموقعك صالحة.
• تحقق من وجود أخطاء JavaScript في وحدة تحكم المتصفح.
• تحقق من إمكانية الوصول إلى QuantaPay Cloud API من الخادم الخاص بك.