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

بوابة SumUp Terminal

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

الميزات​

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

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

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

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

معاملات آمنة

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

إقران سهل

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

التثبيت​

1

تثبيت SumUp Terminal for WooCommerce

ثبّته من WP Admin > نقطة البيع > الإعدادات > الإضافات، أو نزّل أحدث ملف zip الخاص بالإضافة (وليس ملف zip أو tarball الخاص بشفرة GitHub المصدرية) من صفحة إصدارات GitHub وارفعه عبر إضافات > إضافة جديد > رفع إضافة.

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. احفظ إعداداتك

الاستخدام​

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

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

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

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

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

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

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

المتطلبات​

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

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

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

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

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

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

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

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

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

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

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

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

حدود معدلات API​

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

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

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

للدعم الفني:

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

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

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