تجاوز إلى المحتوى الرئيسي
الإصدار: 2.x

بوابة الدفع PayArc Terminal

يرسل PayArc Terminal عملية البيع من نقطة البيع إلى جهاز PayArc PAX. يدفع العميل على الجهاز، وتسجّل نقطة البيع الدفعة بمجرد أن يؤكدها PayArc.

تبدأ هذه الصفحة بالعمل على نقطة البيع. للاطلاع على إعداد بوابة الدفع، راجع إعداد PayArc Terminal.

ميزة Pro

يتطلب PayArc Terminal الإصدار 2.0 أو أحدث من WCPOS Pro.

قبول دفعة بالبطاقة​

افتح صندوق النقد أولًا

عند تفعيل فتح صندوق النقد وإغلاقه، لا تسجّل نقطة البيع أي دفعة ما دام الصندوق مغلقًا، وستحتاج إلى استرجاع أي مبلغ قُبض بالفعل بالبطاقة. راجع صناديق النقد للاطلاع على هذا الإعداد.

اضغط على الدفع في السلة. يظهر PayArc Terminal على شكل مربع في علامة التبويب المدفوعات، بجانب طرق الدفع الأخرى.

  1. اضغط على مربع PayArc Terminal.
  2. تحقق من اسم الجهاز الظاهر أعلى لوحة الأرقام: الجهاز: …. إذا كان لديك أكثر من جهاز، فاضغط على تغيير واختر الجهاز الموجود عند منضدتك. تتذكر نقطة البيع اختيارك للمرة القادمة.
  3. لقبض جزء من المبلغ المستحق بالبطاقة، أدخل المبلغ. يظل الباقي مستحقًا لتسديده بدفعة أخرى.
  4. اضغط على إرسال … إلى PayArc Terminal. تعرض نقطة البيع على الجهاز مع أربع خطوات: تم الإرسال وعلى الجهاز وتمت الموافقة وتم التحصيل.
  5. يدفع العميل على الجهاز. عند تحصيل الدفعة وعدم بقاء أي مبلغ مستحق، يُفتح الإيصال. إذا بقي مبلغ مستحق، فاقبضه باستخدام مربع آخر.

يفتح خيار التفاصيل أسفل الخطوات سجلًا للدفعة: وقت إرسالها، ووقت وصولها إلى الجهاز، والمبلغ الذي تمت الموافقة عليه. تحتفظ الدفعة بالعلامة التجارية للبطاقة وآخر 4 أرقام منها وطريقة قراءتها ورمز التفويض من PayArc.

لا يعرض الجهاز طلبًا لإضافة إكرامية. راجع الإكراميات لمعرفة الأجهزة التي تدعم ذلك.

إلغاء دفعة​

اضغط على إلغاء على الجهاز قبل أن يدفع العميل. تنتظر نقطة البيع تأكيد الجهاز، ثم تعرض تم إلغاء الدفعة.

إذا كانت قراءة البطاقة قد بدأت، فقد يرفض PayArc الإلغاء ويُكمل الدفع؛ وتواصل نقطة البيع التحقق وتعرض النتيجة. أثناء الانتظار، تعرض جارٍ الإلغاء — في انتظار تأكيد الجهاز وتتيح خيار تحرير هذه الدفعة. يتيح التحرير دفع الطلب بطريقة أخرى بينما يواصل متجرك التحقق من الجهاز.

تحذير

لا يؤدي التحرير إلى إلغاء الدفعة: فقد يظل الجهاز قادرًا على تحصيلها. تحقق من النتيجة على الجهاز قبل قبول دفعة أخرى.

عند حدوث مشكلة في الدفع​

تحذير

هل أكّد الجهاز مبلغًا مختلفًا؟ لا تقبض الدفعة مرة أخرى. تحقق أولًا من الجهاز والطلب ولوحة تحكم PayArc.

فشل الدفع: رُفضت البطاقة

اضغط على المحاولة مجددًا لإرسال الدفعة إلى الجهاز مرة أخرى، أو على اختيار طريقة أخرى للدفع باستخدام مربع آخر.

فشل الدفع مع ظهور رسالة من PayArc

رفض PayArc عملية البيع، مثلًا لأن الجهاز مطفأ أو غير متصل بالإنترنت. تحقق من الجهاز، ثم اضغط على المحاولة مجددًا.

انتهت المهلة — تم إلغاء الدفعة

لم يدفع أحد خلال 5 دقائق، أو انتظر الجهاز بطاقة ولم تُقدَّم أي بطاقة. تحقق من الجهاز، ثم اضغط على المحاولة مجددًا.

