بوابة Stripe Terminal

تتيح بوابة Stripe Terminal قبول المدفوعات الحضورية باستخدام أجهزة قراءة Stripe Terminal مباشرةً داخل WCPOS. تدعم هذه البوابة أجهزة قراءة البطاقات الفعلية ووضع المحاكاة للاختبار.

الميزات

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

توصيل أجهزة قراءة Stripe Terminal الفعلية عبر الاتصال بالإنترنت

وضع المحاكاة

اختبار المدفوعات بدون أجهزة باستخدام محاكي Stripe

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

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

معاملات آمنة

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

الطلبات الهاتفية (MOTO)

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

التثبيت

1

تثبيت Stripe Terminal لـ WooCommerce

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

2

ضبط إعدادات Stripe

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

ملاحظة

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

3

التفعيل في WCPOS

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

الاستخدام

توصيل قارئ البطاقات

عند اختيار بوابة Stripe Terminal أثناء الدفع في نقطة البيع:

1. اختيار طريقة الاتصال: يمكنك إما توصيل قارئ بطاقات فعلي أو استخدام المحاكي
2. قارئ فعلي: اتبع التعليمات الظاهرة على الشاشة لتوصيل جهاز Stripe Terminal
3. المحاكي: حدد وضع المحاكي لاختبار سيناريوهات الدفع المختلفة بدون أجهزة فعلية

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

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

الاختبار باستخدام المحاكي

يتيح لك المحاكي اختبار وسائل الدفع والسيناريوهات المختلفة:

• الدفع بالبطاقات: اختبر أنواعًا مختلفة من البطاقات (Visa وMastercard وغيرها)
• الدفع بدون تلامس: محاكاة معاملات الدفع بالنقر
• سيناريوهات الأخطاء: اختبار المدفوعات المرفوضة وحالات الخطأ الأخرى
• مبالغ مختلفة: اختبار مبالغ معاملات متنوعة

الطلبات الهاتفية (MOTO)

تتيح ميزة MOTO (طلبات البريد/الطلبات الهاتفية) معالجة مدفوعات البطاقات للعملاء غير الموجودين فعليًا — على سبيل المثال، عند تلقي طلب عبر الهاتف. بدلاً من النقر على البطاقة أو إدخالها، يقوم التاجر بإدخال بيانات البطاقة مباشرة في شاشة جهاز القراءة.

الإعداد

1

طلب صلاحية MOTO من Stripe

ميزة MOTO غير مفعّلة افتراضيًا. تواصل مع دعم Stripe واطلب تفعيل صلاحيات MOTO لحسابك. هذه عملية سريعة لكنها تتطلب موافقة يدوية من Stripe.

2

التفعيل في إعدادات الإضافة

1. انتقل إلى WP Admin > WooCommerce > الإعدادات > المدفوعات > Stripe Terminal
2. فعّل خانة الاختيار الطلبات الهاتفية (MOTO)
3. احفظ الإعدادات

3

توصيل جهاز قراءة متوافق

تعمل ميزة MOTO فقط مع أجهزة القراءة المتوافقة المتصلة بالإنترنت المدرجة في الأجهزة المدعومة. لن يظهر مفتاح التبديل لأنواع أجهزة القراءة الأخرى.

تلقي طلب هاتفي

1. قم بتوصيل جهاز قراءة متوافق (راجع الأجهزة المدعومة)
2. في شاشة الدفع، قم بتفعيل مفتاح طلب هاتفي
3. انقر على تحصيل دفعة البطاقة — سيعرض جهاز القراءة شاشة إدخال رقم البطاقة بدلاً من طلب النقر أو الإدخال
4. أدخل رقم بطاقة العميل وتاريخ انتهاء الصلاحية ورمز CVV على جهاز القراءة
5. تتم معالجة الدفعة بشكل طبيعي بعد ذلك

نصيحة

