# PY02001: خطأ في بوابة الدفع

## ما معنى هذا[​](#what-this-means "رابط مباشر إلى ما معنى هذا")

حدث خطأ أثناء الاتصال ببوابة الدفع. لم يتمكن معالج الدفع من إكمال الطلب.

## الأسباب الشائعة[​](#common-causes "رابط مباشر إلى الأسباب الشائعة")

* **تعطل البوابة** — تعاني خدمة الدفع من مشكلات
* **خطأ في التكوين** — إعدادات البوابة غير صحيحة
* **بيانات اعتماد API** — مفاتيح API غير صالحة أو منتهية
* **مشكلات في الشبكة** — مشاكل في الاتصال بالبوابة

## كيفية الإصلاح[​](#how-to-fix "رابط مباشر إلى كيفية الإصلاح")

### 1. إعادة محاولة المعاملة[​](#1-retry-the-transaction "رابط مباشر إلى 1. إعادة محاولة المعاملة")

أحيانًا تواجه البوابات مشكلات مؤقتة:

* انتظر لحظة
* حاول معالجة الدفع مرة أخرى
* قد يتم حل المشكلة ذاتيًا

### 2. تحقق من حالة البوابة[​](#2-check-gateway-status "رابط مباشر إلى 2. تحقق من حالة البوابة")

قم بزيارة صفحة حالة مزود الدفع الخاص بك:

* سترايب: status.stripe.com
* باي بال: تحقق من مجتمع باي بال أو الحالة
* سكوير: status.squareup.com
* تحقق من الانقطاعات المعروفة

### 3. تحقق من تكوين البوابة[​](#3-verify-gateway-configuration "رابط مباشر إلى 3. تحقق من تكوين البوابة")

في إدارة WooCommerce:

1. اذهب إلى WooCommerce → الإعدادات → المدفوعات
2. انقر على بوابة الدفع الخاصة بك
3. تحقق من صحة مفاتيح API
4. تأكد من أن وضع الاختبار / الوضع المباشر يتطابق مع مفاتيحك

### 4. تحقق من بيانات اعتماد API[​](#4-check-api-credentials "رابط مباشر إلى 4. تحقق من بيانات اعتماد API")

تأكد من أن بيانات الاعتماد صالحة:

* لم تنتهِ صلاحية مفاتيح API
* استخدام مفاتيح مباشرة للمعاملات المباشرة
* استخدام مفاتيح اختبار للمعاملات الاختبارية
* تطابق بيانات الاعتماد مع الحساب الصحيح

### 5. اختبر مع بوابة مختلفة[​](#5-test-with-a-different-gateway "رابط مباشر إلى 5. اختبر مع بوابة مختلفة")

إذا كانت متاحة:

* حاول المعالجة باستخدام بوابة بديلة
* استخدم الدفع النقدي كخيار احتياطي
* أكمل البيع وصالح الحساب لاحقًا

## لأصحاب المتاجر[​](#for-store-owners "رابط مباشر إلى لأصحاب المتاجر")

مشكلات التكوين الشائعة:

* خلط بين مفاتيح API للاختبار والمباشر
* مفاتيح API من حسابات مختلفة
* طرق الدفع المعطلة
* بيانات الاعتماد المنتهية أو الملغاة

اتصل بدعم مزود الدفع الخاص بك إذا استمرت المشكلة.

## الأخطاء ذات الصلة[​](#related-errors "رابط مباشر إلى الأخطاء ذات الصلة")

* [PY02002](/ar/error-codes/PY02002.md) — انتهاء وقت الدفع
* [PY01001](/ar/error-codes/PY01001.md) — تم رفض الدفع

***