واجهة بوابة الطرفية Stripe
تتيح لك واجهة بوابة الطرفية Stripe قبول المدفوعات الشخصية باستخدام أجهزة قراءة الطرفية Stripe مباشرة داخل WooCommerce POS. تدعم هذه البوابة كل من أجهزة قراءة البطاقات الفعلية ووضع المحاكي للاختبار.
الميزات
- تكامل الأجهزة: الاتصال بأجهزة قراءة الطرفية Stripe الفعلية عبر اتصال الإنترنت
- وضع المحاكي: اختبار المدفوعات بدون أجهزة باستخدام محاكي Stripe
- طرق دفع متعددة: دعم لمجموعة متنوعة من أنواع البطاقات وطرق الدفع
- معالجة في الوقت الحقيقي: معالجة المدفوعات والتأكيد الفوري
- معاملات آمنة: معالجة مدفوعات متوافقة مع PCI عبر Stripe
- SDK قائم على الويب: يستخدم SDK JavaScript الخاص بـ Stripe لتوافق التطبيقات على الويب
التثبيت
الخطوة 1: تنزيل وتثبيت
- قم بزيارة صفحة إصدارات Stripe Terminal لـ WooCommerce
- قم بتنزيل أحدث ملف stripe-terminal-for-woocommerce.zip
- في لوحة إدارة WordPress الخاصة بك، انتقل إلى
الإضافات > إضافة جديد > تحميل الإضافة - قم بتحميل ملف zip وقم بتنشيط الإضافة
الخطوة 2: تكوين إعدادات Stripe
- انتقل إلى
WP Admin > WooCommerce > الإعدادات > المدفوعات - ابحث عن Stripe Terminal في قائمة طرق الدفع
- انقر على Stripe Terminal للوصول إلى الإعدادات
- أدخل مفتاح الأمان الخاص بـ Stripe (يمكنك الحصول على ذلك من لوحة معلومات Stripe الخاصة بك)
- احفظ الإعدادات
لا تحتاج إلى تفعيل بوابة الطرفية Stripe في إعدادات WooCommerce. سيتم تفعيلها خصيصًا لـ POS في الخطوة التالية.
الخطوة 3: التمكين في WooCommerce POS
- انتقل إلى
WP Admin > WooCommerce POS > الإعدادات > الدفع - ابحث عن بوابة Stripe Terminal في القائمة
- قم بتمكين البوابة للاستخدام في POS
- احفظ الإعدادات
الاستخدام
توصيل القارئ
عند اختيارك لبوابة الطرفية Stripe أثناء الدفع في POS:
- اختر طريقة الاتصال: يمكنك إما توصيل قارئ فعلي أو استخدام المحاكي
- قارئ فعلي: اتبع التعليمات على الشاشة لتوصيل جهاز طرفية Stripe الخاص بك
- المحاكي: اختر وضع المحاكي لاختبار سيناريوهات الدفع المختلفة بدون أجهزة
معالجة المدفوعات
- إضافة عناصر: أضف منتجات إلى سلة الدفع الخاصة بك في POS
- حدد البوابة: اختر "Stripe Terminal" كطريقة الدفع
- توصيل القارئ: قم بتوصيل القارئ الخاص بك أو اختر وضع المحاكي
- معالجة الدفع: اتبع التعليمات لإكمال المعاملة
- التأكيد: سيتم إكمال الطلب تلقائيًا عند الدفع الناجح
الاختبار باستخدام المحاكي
يتيح لك المحاكي اختبار طرق الدفع المختلفة وسيناريوهات:
- مدفوعات البطاقة: اختبار أنواع بطاقات مختلفة (فيزا، ماستركارد، إلخ)
- مدفوعات بدون تلامس: محاكاة معاملات الدفع عند اللمس
- سيناريوهات الأخطاء: اختبار المدفوعات المرفوضة وغيرها من شروط الأخطاء
- مبالغ مختلفة: اختبار مبالغ معاملات متنوعة
المتطلبات
- حساب Stripe: حساب Stripe نشط مع تمكين الطرفية
- مفاتيح API: مفتاح الأمان لـ Stripe من لوحة المعلومات الخاصة بك
- WooCommerce POS: الإصدار المجاني أو المدفوع مثبت ومفعل
- HTTPS: يجب أن يستخدم موقعك SSL/HTTPS للأمان
توافق الأجهزة
تستخدم هذه التنفيذ SDK JavaScript الخاص بـ Stripe، مما يعني أنه يعمل عبر التطبيقات على الويب ولكنه يتطلب محطات متصلة بالإنترنت فقط. لا تدعم المحطات عبر البلوتوث حاليًا.
المحطات المدعومة (المتصلة بالإنترنت)
- قارئ Stripe S700 ✅ - محطة موصولة عبر Ethernet/WiFi
- WisePOS E ✅ - محطة موصولة عبر WiFi
المحطات غير المدعومة (البلوتوث)
- BBPOS Chipper 2X BT ❌ - تعمل عبر البلوتوث فقط
- BBPOS WisePad 3 ❌ - تعمل عبر البلوتوث فقط
- Verifone P400 ❌ - تعمل عبر البلوتوث فقط
سيتم إضافة دعم المحطات عبر البلوتوث لتطبيقات iOS وAndroid في الربع الأول من 2026. سيمكن ذلك دعم جميع أجهزة قراءة الطرفية المعتمدة من Stripe بما في ذلك M2 وWisePad 3.
استكشاف الأخطاء
المشاكل الشائعة
لا يمكن للقارئ الاتصال
- تأكد من أنك تستخدم محطة متصلة بالإنترنت مدعومة (S700 أو WisePOS E)
- تحقق من أن المحطة متصلة بالإنترنت عبر WiFi/Ethernet وأنها على الإنترنت
- تحقق من أن حساب Stripe الخاص بك لديه ميزة الطرفية مفعلة
- تأكد من أن المحطة مسجلة في لوحة معلومات Stripe الخاصة بك
تم رفض الدفع
- تحقق من أن حساب Stripe الخاص بك نشط وبحالة جيدة
- تحقق من أن البطاقة المستخدمة صالحة
- تأكد من توفر أموال كافية
أخطاء شهادة SSL
- تتطلب الطرفية Stripe استخدام HTTPS - تأكد من أن موقعك يحتوي على شهادة SSL صالحة
- تحقق من أن شهادة SSL الخاصة بك مُعدة بشكل صحيح
الحصول على المساعدة
للحصول على الدعم الفني:
- قم بزيارة مستودع GitHub للإبلاغ عن المشاكل
- تحقق من وثائق الطرفية Stripe للحصول على إرشادات محددة للأجهزة
- اتصل بدعم Stripe لقضايا متعلقة بالحساب
لقطات الشاشة
سيتم إضافة لقطات الشاشة في تحديث قادم لعرض:
- إعداد بوابة في إعدادات دفع WooCommerce
- واجهة الدفع في POS مع اختيار الطرفية Stripe
- واجهة اختبار المحاكي مع طرق الدفع المختلفة