مربع PayArc Terminal معطّل

توضح نقطة البيع السبب أسفل المربعات. راجع عندما يتعذر استخدام مربع للاطلاع على جميع الأسباب.

  • لم يتم إعداد أي أجهزة لـ PayArc Terminal — لا يوجد في المتجر جهاز لبوابة الدفع هذه. يضيف المدير جهازًا في الخطوة 4 من إعداد PayArc Terminal.
  • قيد الاستخدام للطلب #… — الجهاز مشغول بدفعة لطلب آخر. أكمل تلك الدفعة أو ألغِها، أو اضغط على تغيير واختر جهازًا آخر.
  • يتطلب اتصالًا — نقطة البيع غير متصلة بالإنترنت. تمر الدفعة على الجهاز عبر متجرك، لذا اقبل الدفع بطريقة أخرى أو انتظر عودة الاتصال.
الاتصال غير مستقر، لا تزال المحاولة جارية

تظهر هذه الرسالة في سجل التفاصيل. تواصل نقطة البيع التحقق. اترك الشاشة مفتوحة: تستمر عملية الدفع على الجهاز.

دفعة عالقة، أو نقطة البيع تفيد بأن المزوّد لم يستجب
دفعة تستغرق وقتًا طويلًا في الانتظار
  • تحقق من شاشة الجهاز واترك شاشة الدفع مفتوحة
  • بعد 5 دقائق، تتوقف نقطة البيع وتعرض انتهت المهلة — تم إلغاء الدفعة
  • تحقق من الجهاز وملاحظات الطلب ولوحة تحكم PayArc قبل قبض الدفعة مرة أخرى
يتعذر قراءة دفعة سابقة عبر PayArc Terminal لهذا الطلب باستخدام بيانات اعتماد PayArc الحالية
  • اقبل الدفع بطريقة أخرى، أو اطلب المساعدة من المدير. يتضمن الطلب دفعة سابقة لتغيير الوضع أو بيانات الاعتماد
  • يتحقق المدير من تلك الدفعة في لوحة تحكم PayArc ضمن الوضع الذي قُبضت فيه
  • لاستخدام PayArc لهذا الطلب مرة أخرى، يعيد المدير PayArc إلى ذلك الوضع وينقر على الاتصال باستخدام بيانات الاعتماد هذه، ثم تعيد أنت تحميل الصفحة

استرجاع دفعة PayArc​

تُرسل عملية الاسترجاع إلى الجهاز الذي قَبِل عملية البيع، سواء للمبلغ كاملًا أو لجزء منه.

  1. في نقطة البيع، افتح شاشة الاسترجاع الخاصة بالطلب. راجع عمليات الاسترجاع.
  2. اختر استرجاع إلى PayArc Terminal واضغط على معالجة الاسترجاع.
  3. يرسل PayArc عملية الاسترجاع إلى الجهاز، حيث تُقبل أو تُرفض. تظل عملية الاسترجاع معلّقة حتى يستجيب الجهاز، وتُضاف النتيجة إلى ملاحظات الطلب.

تعمل عملية الاسترجاع في WP Admin باستخدام زر استرجاع … عبر PayArc Terminal في WooCommerce بالطريقة نفسها.

إذا ظلت عملية الاسترجاع معلّقة، فتحقق من لوحة تحكم PayArc قبل إجراء الاسترجاع مرة أخرى.

إذا لم يستجب PayArc لعملية استرجاع

يعيد متجرك إرسال الطلب كل 2 دقيقة، حتى 5 مرات، باستخدام مفتاح الطلب نفسه، كي يتعامل PayArc مع كل إعادة محاولة باعتبارها عملية الاسترجاع نفسها. إذا استمر عدم الاستجابة، يطلب المتجر من الموظفين التحقق من لوحة تحكم PayArc.

المدفوعات المقبوضة باستخدام إصدار أقدم

قُبضت دفعة PayArc هذه عبر لوحة دفع الطلب الخاصة بالإضافة. قُبضت الدفعة باستخدام الإصدار 0.1 من الملحق، قبل WCPOS 2، لذا لا تستطيع بوابة الدفع استرجاعها. أجرِ الاسترجاع في لوحة تحكم PayArc أو على الجهاز، ثم سجّله في WooCommerce باستخدام استرجاع … يدويًا.

إعداد PayArc Terminal​

يُعدّ المدير بوابة الدفع مرة واحدة في WP Admin، ثم يختار جهازًا لكل نقطة بيع.

