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

بوابة جهاز SumUp

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

الميزات​

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

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

المعالجة في الوقت الفعلي

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

معاملات آمنة

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

إقران سهل

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

التثبيت​

1

تحميل وتثبيت

  1. قم بزيارة صفحة إصدارات جهاز SumUp لـ 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 في قائمة طرق الدفع
  3. انقر على جهاز SumUp للوصول إلى الإعدادات
  4. أدخل مفتاح API الخاص بـ SumUp (متاح من لوحة التحكم الخاصة بتاجر SumUp لديك)
  5. احفظ الإعدادات
ملاحظة

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

3

اتصل بجهاز SumUp الخاص بك

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

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

4

تفعيل في WooCommerce POS

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

الاستخدام​

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

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

تحكمات المدفوعات​

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

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

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

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

المتطلبات​

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

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

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

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

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

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

الأجهزة غير المدعومة (بلوتوث)​

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

سيتم إضافة دعم أجهزة البلوتوث إلى تطبيقات 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