# بوابة SumUp Terminal

تتيح لك بوابة SumUp Terminal قبول مدفوعات البطاقات باستخدام قارئات بطاقات SumUp مباشرة داخل WCPOS. توفر هذه البوابة تكاملا سلسا مع نظام معالجة المدفوعات في SumUp للمعاملات الحضورية.

## الميزات[​](#features "رابط مباشر إلى الميزات")

#### تكامل الأجهزة

وصّل قارئات بطاقات SumUp بنظام POS لديك عبر اتصال بالإنترنت

#### المعالجة الفورية

معالجة فورية للمدفوعات وإكمال الطلبات

#### معاملات آمنة

معالجة مدفوعات متوافقة مع PCI عبر SumUp

#### إقران سهل

عملية إقران بسيطة للجهاز باستخدام رموز الإقران

## التثبيت[​](#installation "رابط مباشر إلى التثبيت")

1

#### تثبيت SumUp Terminal for WooCommerce

ثبّته من `WP Admin > نقطة البيع > الإعدادات > الإضافات`، أو نزّل أحدث **ملف zip الخاص بالإضافة** (وليس ملف zip أو tarball الخاص بشفرة GitHub المصدرية) من [صفحة إصدارات GitHub](https://github.com/wcpos/sumup-terminal-for-woocommerce/releases) وارفعه عبر `إضافات > إضافة جديد > رفع إضافة`.

2

#### تهيئة إعدادات SumUp

1. انتقل إلى `WP Admin > WooCommerce > الإعدادات > المدفوعات`
2. ابحث عن **SumUp Terminal** في قائمة طرق الدفع
3. انقر على **SumUp Terminal** للوصول إلى الإعدادات
4. أدخل **مفتاح API الخاص بـ SumUp** (المتوفر من لوحة معلومات التاجر في SumUp)
5. احفظ الإعدادات

ملاحظة

لا تحتاج إلى تفعيل بوابة SumUp Terminal في إعدادات WooCommerce. سيتم تفعيلها خصيصًا لـ POS في خطوة لاحقة.

3

#### إقران جهاز SumUp Terminal الخاص بك

1. في صفحة الإعدادات نفسها، حدّد موقع قسم **إقران القارئ**
2. على جهاز SumUp، انتقل إلى شاشة الإقران لعرض رمز الإقران
3. أدخل رمز الإقران المعروض على جهاز SumUp
4. انقر على **"إقران القارئ"** لإنشاء الاتصال
5. انتظر التأكيد بأن القارئ قد تم إقرانه بنجاح

مهم

يجب إقران القارئ بنجاح قبل أن تتمكن من معالجة المدفوعات. تأكد من اكتمال عملية الإقران قبل المتابعة.

4

#### التمكين في WCPOS

1. انتقل إلى `WP Admin > نقطة البيع > الإعدادات > إتمام الطلب`
2. ابحث عن بوابة **SumUp Terminal** في القائمة
3. فعّل البوابة لاستخدامها في نقطة البيع
4. احفظ إعداداتك

## الاستخدام[​](#usage "رابط مباشر إلى الاستخدام")

### معالجة المدفوعات[​](#processing-payments "رابط مباشر إلى معالجة المدفوعات")

1. **إضافة العناصر**: أضف المنتجات إلى سلة التسوق في نقطة البيع
2. **اختيار البوابة**: اختر "SumUp Terminal" كطريقة الدفع
3. **بدء الدفع**: انقر لبدء دفعة جديدة على جهاز SumUp
4. **دفع العميل**: يكمل العميل الدفع على جهاز SumUp
5. **الإكمال التلقائي**: يكتمل الطلب تلقائيًا عند اكتشاف الدفع

### عناصر التحكم في الدفع[​](#payment-controls "رابط مباشر إلى عناصر التحكم في الدفع")

عند استخدام بوابة SumUp Terminal، تتوفر لك الخيارات التالية:

* **بدء دفع جديد**: بدء طلب دفع على الجهاز الطرفي المتصل
* **إلغاء الدفع**: إلغاء دفعة قيد المعالجة حاليًا
* **حالة الدفع**: مراقبة الحالة الحالية لعملية الدفع

### إدارة الطلبات[​](#order-management "رابط مباشر إلى إدارة الطلبات")

* **التحديثات التلقائية**: يتم تلقائيًا وضع علامة مكتملة على الطلبات عند نجاح الدفع
* **تتبع الدفع**: يتم تسجيل جميع تفاصيل الدفع في ملاحظات الطلب
* **إنشاء الإيصال**: يتم إنشاء إيصالات POS القياسية بعد نجاح عمليات الدفع

## المتطلبات[​](#requirements "رابط مباشر إلى المتطلبات")

حساب SumUp

<!-- -->

: حساب تاجر SumUp نشط

وصول API

<!-- -->

: مفتاح API الخاص بـ SumUp من لوحة معلومات التاجر

الأجهزة المتوافقة

<!-- -->

: جهاز قارئ بطاقات SumUp

WCPOS

<!-- -->

: الإصدار Pro مطلوب للدفع في POS

اتصال مستقر

<!-- -->

: اتصال إنترنت موثوق للتواصل عبر API

## توافق الأجهزة[​](#hardware-compatibility "رابط مباشر إلى توافق الأجهزة")

متطلبات الاتصال

يستخدم هذا التنفيذ SDK JavaScript الخاص بـ SumUp، مما يعني أنه يعمل من خلال تطبيقات الويب ولكنه يتطلب **أجهزة طرفية متصلة بالإنترنت فقط**. الأجهزة الطرفية التي تعمل عبر Bluetooth غير مدعومة حاليًا.

### الأجهزة الطرفية المدعومة (المتصلة بالإنترنت)[​](#supported-terminals-internet-connected "رابط مباشر إلى الأجهزة الطرفية المدعومة (المتصلة بالإنترنت)")

* **SumUp Solo** ✅ - جهاز طرفي متصل عبر WiFi/Ethernet

### أجهزة الدفع غير المدعومة (بلوتوث)[​](#unsupported-terminals-bluetooth "رابط مباشر إلى أجهزة الدفع غير المدعومة (بلوتوث)")

* **SumUp Air** ❌ - بلوتوث فقط
* **SumUp 3G** ❌ - بلوتوث فقط

الدعم المستقبلي

من المخطط دعم أجهزة الدفع عبر بلوتوث في إصدار مستقبلي من تطبيق iOS وAndroid. عند توفر ذلك، سيتيح دعم جميع أجهزة الدفع المعتمدة من SumUp، بما في ذلك طرازا Air و3G.

## استكشاف الأخطاء وإصلاحها[​](#troubleshooting "رابط مباشر إلى استكشاف الأخطاء وإصلاحها")

### المشكلات الشائعة[​](#common-issues "رابط مباشر إلى المشكلات الشائعة")

يتعذر إقران القارئ

* تأكد من استخدام جهاز دفع مدعوم متصل بالإنترنت (Solo فقط)
* تحقق من أن جهاز SumUp Solo متصل بشبكة WiFi وبالإنترنت
* تحقق من أن الجهاز في وضع الإقران وأن رمز الإقران مُدخل بشكل صحيح
* تأكد من تفعيل الوصول إلى API في حساب SumUp الخاص بك
* تأكد من توفر اتصال إنترنت مستقر أثناء الاقتران

لا تتم معالجة الدفع

* تحقق من اقتران القارئ بشكل صحيح
* تحقق من أن حساب SumUp الخاص بك نشط وبحالة جيدة
* تأكد من أن الجهاز يحتوي على بطارية كافية واتصال متوفر
* تأكد من أن مفتاح API صحيح ونشط

لا يكتمل الطلب

* تحقق من استقرار اتصال الإنترنت
* تحقق من إعدادات webhook في حساب SumUp الخاص بك
* تأكد من نجاح الدفع على SumUp Terminal
* راجع سجلات أخطاء WordPress للتحقق من مشكلات الاتصال بـ API

### حدود معدلات API[​](#api-rate-limits "رابط مباشر إلى حدود معدلات API")

تم تحسين بوابة الدفع لتقليل استدعاءات API وتجنب تقييد المعدلات:

* يتم التحقق من حالة الدفع بكفاءة
* يتم تقليل طلبات API غير الضرورية إلى الحد الأدنى
* يتولى منطق إعادة المحاولة التلقائية معالجة حالات الفشل المؤقتة

### الحصول على المساعدة[​](#getting-help "رابط مباشر إلى الحصول على المساعدة")

للدعم الفني:

* تفضل بزيارة [مستودع GitHub](https://github.com/wcpos/sumup-terminal-for-woocommerce) للإبلاغ عن المشكلات
* راجع [وثائق مطوري SumUp](https://developer.sumup.com/) للأسئلة المتعلقة بـ API
* اتصل بدعم SumUp لمشكلات الحساب والأجهزة

## لقطات الشاشة[​](#screenshots "رابط مباشر إلى لقطات الشاشة")

ستتم إضافة لقطات الشاشة في تحديث مستقبلي لعرض:

* واجهة إعداد مفتاح API الخاص بـ SumUp وإقران الجهاز
* تفعيل البوابة في إعدادات WCPOS
* سير عمل معالجة الدفع في إتمام الدفع في POS