برنامج PGW: تثبيت برنامج جهاز البطاقات وإعداده

جهاز البطاقات على الكاشير لا يستطيع التحدث مع صفحة ويب. نما يعمل في متصفح الكاشير، وجهاز Geidea أو Neoleap أو InterPay موصول بكمبيوتر الكاشير بكابل أو موجود على شبكة المحل. برنامج PGW (Namasoft Payment Gateway) هو ما يربط بين الطرفين. وهو برنامج ويندوز صغير يُثبَّت على كمبيوتر الكاشير. من جهة ينتظر طلبات نما على المنفذ 7842 على ذلك الكمبيوتر، ومن الجهة الأخرى يتحدث بلغة جهاز البطاقات نفسه. حين يضغط الكاشير ادفع الفاتورة يسلّم المتصفح المبلغ إلى PGW، فيرسله PGW إلى الجهاز، وينتظر بطاقة العميل، ثم يعيد النتيجة.

ولأن المتصفح يتصل دائمًا ببرنامج PGW على الكمبيوتر نفسه (localhost)، يحتاج كل كمبيوتر كاشير يقبل البطاقات إلى نسخته الخاصة من PGW، مضبوطة على الجهاز الموصول به. أما أجهزة NearPay فلا تستخدم PGW إطلاقًا، وهي مشروحة في طرق الدفع وأجهزة الدفع.

هذه الصفحة عن برنامج PGW نفسه. أما ما يحدث أثناء الدفع فمشروح في رحلة الدفع بالبطاقة عبر PGW.

ما يحتاجه نما قبل استخدام PGW

لا يعمل PGW إلا مع سجلات مُعدّة مسبقًا في نما:

1. سجل Payment Terminal للجهاز، وفيه Method Group يحوّل البطاقة التي استخدمها العميل إلى طريقة دفع. وكلاهما مشروح في طرق الدفع وأجهزة الدفع.
2. حقل Provider في سجل الجهاز يمكن أن يكون أي قيمة عدا NearPay. فنما لا يفحص إلا هل الجهاز NearPay أم لا، وكل جهاز آخر، ومنه الجهاز الذي ليس له مزوّد، يُرسَل إلى PGW، وPGW هو الذي يحدد نوع الجهاز الذي يتحدث معه. ولا توجد قيمة Neoleap في القائمة، فاختر لجهاز Neoleap إحدى القيمتين InterPay أو Geidea، أو اترك الحقل فارغًا. ولا يُستخدم عنوان السيرفر ولا المنفذ في سجل الجهاز مع PGW، بل يُكتب عنوان الجهاز في PGW نفسه.
3. المستند أو ماكينة نقاط البيع يحدد ذلك الجهاز: حقل Payment Terminal في فاتورة المبيعات، أو الجهاز في الماكينة (Register) في نقاط البيع.

تثبيت PGW

1. على كمبيوتر الكاشير، نزّل ملف التثبيت من https://www.namasoft.com/bin/PGW-setup.msi وشغّله. يحتاج PGW إلى ‎.NET Framework 4.7.2 أو أحدث، وهو موجود أصلًا في إصدارات ويندوز الحالية.
2. شغّل PGW من الاختصار الذي ينشئه برنامج التثبيت. عنوان نافذته Namasoft Payment Gateway. ويعمل PGW بصلاحيات المسؤول (Administrator)، فقد يطلب ويندوز الإذن عند تشغيله.
3. في أول تشغيل يضيف PGW نفسه إلى مجلد بدء التشغيل في ويندوز، فيعمل مع ويندوز بعد ذلك. وإن لم تجده يعمل بعد إعادة التشغيل فشغّله من الاختصار.

لا تعمل إلا نسخة واحدة في الوقت نفسه. وتشغيله مرة ثانية يعرض Another instance of Namasoft payment gateway is already running! وتُغلق النسخة الثانية.

صغّر النافذة ولا تغلقها

إغلاق نافذة PGW بزر X يوقف البرنامج، فتفشل دفعة البطاقة التالية في المتصفح بالرسالة There is no connection on port 7842, please make sure that the PGW server is running. لذلك صغّر النافذة بدلًا من إغلاقها. وأيقونة PGW (Namasoft PGW) في منطقة الإشعارات بويندوز تعيد فتح النافذة بالنقر المزدوج عليها. وفي قائمتها بالزر الأيمن الأمر Exit، وهو أيضًا يوقف PGW.

اختيار طريقة الاتصال

في نافذة PGW اختيار رئيسي واحد هو Connection Type (نوع الاتصال)، ومعه الحقول التابعة له. كل اختيار يخبر PGW بنوع الجهاز الموصول وطريقة الوصول إليه:

Connection Type	ما يحتاجه PGW	إعدادات ثابتة يستخدمها PGW
Geidea COM Port	منفذ COM Port الموصول به كابل الجهاز.	سرعة 38400 baud
Geidea TCP/IP	عنوان IP للجهاز على شبكة المحل.	المنفذ 6100 على الجهاز
Neoleap COM Port	منفذ COM Port للجهاز.	سرعة 9600 baud
Neoleap TCP/IP	عنوان IP للجهاز.	المنفذ 9999 على الجهاز
Interpay	تطبيق softPOS الخاص بـ InterPay مثبّتًا ويعمل على الكمبيوتر نفسه، ويمرّر PGW الدفعة إليه.	softPOS على هذا الكمبيوتر، على Interpay Port (‏8080 ما لم يُغيَّر)
Nami COM Port / Nami TCP/IP	برنامج Nami الوسيط (Nami middleware) مثبّتًا ويعمل على الكمبيوتر نفسه، مع منفذ COM أو عنوان IP للجهاز.	البرنامج الوسيط على المنفذ 9099 على هذا الكمبيوتر، والجهاز على المنفذ 8888 في TCP/IP، وسرعة 115200 baud في COM.

المنافذ والسرعات في العمود الأخير مثبّتة داخل PGW ولا يمكن تغييرها من نافذته. وإذا طلب الجهاز نفسه منفذ أو سرعة ECR (ربط الكاشير) فاضبطه على القيمة الموجودة في هذا الجدول.

يحفظ PGW كل تغيير فور حدوثه ويعيد تحميله عند التشغيل التالي، فلا يحتاج الكمبيوتر إلى إعداد جديد بعد إعادة تشغيله.

الاتصال عبر منفذ COM

اختيار نوع اتصال COM يملأ قائمة COM Port بالمنافذ التي يراها ويندوز حاليًا. وإذا وُصل الجهاز بعد امتلاء القائمة فاضغط زر التحديث بجانبها. ثم اختر المنفذ الموصول به الجهاز، ويمكنك معرفته من إدارة الأجهزة (Device Manager) في ويندوز تحت Ports (COM & LPT).

الاتصال عبر TCP/IP

اكتب عنوان الجهاز في خانات TCP/IP الأربع، رقمًا في كل خانة، ثم اضغط Enter في إحدى الخانات بعد امتلاء الأربع. لا يحفظ PGW العنوان إلا عند ضغط Enter، فإن كتبت العنوان ثم انتقلت بالفأرة إلى مكان آخر يظل PGW يستخدم العنوان السابق.

أعطِ الجهاز عنوانًا ثابتًا من الراوتر. فإذا تغيّر العنوان يظل PGW يتصل بالعنوان القديم، وتفشل كل دفعة حتى يُكتب العنوان الجديد.

InterPay

مع Interpay لا يصل PGW إلى الجهاز بنفسه، بل يمرّر الدفعة إلى تطبيق softPOS الخاص بـ InterPay، والذي يجب أن يكون مثبّتًا (في C:\interpay\softposService) ويعمل على الكمبيوتر نفسه. ويلتقي البرنامجان على Interpay Port، وقيمته الافتراضية 8080.

إذا كان برنامج آخر على الكمبيوتر يستخدم المنفذ 8080 فاختر منفذًا آخر:

1. اكتب منفذًا من أربعة أرقام في Interpay Port.
2. اضغط زر الحفظ بجانبه (تلميحه Save interpay port to softpos app). يكتب PGW المنفذ في ملف إعدادات softPOS ويعرض Done, please restart softpos!
3. أعد تشغيل softPOS.

التعبئة التلقائية (Auto fill)

زر Auto fill data يبحث في منافذ COM على الكمبيوتر عن جهاز Geidea أو Neoleap. يفحص أسماء الأجهزة التي يعرضها ويندوز، ويجرّب كل منفذ عند الحاجة. فإن وجد جهازًا ملأ نوع الاتصال والمنفذ بنفسه، وإن لم يجد عرض There is no payment terminal connected via com port or by ip address. أما الجهاز الموجود على الشبكة فاكتب عنوانه كما سبق.

اختبار الاتصال

اضغط Test Connection بعد أي تغيير. يتحقق PGW من أن الجهاز (أو softPOS، أو برنامج Nami الوسيط) يستجيب، ويعرض النتيجة في نافذة صغيرة. وكلمة Success تعني أن الإعداد صحيح، وأي رد آخر مشروح في رسائل قد تظهر لك.

الاختبار الناجح لا يخصم أي مبلغ. والاختبار الحقيقي هو دفعة صغيرة من فاتورة تجريبية.

تحديث PGW

تعرض النافذة الإصدار المثبّت (Version: 14 مثلًا). وفي كل تشغيل يتحقق PGW من موقع namasoft.com من وجود إصدار أحدث، فإن وُجد صار زر Upgrade version فعّالًا.

الضغط عليه يسأل There is new version of PGW, Do you want to install it? فإن أجبت بنعم ينزّل PGW ملف التثبيت الجديد إلى مجلد المستندات (Documents) ويشغّله ثم يعيد تشغيل نفسه. اضغط Test Connection بعدها لتتأكد أن الجهاز ما زال يستجيب. وإذا لم يكن على الكمبيوتر إنترنت يبقى الزر معطّلًا، فنزّل ملف التثبيت على كمبيوتر آخر وشغّله على كمبيوتر الكاشير.