قبل الإعداد: ما تحتاج إليه

المتطلبات​

يزوّدك PayArc بقيم MID وClientSecret وSecretKey، وبالرقم التسلسلي لجهاز أعدّه لك.

يتصل متجرك بكل جهاز عبر PayArc من خلال الإنترنت، لذا لا حاجة إلى إقران، ويمكن لأي نقطة بيع استخدام أي جهاز من أجهزتك. في غياب WCPOS Pro 2.0 أو أحدث، يعرض الملحق إشعارًا في WP Admin ولا يضيف شيئًا إلى نقطة البيع.

حساب PayArc: حساب تاجر يتيح الوصول إلى PayArc Connect V3
الأجهزة المتوافقة: جهاز PAX مدعوم من PayArc ومخصّص لحسابك
الاتصالات: الاتصال عبر الإنترنت فقط. يرسل المتجر كل دفعة إلى جهاز PAX باستخدام رقمه التسلسلي، لذا يمكن لكل نقطة بيع استخدامه؛ وتختار نقطة البيع جهازها عند الدفع
WCPOS: WCPOS Pro 2.0 أو أحدث، والإصدار 1.0 أو أحدث من الملحق
الخادم: WooCommerce 7.0+ وPHP 7.4+ وHTTPS للوضع الفعلي
العملة: USD أو CAD أو GBP أو EUR أو JPY
ست خطوات: التثبيت، والاتصال، وإضافة جهازك، والتفعيل، واختيار جهاز لكل نقطة بيع
1

تثبيت PayArc Terminal for WooCommerce

نزّل payarc-terminal-for-woocommerce.zip، الإصدار 1.0 أو أحدث، من صفحة الإصدارات على GitHub وارفعه عبر إضافات > Add Plugin، ثم رفع إضافة. فعّل الإضافة.

قد لا يزال المسار WP Admin > نقطة البيع > الإعدادات > الإضافات يعرض الإصدار 0.1، الذي طُوّر قبل WCPOS 2. تحقق من الإصدار قبل التثبيت من هناك.

2

إدخال بيانات اعتماد PayArc

  1. انتقل إلى WP Admin > WooCommerce > الإعدادات > المدفوعات وافتح PayArc Terminal
  2. اختر الوضع: القيمة الافتراضية هي Live. استخدم Test فقط مع بيانات اعتماد لوحة تحكم الاختبار في PayArc وتطبيق PayArc Connect Test. لا تخلط بين البيئات أبدًا
  3. أدخل البريد الإلكتروني لتسجيل الدخول إلى PayArc، وهو البريد الذي تستخدمه لتسجيل الدخول إلى لوحة تحكم التاجر في PayArc
  4. أدخل PayArc MID من ملف التاجر في PayArc، وليس ID الجهاز
  5. أدخل PayArc ClientSecret من قسم API في لوحة التحكم، وPayArc SecretKey / رمز حامل API من لوحة تحكم PayArc
  6. اترك رمز حامل الاستدعاء الراجع فارغًا ما لم يصدر لك دعم PayArc رمزًا
3

الاتصال

انقر على الاتصال باستخدام بيانات الاعتماد هذه. عند النجاح، تعرض الشاشة متصل بـ PayArc وتطلب منك إدخال الرقم التسلسلي للجهاز أو تأكيده ثم الحفظ. إذا أفادت بأن بيانات الاعتماد تبدو خاصة بالبيئة الأخرى، فغيّر الوضع واتصل مجددًا.

ملاحظة

بعد أي تغيير في الوضع أو إحدى بيانات الاعتماد، انقر على الاتصال باستخدام بيانات الاعتماد هذه مجددًا، ثم احفظ. بعد تفعيل PayArc Terminal في WCPOS (الخطوة 5)، تظهر رسالة خطأ عند الحفظ إلى أن تفعل ذلك. أثناء وجود عملية دفع على جهاز، لا يمكنك تغيير الوضع أو بيانات الاعتماد أو الاتصال.

4

إضافة جهازك

  1. أدخل الرقم التسلسلي للجهاز PAX من ملصق S/N على ظهر الجهاز، كما أعدّه PayArc لحسابك
  2. اختر نوع الدفع وطباعة الإيصال
  3. تأكد من أن URL للخطاف الشبكي يستخدم HTTPS. أعطِه لـ PayArc فقط إذا طُلب منك ذلك
  4. انقر على حفظ التغييرات

