بوابة القارئ PayPal (Zettle).

تتيح لك بوابة قارئ PayPal قبول مدفوعات البطاقة شخصيًا باستخدام محطة البطاقة PayPal Reader (Zettle) مباشرة من WCPOS. يقوم المتصفح ببث حالة الدفع المباشر من القارئ عبر اتصال آمن بـ Zettle's Reader Connect API، بحيث يرى أمين الصندوق كل خطوة من خطوات الدفع فور حدوثها.

الميزات

مدفوعات البطاقة الشخصية

احصل على مدفوعات الشريحة والدفعات غير التلامسية والمحفظة المحمولة على محطة قارئ PayPal (Zettle)

حالة الدفع المباشر

يُظهر POS التقدم في الوقت الفعلي — الاتصال أو الدفع قيد التقدم أو المكتمل أو الإلغاء

تم التحقق من المبلغ من جانب الخادم

يتم دائمًا التحقق من المبلغ المبلغ عنه مقابل إجمالي الطلب قبل تقديم الطلب

الاقتران البسيط

قم بربط القارئ من إعدادات البوابة باستخدام رمز الاقتران الموضح على الجهاز

المتطلبات

WCPOS: الإصدار المحترف مطلوب للدفع POS

WordPress: WordPress 5.2+ مع WooCommerce نشط

PHP: PHP 7.4 أو أعلى

حساب Zettle: حساب تاجر مطور Zettle، بالإضافة إلى معرف عميل Zettle والتأكيد (JWT) من بوابة مطور Zettle

الأجهزة المتوافقة: محطة بطاقة قارئ PayPal (Zettle).

اتصال مستقر: حالة بث الدفعات المباشرة إلى القارئ عبر الشبكة وتتطلب اتصالاً بالإنترنت

الأجهزة والمناطق المدعومة

يتم تحديد توفر PayPal Reader / Zettle ونماذج القارئ المدعومة والبلدان المدعومة من خلال حساب التاجر Zettle الخاص بك، وليس من خلال WCPOS. تأكد من دعم القارئ والمنطقة لديك باستخدام PayPal/Zettle قبل الشراء.

التثبيت

1

قم بتثبيت قارئ PayPal لـ WooCommerce

قم بالتثبيت من WP Admin > POS > Settings > Extensions، أو قم بتنزيل أحدث أصل zip للمكون الإضافي (وليس كود مصدر GitHub المضغوط أو tarball) من صفحة إصدارات GitHub وقم بتحميله عبر Plugins > Add New > Upload Plugin. يجب تثبيت WooCommerce وتنشيطه.

2

تكوين البوابة

1. انتقل إلى WP Admin > WooCommerce > Settings > Payments
2. ابحث عن PayPal Reader في قائمة طرق الدفع وافتح إعداداته
3. اترك تمكين وضع الاختبار قيد التشغيل أثناء التحقق من الإعداد. استخدم بيانات الاعتماد من حساب التاجر الخاص بمطور Zettle في وضع الاختبار؛ قم بتعطيله لاحقًا لتلقي الدفعات المباشرة
4. أدخل معرف عميل Zettle — معرف عميل Zettle OAuth من بوابة مطور Zettle
5. أدخل تأكيد Zettle — تأكيد Zettle OAuth (JWT). يتم التعامل مع هذا باعتباره سرا
6. يمكنك اختياريًا تعيين العنوان والوصف المعروضين للعملاء
7. حفظ الإعدادات

ملاحظة

مربع الاختيار 'تمكين PayPal Reader للدفع عبر الويب' مخصص للدفع في متجرك عبر الإنترنت فقط - وهو غير مطلوب لـ POS. يمكنك تمكين بوابة POS في خطوة لاحقة.

3

إقران القارئ الخاص بك

1. بعد الحفظ، قم بالتمرير إلى قسم القراء المقترنين أسفل شاشة الإعدادات (يظهر بمجرد حفظ معرف العميل والتأكيد)
2. على جهاز قارئ PayPal، افتح الإعدادات ← الارتباط مع أحد المطورين لعرض رمز الاقتران
3. ضمن إقران قارئ جديد، أدخل رمز الإقران واسم القارئ بشكل اختياري (على سبيل المثال، 'العداد الأمامي')
4. انقر إقران القارئ. يظهر القارئ في القائمة المقترنة ويكون جاهزًا لتلقي الدفعات

