بوابة Stripe Terminal

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

الميزات

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

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

وضع المحاكاة

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

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

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

معاملات آمنة

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

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

قبول مدفوعات البطاقات عبر الهاتف عن طريق إدخال التفاصيل في القارئ

التثبيت

1

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

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

2

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

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

ملاحظة

ليس من الضروري تمكين بوابة Stripe Terminal في إعدادات WooCommerce. سيتم تفعيلها بشكل محدد لنقاط البيع في الخطوة التالية.

3

تفعيل في WCPOS

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

الاستخدام

توصيل قارئ

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

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

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

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

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

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

• مدفوعات البطاقات: اختبار أنواع مختلفة من البطاقات (فيزا، ماستركارد، إلخ)
• المدفوعات اللا تلامسية: محاكاة المعاملات عن طريق الدفع بالتلامس
• سيناريوهات الخطأ: اختبار المدفوعات المرفوضة وظروف الخطأ الأخرى
• مبالغ مختلفة: اختبار مبالغ معاملة متنوعة

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

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

الإعداد

1

طلب الوصول إلى MOTO من Stripe

لا يتم تمكين MOTO بشكل افتراضي. اتصل بـ دعم Stripe واطلب منهم تمكين أذونات MOTO لحسابك. هذه عملية سريعة ولكن تتطلب موافقة يدوية من Stripe.

2

تمكين في إعدادات الإضافة

1. انتقل إلى WP Admin > WooCommerce > Settings > Payments > 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: يتطلب إصدار Pro الدفع في نقاط البيع

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 في الربع الأول من 2026. سيمكن هذا دعم جميع أجهزة القراءة المعتمدة من Stripe Terminal بما في ذلك M2 و WisePad 3.

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

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

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

تم رفض الدفع

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

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

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

فشل الدفع MOTO بخطأ

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

أخطاء شهادة SSL

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

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

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

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

لقطات الشاشة

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

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