تتيح نقطة البيع هذا الجهاز، إلى جانب كل جهاز يدرجه سجل أجهزة PayArc على أنه مفعّل لحسابك. يجلب الاتصال السجل، ويجلبه تحديث الأجهزة مجددًا. يُستبعد أي جهاز يصنّفه PayArc على أنه معطّل، حتى لو كان رقمه التسلسلي هو الرقم الذي أدخلته. ويظل الجهاز ذو الرقم التسلسلي الذي أدخلته متاحًا حتى إن لم يدرجه السجل. يتطلب الوضع الفعلي موقعًا يستخدم HTTPS.

5

تفعيله في WCPOS

  1. انتقل إلى WP Admin > نقطة البيع > الإعدادات > إتمام الطلب
  2. ابحث عن PayArc Terminal في القائمة وشغّل مفتاح مفعّل الخاص به
  3. يظهر المربع في نقطة البيع عند تحميل الصفحة في المرة التالية
ملاحظة

هذا هو مفتاح التفعيل الوحيد. لا يؤثر مفتاح مفعّل في قائمة المدفوعات في WooCommerce، ولا يظهر PayArc Terminal أبدًا ضمن خيارات الدفع في متجرك الإلكتروني. راجع إعدادات الدفع.

6

اختيار جهاز لكل نقطة بيع

على كل نقطة بيع، افتح الإعدادات > قارئات البطاقات. تظهر أجهزة PayArc ضمن القارئات الذكية، كل منها في صف، وتحمل جميعها علامة متصل: لا يُبلغ PayArc عمّا إذا كان الجهاز قيد التشغيل. اضغط على استخدام هذا القارئ للجهاز الموجود عند تلك المنضدة؛ وسيعرض صفه محدد. يظل بإمكان أمين الصندوق الضغط على تغيير عند الدفع.

إذا كان لديك جهاز PayArc واحد فقط، فلا حاجة إلى الاختيار: فهو محدد بالفعل على كل نقطة بيع. يعني ظهور محدد من قِبل المتجر في الصف أن نقاط البيع مقيدة بالجهاز الافتراضي للمتجر. راجع اختيار قارئ ذكي.

مرجع الإعدادات​

كل ما يظهر في صفحة بوابة الدفع ضمن WP Admin > WooCommerce > الإعدادات > المدفوعات > PayArc Terminal.

جميع إعدادات PayArc Terminal
الإعدادوظيفته
العنواناسم المربع في نقطة البيع؛ القيمة الافتراضية هي PayArc Terminal
الوصفوصف طريقة الدفع؛ القيمة الافتراضية هي Pay in person at a PayArc PAX terminal.
الوضعLive (الافتراضي) أو Test. يتطلب وضع الاختبار بيانات اعتماد لوحة تحكم الاختبار في PayArc وتطبيق PayArc Connect Test
البريد الإلكتروني لتسجيل الدخول إلى PayArcبريد تسجيل الدخول إلى لوحة تحكم التاجر في PayArc؛ مطلوب قبل الاتصال
PayArc MIDMID التاجر من ملف التاجر في PayArc، وليس ID الجهاز
PayArc ClientSecretالسر من قسم API في لوحة التحكم؛ يُخزَّن على خادمك فقط
PayArc SecretKey / رمز حامل APIالرمز من لوحة تحكم PayArc، ويُستخدم لتسجيل الدخول وقراءة سجل الأجهزة
رمز حامل الاستدعاء الراجعاختياري. أدخله فقط إذا أصدر لك دعم PayArc رمزًا
اتصال PayArcأزرار الاتصال باستخدام بيانات الاعتماد هذه وتحديث الأجهزة وقطع الاتصال
الرقم التسلسلي للجهازرقم PAX S/N الذي أعدّه PayArc لحسابك. مطلوب للمدفوعات
نوع الدفعCREDIT (الافتراضي) أو DEBIT
طباعة الإيصالالطباعة على الجهاز: 0 - No receipt (الافتراضي)، أو 1 - Merchant receipt، أو 2 - Customer receipt، أو 3 - Both receipts
URL للخطاف الشبكيعنوان الاستدعاء الراجع، للقراءة فقط. تأكد من أنه يستخدم HTTPS؛ وأعطِه لـ PayArc فقط إذا طُلب منك ذلك
تشخيص PayArcمعلومات الاتصال وزر التحقق من الإعدادات؛ لا تظهر الأسرار أبدًا

تعرض حقول الأسرار المحفوظة آخر 4 أحرف فقط. اترك حقل السر فارغًا للاحتفاظ بالقيمة المحفوظة.

