بوابة PayArc Terminal
تتيح بوابة PayArc Terminal قبول المدفوعات الحضورية على جهاز PayArc PAX من WCPOS عبر PayArc Connect. تبدأ عملية الدفع من WooCommerce وتُستكمل على الجهاز، ولا يُعلَّم الطلب بأنه مدفوع إلا بعد تأكيد PayArc ذلك.
الميزات
التكامل مع جهاز PAX الطرفي
أرسل المدفوعات إلى جهاز PayArc PAX الطرفي عبر PayArc Connect السحابي، من دون إقران محلي
إتمام موثّق
يجب أن يتطابق المبلغ والعملة مع الطلب قبل الإتمام؛ وتُحفظ العلامة التجارية للبطاقة وطريقة إدخالها وآخر 4 أرقام منها في الطلب
أسباب رفض واضحة
تُعرض أسباب الرفض لأمين الصندوق وتُضاف كملاحظة إلى الطلب
إيصالات الجهاز الطرفي
اطبع إيصال التاجر أو إيصال العميل أو كليهما على الجهاز الطرفي
تشخيصات مدمجة
تحقق من اتصالك باستخدام زر Validate Settings وجدول التشخيصات ذي المعرّفات المحجوبة جزئيًا
آلية العمل
يتصل WordPress بـ PayArc Connect، ثم يتصل PayArc بجهاز PAX الطرفي. لا يتواصل نظام POS إلا مع موقعك. وتُحصّل كل عملية دفع إجمالي الطلب بالكامل.
تتحقق صفحة الدفع من النتيجة كل 1.5 ثانية وتتوقف بعد 5 دقائق. تسرّع استدعاءات PayArc إلى Webhook URL ظهور النتيجة؛ ومع ذلك تكتمل المدفوعات عبر الاستطلاع حتى من دون استدعاءات. اترك صفحة الدفع مفتوحة أثناء دفع العميل على الجهاز الطرفي.
الإعداد
تثبيت PayArc Terminal لـ WooCommerce
ثبّت الإضافة من WP Admin > نقطة البيع > الإعدادات > الإضافات، أو نزّل ملف payarc-terminal-for-woocommerce.zip من صفحة إصدارات GitHub وارفعه عبر إضافات > إضافة جديد > رفع إضافة. ثم فعّل الإضافة.
أدخل بيانات اعتماد PayArc
- انتقل إلى
WP Admin > WooCommerce > الإعدادات > المدفوعاتوافتح PayArc Terminal - اختر Mode: الإعداد الافتراضي هو
Live. استخدمTestفقط مع بيانات اعتماد لوحة اختبار PayArc وتطبيق PayArc Connect Test. لا تخلط بين البيئتين - أدخل PayArc login email، وهو البريد الإلكتروني المستخدم لتسجيل الدخول إلى لوحة التاجر في PayArc
- أدخل PayArc MID من ملف التاجر في PayArc، وليس معرّف الجهاز الطرفي
- أدخل PayArc ClientSecret من قسم API في لوحة التحكم وPayArc SecretKey / API bearer token من لوحة PayArc
- اترك Callback bearer token فارغًا ما لم يزوّدك دعم PayArc به؛ فهو اختياري
اتصال
انقر Connect using these credentials. عند النجاح، ستطلب الشاشة إدخال الرقم التسلسلي للجهاز الطرفي أو تأكيده ثم حفظ الإعدادات. إذا ظهرت رسالة تفيد بأن بيانات الاعتماد تبدو خاصة بالبيئة الأخرى، فغيّر Mode وأعد الاتصال.
بعد أي تغيير في الوضع أو بيانات الاعتماد، انقر Connect using these credentials مرة أخرى واحفظ الإعدادات. تُحظر المدفوعات حتى يتطابق الوضع وبيانات الاعتماد مع الاتصال المحفوظ. إذا كنت ترقي من إصدار أقدم من 0.1.14، فانقر Connect مرة واحدة.
إضافة جهازك الطرفي
- أدخل Terminal serial number لجهاز PAX من ملصق S/N على ظهر الجهاز، وفق الإعداد الذي ضبطه PayArc لحسابك
- اختر Tender type وPrint receipt
- تحقق من أن Webhook URL يستخدم HTTPS. زوّد PayArc به فقط إذا طلبه
- انقر Save changes
يتطلب الوضع Live أن يستخدم الموقع HTTPS.
التفعيل في WCPOS
- انتقل إلى
WP Admin > نقطة البيع > الإعدادات > إتمام الطلب - اعثر على بوابة PayArc Terminal وفعّلها لنظام POS
- احفظ إعداداتك
يتحكم مربع الاختيار Enable/Disable في شاشة إعدادات WooCommerce بعملية الدفع في المتجر الإلكتروني فقط. يستخدم WCPOS هذه البوابة بعد إعدادها، سواء تم تحديد هذا المربع أم لا.
تترك معظم المتاجر هذا الخيار غير محدد.
مرجع الإعدادات
| الإعداد | وظيفته |
|---|---|
| Enable/Disable | يفعّل PayArc Terminal للدفع في المتجر الإلكتروني. متوقف افتراضيًا؛ ويُتحكم في تفعيله لنقطة البيع من نقطة البيع > الإعدادات > إتمام الطلب |
| Title | تسمية طريقة الدفع؛ القيمة الافتراضية PayArc Terminal |
| Description | وصف طريقة الدفع؛ القيمة الافتراضية Pay in person at a PayArc PAX terminal. |
| Mode | Live (افتراضي) أو Test. يتطلب Test بيانات اعتماد لوحة اختبار PayArc وتطبيق PayArc Connect Test |
| PayArc login email | البريد الإلكتروني لتسجيل الدخول إلى لوحة التاجر في PayArc؛ مطلوب قبل الاتصال |
| PayArc MID | معرّف MID للتاجر من ملف التاجر في PayArc، وليس معرّف الجهاز الطرفي |
| PayArc ClientSecret | السر من قسم API في لوحة التحكم؛ يُخزّن على خادمك فقط |
| PayArc SecretKey / API bearer token | الرمز من لوحة PayArc، ويُستخدم لتسجيل الدخول واسترداد سجل الأجهزة الطرفية |
| Callback bearer token | اختياري. أدخله فقط إذا زوّدك دعم PayArc به |
| PayArc connection | أزرار Connect using these credentials وRefresh Terminals وDisconnect |
| Terminal serial number | الرقم التسلسلي S/N لجهاز PAX المعيّن لحسابك، وهو مطلوب لإجراء المدفوعات. يُملأ من السجل إذا عُثر عليه؛ أدخله أو أكّده قبل الحفظ |
| Tender type | CREDIT (افتراضي) أو DEBIT |
| Print receipt | 0 — بلا إيصال (افتراضي)، 1 — للتاجر، 2 — للعميل، 3 — كلاهما |
| Webhook URL | عنوان استدعاء للقراءة فقط. تحقق من استخدامه HTTPS؛ زوّد PayArc به فقط إذا طلبه |
| PayArc diagnostics | معلومات الاتصال وزر Validate Settings؛ لا تُعرض الأسرار مطلقًا |
لا تعرض حقول الأسرار المحفوظة إلا آخر 4 أحرف. اترك حقل السر فارغًا للاحتفاظ بالقيمة المحفوظة.
يعرض جدول PayArc diagnostics الوضع ونقاط النهاية وMID / معرّف المستأجر / الرقم التسلسلي بعد إخفاء أجزاء منها، وما إذا كان رمز الوصول إلى Connect مُعدًا، وعنوان Webhook URL وآخر استدعاء وآخر خطأ من PayArc. استخدم Validate Settings للتحقق من إعداداتك.
الاستخدام
معالجة المدفوعات
- Select Gateway: اختر PayArc Terminal طريقةً للدفع في نظام POS
- Start Payment: انقر Start Payment لإرسال إجمالي الطلب إلى الجهاز الطرفي
- Customer Payment: اترك الصفحة مفتوحة إلى أن يُكمل العميل الدفع على جهاز PAX الطرفي. تابع رسائل الحالة:
Starting terminal payment...→Payment sent to terminal.→Waiting for the terminal result...→Payment approved. Completing the order... - Automatic Completion: يكتمل الطلب تلقائيًا عندما يؤكد PayArc الدفع
عناصر التحكم بالدفع
- يظهر Cancel Payment بعد بدء الدفع. إذا لم يُرجع PayArc معرّف التتبع بعد، فانتظر قليلًا قبل الإلغاء
- بعد الرفض أو الإلغاء أو انتهاء المهلة، يمكنك إعادة المحاولة. افحص الجهاز الطرفي قبل إعادة محاولة دفعة انتهت مهلتها
- يكون سجل نشاط الدفع مطويًا افتراضيًا. استخدم Show activity لعرضه وClear لمسح النشاط المعروض
الإيصالات
يتحكم إعداد Print receipt في الطباعة على الجهاز الطرفي: لا شيء أو للتاجر أو للعميل أو كليهما.
المبالغ المستردة
لا تدعم الإضافة استرداد الأموال. نفّذ الاسترداد عبر PayArc، ثم سجّل عملية الاسترداد يدويًا في WooCommerce.
السجلات
اعثر على السجلات في WooCommerce > Status > السجلات ضمن المصدر payarc-terminal-for-woocommerce. تتضمن السجلات محاولات الاتصال والمبيعات التي بدأت أو فشلت والإلغاءات والاستدعاءات المقبولة أو المرفوضة. تُخفى أجزاء من المعرّفات وتُحجب الأسرار.
لا يتوفر تنزيل لحزمة الدعم. عند طلب المساعدة، أرسل رقم الطلب وأسطر السجل ذات الصلة. لا تشارك أرقام MID أو معرّفات الأجهزة الطرفية أو الرموز أو بيانات البطاقة كاملة.
المتطلبات
النطاق والقيود
- لا تدعم الإضافة عمليات استرداد الأموال
- تُحصّل المدفوعات إجمالي الطلب بالكامل؛ ولا تدعم المدفوعات الجزئية أو المقسمة
- الإكراميات غير مدعومة
- جهاز طرفي واحد لكل متجر: إعداد واحد للرقم التسلسلي، من دون اختيار لأمين الصندوق
- تقتصر العملات على USD وCAD وGBP وEUR وJPY
- تُحظر المدفوعات حتى يتطابق الوضع وبيانات الاعتماد مع الاتصال المحفوظ
استكشاف الأخطاء وإصلاحها
المشكلات الشائعة
تبدو بيانات الاعتماد خاصة بالبيئة الأخرى
- الوضع المحدد وبيانات الاعتماد من بيئتين مختلفتين
- غيّر Mode ليتوافق مع بيانات الاعتماد، أو استبدل بيانات الاعتماد بأخرى خاصة بالوضع المحدد
- انقر Connect using these credentials مرة أخرى واحفظ الإعدادات
تعذّر الاتصال بـ PayArc
- رفض PayArc بيانات اعتماد تسجيل الدخول. تحقق من البيانات المدخلة وحاول مرة أخرى
- تحقق من
WooCommerce > Status > السجلات، ضمن المصدرpayarc-terminal-for-woocommerce، لمعرفة التفاصيل
تعذرت معالجة طلب الدفع. (HTTP 500)
- هذه الرسالة التي تظهر لأمين الصندوق عامة. ابحث عن PayArc payment action failed في سجل WooCommerce لمعرفة السبب الحقيقي
- بعد تغيير الوضع أو بيانات الاعتماد، انقر Connect using these credentials مرة أخرى واحفظ الإعدادات
- تحقق من ملء Terminal serial number
- إذا أشار السجل إلى أن PayArc رفض رمز الوصول إلى Connect وSecretKey كليهما، فاطلب من دعم PayArc تأكيد تفعيل PayArc Connect V3 لحساب التاجر
- تحقق من أن عملة المتجر هي USD أو CAD أو GBP أو EUR أو JPY
رُفض الوصول. (HTTP 403) عند Start Payment
- حدّث إلى 0.1.12 أو إصدار أحدث؛ إذ يعالج هذا الإصدار الخطأ في جلسات POS
سجل الأجهزة الطرفية فارغ
- من الطبيعي أن يكون السجل فارغًا أو أن يظهر جهاز طرفي من دون معرّف POS
- بيانات السجل مخصصة للتقارير فقط. تستخدم المدفوعات Terminal serial number
تستغرق الدفعة وقتًا طويلًا
- تحقق من شاشة الجهاز الطرفي واترك صفحة الدفع مفتوحة
- تحقق من ملاحظات الطلب ولوحة PayArc قبل إعادة المحاولة
- تتحقق الصفحة كل 1.5 ثانية وتتوقف بعد 5 دقائق
الحصول على المساعدة
- أرفق رقم الطلب وأسطر السجل ذات الصلة بطلب الدعم
- زُر مستودع GitHub للإبلاغ عن المشكلات
- تواصل مع دعم PayArc بشأن الحساب وPayArc Connect وإعداد الجهاز الطرفي