تستخدم مدفوعات MOTO نوع طريقة الدفع card بدلاً من card_present. هذا يعني أنها تُعامل كمعاملات إلكترونية من منظور Stripe، لذلك تُطبق رسوم معالجة البطاقات الإلكترونية القياسية بدلاً من أسعار الدفع الشخصي.

تحذير

يظهر مفتاح تبديل الطلب الهاتفي فقط عند استيفاء ثلاثة شروط: تفعيل إعداد MOTO في إعدادات الإضافة، وتوصيل جهاز قراءة متوافق، وعدم كون جهاز القراءة محاكيًا. إذا لم يظهر مفتاح التبديل، تحقق من هذه الشروط.

المتطلبات

حساب Stripe: حساب Stripe نشط مع تفعيل خدمة Terminal

مفاتيح API: المفتاح السري لـ Stripe من لوحة التحكم الخاصة بك

WCPOS: يتطلب الإصدار الاحترافي لإتمام عملية الدفع عبر نقطة البيع

HTTPS: يجب أن يستخدم موقعك بروتوكول SSL/HTTPS لضمان الأمان

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

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

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

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

• Stripe Reader S700/S710 ✅ - جهاز طرفي متصل عبر Ethernet/WiFi
• WisePOS E ✅ - جهاز طرفي متصل عبر WiFi

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

• BBPOS Chipper 2X BT ❌ - بلوتوث فقط
• BBPOS WisePad 3 ❌ - بلوتوث فقط
• Verifone P400 ❌ - بلوتوث فقط

دعم مستقبلي

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

مشكلات شائعة

لا يتصل القارئ

• تأكد من أنك تستخدم جهازًا طرفيًا متصلًا بالإنترنت مدعومًا
• تحقق من أن الجهاز الطرفي متصل بشبكة WiFi/Ethernet ومتاح عبر الإنترنت
• تحقق من أن حساب Stripe الخاص بك مفعّل عليه Terminal
• تأكد من أن الجهاز الطرفي مسجّل في لوحة تحكم Stripe

تم رفض الدفع

• تحقق من أن حساب Stripe الخاص بك نشط وبحالة جيدة
• تحقق من أن البطاقة المستخدمة صالحة
• تأكد من توفر رصيد كافٍ

زر تبديل الطلبات الهاتفية لا يظهر

• تحقق من أن إعداد الطلبات الهاتفية (MOTO) مفعّل في WooCommerce > الإعدادات > المدفوعات > Stripe Terminal
• تأكد من اتصالك بقارئ متوافق (راجع الأجهزة المدعومة) — يكون مفتاح التبديل مخفيًا لأنواع القارئات الأخرى
• لا يظهر مفتاح التبديل عند استخدام المحاكي

فشل دفع MOTO مع ظهور خطأ

• تأكد من أن Stripe قد فعّلت صلاحيات MOTO على حسابك — تواصل مع دعم Stripe إذا لم تكن قد فعلت ذلك بعد
• تحقق مرة أخرى من أن بيانات البطاقة أُدخلت بشكل صحيح على القارئ
• قد تخضع مدفوعات MOTO لفحوصات احتيال أكثر صرامة — تأكد من أن البطاقة صالحة وبها رصيد كافٍ

أخطاء شهادة SSL

• يتطلب Stripe Terminal بروتوكول HTTPS — تأكد من أن موقعك يحتوي على شهادة SSL صالحة
• تحقق من أن شهادة SSL مُهيأة بشكل صحيح

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

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

• قم بزيارة مستودع GitHub للإبلاغ عن المشكلات
• راجع وثائق Stripe Terminal للحصول على إرشادات خاصة بالأجهزة
• تواصل مع دعم Stripe للمسائل المتعلقة بالحساب

لقطات الشاشة

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

• إعدادات بوابة الدفع في إعدادات الدفع في WooCommerce
• واجهة الدفع في نقطة البيع مع اختيار Stripe Terminal
• واجهة اختبار المحاكي مع طرق الدفع المختلفة