يعرض جدول تشخيص PayArc الوضع، ونقاط نهاية PayArc، وما إذا كان البريد الإلكتروني لتسجيل الدخول ورمز الوصول إلى Connect قد أُعدّا، وقيمًا مخفية جزئيًا لـ MID وID المستأجر والرقم التسلسلي للجهاز، وعدد الأجهزة التي عُثر عليها، وURL للخطاف الشبكي، ووقت آخر استدعاء راجع، وآخر خطأ من PayArc. يفحص التحقق من الإعدادات الإعدادات المحفوظة ويسرد أي بيانات ناقصة.

يمسح قطع الاتصال اتصال PayArc المخزّن وقائمة الأجهزة والرقم التسلسلي للجهاز. تبقى بيانات اعتمادك، لتتمكن من الاتصال مجددًا بسرعة. تحقق من الرقم التسلسلي قبل الحفظ.

السجلات​

عند طلب المساعدة، أرسل رقم الطلب وأسطر السجل ذات الصلة.

العثور على السجلات للدعم

ابحث عن السجلات في WooCommerce > Status > السجلات، ضمن المصدر payarc-terminal-for-woocommerce. تُخفى المعرّفات جزئيًا وتُزال الأسرار.

لا يتوفر تنزيل لحزمة دعم. لا تشارك قيم MID كاملة أو معرّفات الأجهزة أو الرموز أو بيانات البطاقات.

النطاق والقيود​

  • لا تتوفر إكراميات على الجهاز
  • يقبل الجهاز دفعة واحدة في كل مرة؛ وأثناء انشغاله، ترى نقاط البيع الأخرى قيد الاستخدام للطلب #…
  • تقتصر العملات على USD وCAD وGBP وEUR وJPY
  • لا يوضح الاتصال ما إذا كان الجهاز قيد التشغيل: تفشل فورًا أي عملية بيع إلى جهاز غير متصل، دون إرسال أي شيء إليه
  • تُسترجع المدفوعات المقبوضة باستخدام الإصدار 0.1 من الملحق في PayArc، وليس عبر بوابة الدفع
  • تُرسل عملية الاسترجاع إلى الجهاز الذي قَبِل عملية البيع

عند حدوث مشكلة في الإعداد​

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

تبدو هذه بيانات اعتماد PayArc للاختبار (أو للوضع الفعلي)
  • الوضع المحدد وبيانات الاعتماد ينتميان إلى بيئتين مختلفتين في PayArc
  • غيّر الوضع إلى الوضع المذكور في الرسالة، أو استبدل بيانات الاعتماد بأخرى تخص الوضع المحدد
  • انقر على الاتصال باستخدام بيانات الاعتماد هذه مجددًا ثم احفظ
تعذر الاتصال بـ PayArc
  • رفض PayArc تسجيل الدخول. تحقق من بيانات الاعتماد المُدخلة وحاول مجددًا
  • راجع WooCommerce > Status > السجلات، المصدر payarc-terminal-for-woocommerce، للاطلاع على التفاصيل
يجب أن يستخدم URL للاستدعاء الراجع HTTPS قبل تفعيل الوضع الفعلي
  • يتطلب الوضع الفعلي أن يستخدم موقعك HTTPS، كي يتمكن PayArc من الوصول إلى URL للخطاف الشبكي
  • انقل الموقع إلى HTTPS، أو استخدم وضع الاختبار على موقع اختبار
سجل الأجهزة فارغ
  • حينها تتيح نقطة البيع الجهاز المحدد في الرقم التسلسلي للجهاز فقط، وتظل المدفوعات عبره تعمل
  • اطلب من PayArc تأكيد ذلك الرقم التسلسلي لحسابك، وإدراج أجهزتك الأخرى إذا أردت إتاحتها في نقطة البيع
  • انقر على تحديث الأجهزة بعد أن يضيفها PayArc
رفض PayArc كلًا من Connect AccessToken وSecretKey
  • رفض PayArc وصول حسابك إلى API المعاملات الخاص به
  • اطلب من دعم PayArc تأكيد تفعيل PayArc Connect V3 لحساب التاجر الخاص بك، وتحديد بيانات الاعتماد التي تمنح صلاحية إجراء معاملاته

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

  • أرفق رقم الطلب وأسطر السجل ذات الصلة مع طلب الدعم
  • زر مستودع GitHub للإبلاغ عن المشكلات
  • تواصل مع دعم PayArc للمساعدة في حسابك وإعداد PayArc Connect والجهاز