نافذة آخر العمليات وملف السجل

زر Last Transactions في شريط الحالة يفتح قائمة بما فعله PGW مؤخرًا: طلبات الدفع التي استقبلها، وما أرسله إلى الجهاز، ورد الجهاز، مع تاريخ ووقت كل منها. وتحتفظ القائمة بأحدث السطور. حدّد السطور واضغط Ctrl+C لنسخها (وCtrl+A يحدد الكل)، لإرسالها إلى الدعم مثلًا. وتختفي النافذة وحدها بعد دقيقتين.

ويُكتب كل شيء، ومنه الأخطاء، في الملف pgw.log في مجلد تثبيت PGW. وهذا الملف هو ما يطلبه دعم نما حين تتعثر دفعة.

وشريط الحالة أسفل النافذة الرئيسية يعرض الدفعة الجارية (Payment Transaction with value 150 is processing، Waiting for response from terminal ...).

رسائل قد تظهر لك

ليس لبرنامج PGW واجهة عربية، فكل رسائله بالإنجليزية.

الرسالة	لماذا	ما تفعله
Another instance of Namasoft payment gateway is already running!	شُغّل PGW وهو يعمل بالفعل.	لا شيء. استخدم النسخة التي تعمل، وانقر نقرًا مزدوجًا على أيقونتها في منطقة الإشعارات لتظهر.
Please select Com port	ضُغط Test Connection لنوع اتصال COM دون اختيار منفذ.	اختر المنفذ، واستخدم زر التحديث إن كانت القائمة فارغة.
Please enter ip	ضُغط Test Connection لنوع اتصال TCP/IP وإحدى خانات العنوان فارغة.	املأ الخانات الأربع واضغط Enter.
Connection failed, Choose another COM Port and Make Sure the machine is correctly connected	جهاز Geidea لم يستجب على المنفذ المختار.	افحص الكابل واختر المنفذ الذي تعرضه إدارة الأجهزة للجهاز.
Connection failed, Choose another Ip	جهاز Geidea لم يستجب على هذا العنوان.	تحقق من عنوان الجهاز ومن أنه على شبكة الكمبيوتر نفسها.
Failed! please check setup, the connection and cable	لم يستطع PGW تحميل اتصال Neoleap.	افحص الكابل، واضبط المنفذ أو العنوان، ثم اختر نوع الاتصال من جديد واختبر.
1 API_LIBRARY_FAILED، 2 API_NO_RESPONSE، 3 API_PORT_OPEN_FAILED، 4 API_FAILED، 5 API_TIMEOUT، 7 API_PAYMENT_NO_RESPONSE	رد جهاز Neoleap على الاختبار. الرقم 3 يعني تعذّر فتح منفذ COM، والرقمان 2 و5 يعنيان أن الجهاز لم يستجب.	في 3 أغلق أي برنامج آخر يستخدم المنفذ، أو اختر المنفذ الصحيح. وفي 2 و5 افحص الكابل أو العنوان وتأكد أن الجهاز يعمل.
Please run softpos application- if already running, edit interpay port and click on save to softpos button then restart softpos application	لم يستطع PGW الوصول إلى softPOS على Interpay Port.	شغّل softPOS. وإن كان يعمل فاحفظ المنفذ من جديد كما في InterPay وأعد تشغيل softPOS.
Please run softpos application	أُرسلت دفعة وsoftPOS لا يعمل.	شغّل softPOS وأعد محاولة الدفع.
Please insert valid port!	Interpay Port ليس من أربعة أرقام.	اكتب منفذًا من أربعة أرقام.
Done, please restart softpos!	حُفظ المنفذ في softPOS.	أعد تشغيل softPOS.
Error writing port number to interpay configuration file!, port reset to 8080	لم يجد PGW ملف إعدادات softPOS أو لم يستطع تعديله.	تأكد أن softPOS مثبّت في C:\interpay\softposService. وإلى أن يُصلح ذلك يستخدم PGW وsoftPOS المنفذ 8080.
Nami middleware is not installing or not running! please install and run it	اختير نوع اتصال Nami، لكن برنامج Nami الوسيط لا يستجيب على هذا الكمبيوتر.	ثبّت برنامج Nami الوسيط وشغّله.
There is no payment terminal connected via com port or by ip address	لم يجد زر Auto fill data أي جهاز Geidea أو Neoleap.	اختر نوع الاتصال والمنفذ بنفسك.
Config file is corrupted. Restore settings to defaults...	تلف ملف إعدادات PGW، بسبب انقطاع الكهرباء مثلًا.	يعيد PGW إعداداته إلى الأصل، فاختر الاتصال من جديد.
You have already the last version!	ضُغط Upgrade version وPGW محدَّث.	لا شيء.
New version is not installed	تعذّر تنزيل التحديث أو تثبيته.	نزّل ملف التثبيت من الرابط السابق وشغّله بنفسك.