# بوابة Stripe Terminal

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

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

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

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

#### وضع المحاكاة

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

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

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

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

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

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

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

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

1

#### تثبيت Stripe Terminal لـ WooCommerce

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

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

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

### توصيل قارئ البطاقات[​](#connecting-a-reader "رابط مباشر إلى توصيل قارئ البطاقات")

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

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

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

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

### الاختبار باستخدام المحاكي[​](#testing-with-simulator "رابط مباشر إلى الاختبار باستخدام المحاكي")

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

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

### الطلبات الهاتفية (MOTO)[​](#phone-orders-moto "رابط مباشر إلى الطلبات الهاتفية (MOTO)")

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

#### الإعداد[​](#setup "رابط مباشر إلى الإعداد")

1

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

ميزة MOTO غير مفعّلة افتراضيًا. تواصل مع [دعم Stripe](https://support.stripe.com/contact) واطلب تفعيل صلاحيات MOTO لحسابك. هذه عملية سريعة لكنها تتطلب موافقة يدوية من Stripe.

2

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

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

3

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

تعمل ميزة MOTO فقط مع أجهزة القراءة المتوافقة المتصلة بالإنترنت المدرجة في [الأجهزة المدعومة](#supported-terminals-internet-connected). لن يظهر مفتاح التبديل لأنواع أجهزة القراءة الأخرى.

#### تلقي طلب هاتفي[​](#taking-a-phone-order "رابط مباشر إلى تلقي طلب هاتفي")

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

نصيحة

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

تحذير

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

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

حساب Stripe

<!-- -->

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

مفاتيح API

<!-- -->

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

WCPOS

<!-- -->

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

HTTPS

<!-- -->

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

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

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

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

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

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

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

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

دعم مستقبلي

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

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

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

* تأكد من أنك تستخدم [جهازًا طرفيًا متصلًا بالإنترنت مدعومًا](#supported-terminals-internet-connected)
* تحقق من أن الجهاز الطرفي متصل بشبكة WiFi/Ethernet ومتاح عبر الإنترنت
* تحقق من أن حساب Stripe الخاص بك مفعّل عليه Terminal
* تأكد من أن الجهاز الطرفي مسجّل في لوحة تحكم Stripe

تم رفض الدفع

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

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

* تحقق من أن إعداد **الطلبات الهاتفية (MOTO)** مفعّل في `WooCommerce > الإعدادات > المدفوعات > Stripe Terminal`
* تأكد من اتصالك بقارئ متوافق (راجع [الأجهزة المدعومة](#supported-terminals-internet-connected)) — يكون مفتاح التبديل مخفيًا لأنواع القارئات الأخرى
* لا يظهر مفتاح التبديل عند استخدام المحاكي

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

* تأكد من أن Stripe قد فعّلت صلاحيات MOTO على حسابك — تواصل مع [دعم Stripe](https://support.stripe.com/contact) إذا لم تكن قد فعلت ذلك بعد
* تحقق مرة أخرى من أن بيانات البطاقة أُدخلت بشكل صحيح على القارئ
* قد تخضع مدفوعات MOTO لفحوصات احتيال أكثر صرامة — تأكد من أن البطاقة صالحة وبها رصيد كافٍ

أخطاء شهادة SSL

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

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

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

* قم بزيارة [مستودع GitHub](https://github.com/wcpos/stripe-terminal-for-woocommerce) للإبلاغ عن المشكلات
* راجع [وثائق Stripe Terminal](https://stripe.com/docs/terminal) للحصول على إرشادات خاصة بالأجهزة
* تواصل مع دعم Stripe للمسائل المتعلقة بالحساب

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

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

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