مهم

يجب أن يتم إقران القارئ بنجاح قبل أن تتمكن من تلقي الدفعات. استخدم Unpair في القائمة المقترنة لإزالة القارئ.

4

تمكين في WCPOS

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

أخذ الدفع

1. أضف العناصر إلى سلة التسوق في POS وتابع عملية الدفع
2. اختر PayPal Reader كوسيلة للدفع
3. اختر قارئًا مقترنًا وابدأ بالدفع. (إذا لم يتم إقران أي منها، فستتم مطالبتك بمطالبة مسؤول المتجر بإقران واحد في WooCommerce → Settings → Payments → PayPal Reader.)
4. يعرض POS الحالة المباشرة أثناء اتصاله: 'جارٍ الاتصال بالقارئ...', 'القارئ جاهز. طلب الدفع...', 'جاري الدفع...'
5. ينقر العميل على بطاقته أو يُدخلها على القارئ
6. عند النجاح، يتم التحقق من المبلغ مقابل إجمالي الطلب، ويتم تسجيل مرجع المعاملة، ويتم تقديم الطلب تلقائيًا
7. استخدم إلغاء الدفع في أي وقت لإلغاء الطلب على القارئ

بث مباشر

عندما تتحقق من كل شيء في وضع الاختبار:

1. تعطيل ** تمكين وضع الاختبار **
2. استبدل بيانات اعتماد اختبار Zettle الخاصة بك بمعرف العميل والتأكيد الإنتاج
3. حفظ - نقاط النهاية والتدفق متطابقة؛ يختلف حساب التاجر فقط

خلاصة المتطلبات والقيود

• لا يكتمل الطلب إلا بعد نتيجة مؤكدة للقارئ. لن يقوم WCPOS بتقديم الطلب إلا إذا اكتملت تقارير الدفع.
• حماية من عدم تطابق المبلغ. إذا كان المبلغ الذي أبلغ عنه القارئ لا يتطابق مع إجمالي الطلب، فسيتم رفض الدفع — لذا تجنب تعديل إجمالي سلة التسوق في منتصف الدفع.
• الاتصال. تعتمد الدفعات المباشرة على احتفاظ المتصفح بجلسة لـ Zettle's Reader Connect API؛ مطلوب اتصال إنترنت مستقر.

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

لا يظهر قسم القراء المقترنين

احفظ معرف عميل Zettle والتأكيد أولاً. تظهر لوحة الاقتران فقط بمجرد حفظ بيانات الاعتماد. ستشاهد بخلاف ذلك 'احفظ معرف عميل Zettle والتأكيد أعلاه قبل إقران القارئ.'

لن يتمكن القارئ من الاقتران

• على القارئ، تأكد من فتح الإعدادات → الارتباط مع أحد المطورين للحصول على رمز اقتران جديد
• أدخل الرمز تمامًا كما هو موضح، قبل انتهاء صلاحيته
• تأكد من صحة معرف عميل Zettle والتأكيد وحفظهما
• تأكد من أن القارئ وشبكتك يتمتعان باتصال مستقر بالإنترنت

تم رفض الدفع بسبب عدم تطابق المبلغ

يتحقق البرنامج المساعد من المبلغ الذي أبلغ عنه القارئ مقابل إجمالي الطلب ويرفض أي عدم تطابق. لا تغير عربة التسوق أو إجمالي الطلب أثناء إجراء الدفع — قم بإلغاء الدفع، واضبط عربة التسوق، ثم ابدأ عملية دفع جديدة.

لا تتم معالجة أي مدفوعات حقيقية / يظهر تحذير المشرف بشأن 'القارئ الوهمي'.

يتم تعريف ثابت التطوير/CI (PRWC_USE_MOCK_READER) في wp-config.php. قم بإزالة هذا الثابت قبل تلقي الدفعات المباشرة - أثناء تعيينه، لا تتم معالجة أي دفعات حقيقية.

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

• الإبلاغ عن مشكلات البوابة في مستودع GitHub
• اتصل بدعم PayPal/Zettle بخصوص الحساب وأجهزة القارئ والأسئلة المتعلقة بالتوفر الإقليمي