تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

بوابة جهاز SumUp

تمكنك بوابة جهاز SumUp من قبول المدفوعات بالبطاقات باستخدام أجهزة قراءة بطاقات SumUp مباشرةً ضمن WooCommerce POS. توفر هذه البوابة تكاملًا سلسًا مع نظام معالجة المدفوعات من SumUp للمعاملات الشخصية.

الميزات​

تكامل الأجهزة المادية

ربط أجهزة قراءة بطاقات SumUp بنظام POS الخاص بك عبر اتصال الإنترنت

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

معالجة سريعة للمدفوعات وإتمام الطلب حالاً

معاملات آمنة

معالجة المدفوعات المتوافقة مع PCI من خلال SumUp

إقران سهل

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

التثبيت​

1

قم بتنزيل وتثبيت

  1. انتقل إلى صفحة إصدارات SumUp Terminal ل WooCommerce
  2. قم بتنزيل أحدث ملف sumup-terminal-for-woocommerce.zip
  3. في لوحة تحكم WordPress الخاصة بك، انتقل إلى Plugins > Add New > Upload Plugin
  4. قم بتحميل ملف zip وقم بتفعيل المكون الإضافي
2

تكوين إعدادات SumUp

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

لا تحتاج إلى تمكين بوابة جهاز SumUp في إعدادات WooCommerce. سيتم تمكينها بشكل خاص لنظام POS في خطوة لاحقة.

3

اقترن بجهة جهاز SumUp الخاصة بك

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

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

4

تمكين في WooCommerce POS

  1. انتقل إلى WP Admin > WooCommerce POS > Settings > Checkout
  2. ابحث عن بوابة SumUp Terminal في القائمة
  3. قم بتمكين البوابة للاستخدام في نظام POS
  4. احفظ إعداداتك

الاستخدام​

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

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

عناصر التحكم في الدفع​

عند استخدام بوابة جهاز SumUp، لديك الخيارات التالية:

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

إدارة الطلبات​

  • التحديثات التلقائية: يتم تعليم الطلبات تلقائيًا على أنها مكتملة عند نجاح الدفع
  • تتبع المدفوعات: يتم تسجيل جميع تفاصيل الدفع في ملاحظات الطلب
  • توليد الإيصالات: يتم إنتاج إيصالات POS القياسية بعد المدفوعات الناجحة

المتطلبات​

حساب SumUp: حساب تاجر نشط في SumUp
الوصول إلى API: مفتاح API من لوحة التحكم الخاصة بتجارتك في SumUp
الأجهزة المتوافقة: جهاز قراءة بطاقات SumUp
WooCommerce POS: النسخة المجانية أو Pro مثبتة ومفعلة
اتصال مستقر: اتصال إنترنت موثوق به لتواصل API

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

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

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

الأجهزة الطرفية المدعومة (متصلة بالإنترنت)​

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

الأجهزة الطرفية غير المدعومة (Bluetooth)​

  • SumUp Air ❌ - فقط Bluetooth
  • SumUp 3G ❌ - فقط Bluetooth
دعم مستقبلي

سيتم إضافة دعم الأجهزة الطرفية عبر Bluetooth إلى تطبيقات iOS وAndroid في الربع الأول من 2026. سيمكن هذا من دعم جميع الأجهزة الطرفية المعتمدة من SumUp بما في ذلك طرازات Air و3G.

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

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

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

حدود معدل API​

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

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

الحصول على المساعدة​

للحصول على الدعم الفني:

لقطات الشاشة​

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

  • تكوين مفتاح API الخاص بـ SumUp وواجهة إقران الأجهزة
  • تفعيل البوابة في إعدادات WooCommerce POS
  • سير عمل معالجة الدفع في عملية الدفع بنظام POS