رحلة الدفع بالبطاقة عبر PGW

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

تتبع هذه الصفحة دفعة واحدة من بدايتها إلى نهايتها، وتبيّن ما يرسله كل نوع من الأجهزة. أما تثبيت PGW وإعداده فمشروح في تثبيت برنامج جهاز البطاقات وإعداده، وسجلا الجهاز وMethod Group مشروحان في طرق الدفع وأجهزة الدفع.

دفعة واحدة خطوة بخطوة

لنأخذ فاتورة مبيعات بقيمة 1,150 فيها Payment Terminal محدد ولم يُدفع منها شيء بعد.

1. يضغط الكاشير ادفع الفاتورة. يأخذ نما المتبقي وهو 1,150. أما دفع جزء من الفاتورة فيأخذ المبلغ الذي يكتبه الكاشير، والسند يأخذ مبلغه. وإذا كان آخر سطر في جدول سطور الدفع بلا قيمة يستخدمه نما، وإلا أضاف سطرًا جديدًا، فلا يُكتب أبدًا فوق سطر مدفوع يدويًا أو ببطاقة سابقة.
2. يفحص نما الجهاز. يسأل المتصفح سيرفر نما هل الجهاز من نوع NearPay. وفي أي جهاز آخر ينتقل المتصفح إلى PGW.
3. يتصل المتصفح ببرنامج PGW. ينشئ مرجعًا جديدًا لهذه الدفعة ويحفظه في هذا المتصفح، ثم يتصل ببرنامج PGW على http://localhost:7842 بالمبلغ والمرجع. لا يمر شيء عبر سيرفر نما في هذه الخطوة، فالاتصال مباشر من المتصفح إلى الكمبيوتر الذي يعمل عليه. وإذا لم يستجب PGW يعرض المتصفح There is no connection on port 7842, please make sure that the PGW server is running. ولا يُخصم أي مبلغ.
4. يشغّل PGW الجهاز. يعرض شريط الحالة في PGW الرسالة Payment Transaction with value 1150 is processing، ويرسل PGW المبلغ إلى الجهاز عبر الاتصال المختار في نافذته، فيطلب الجهاز بطاقة العميل. وينتظر المتصفح حتى يمرّر العميل بطاقته أو يدخلها أو يكتب الرقم السري.
5. يرد الجهاز، ويعيد PGW الرد. يحوّل PGW رد الجهاز إلى مجموعة واحدة موحّدة من بيانات البطاقة (مذكورة أدناه)، ويسجّله في ملف السجل وفي نافذة Last Transactions، ثم يعيده إلى المتصفح.
6. يختار سيرفر نما طريقة الدفع. يرسل المتصفح بيانات البطاقة إلى سيرفر نما، فيبحث السيرفر في Method Group الخاص بالجهاز ويعيد طريقة الدفع من أول سطر يطابق البطاقة.
7. يتحقق المتصفح من الرفض. البطاقة المرفوضة، أو الرد الخالي من أي بيانات بطاقة، يتوقف هنا بالرسالة Purchase Transaction refused أو Purchase Transaction not completed successfully، ويبقى سطر الدفع كما كان.
8. يُملأ السطر. يأخذ سطر الدفع المبلغ، وطريقة الدفع، ورمز الموافقة في رقم العملية، وبيانات البطاقة، ويُعلَّم على أنه مدفوع من الجهاز. ثم يعيد نما حساب السطر كأن المبلغ كُتب يدويًا، فتتبعه رسوم الطريقة وضريبتها.

لا تُحفظ الفاتورة تلقائيًا، بل يحفظها الكاشير كأي مستند آخر. وإلى أن يحفظها تكون البطاقة قد خُصمت بينما لا يحتفظ نما بالدفعة إلا على الشاشة، فلا تغلق الشاشة دون حفظ.

وإذا لم يطابق أي سطر في Method Group البطاقة، يُملأ السطر مع ذلك لكن بلا طريقة دفع، ويختارها الكاشير يدويًا.

في نقاط البيع

برنامج نقاط البيع لا يعمل في متصفح، فهو يتصل ببرنامج PGW على localhost:7842 بنفسه، لكن الفكرة واحدة:

• يُؤخذ الجهاز من الماكينة (Register)، أو من إعدادات نقاط البيع إذا لم يكن للماكينة جهاز.
• في شاشة الدفع يظهر زر الجهاز على سطور طرق الدفع الموجودة في Method Group الخاص بذلك الجهاز. يكتب الكاشير المبلغ في السطر ويضغط الزر، أو Alt+F2.
• عند وصول الرد تجد نقطة البيع طريقة الدفع من Method Group. فإذا كانت البطاقة تخص طريقة غير السطر الذي استخدمه الكاشير، كأن استخدم سطر بطاقات وكانت البطاقة مدى، ينتقل المبلغ إلى سطر مدى، ويذهب رمز الموافقة إلى خانة رقم العملية في ذلك السطر.
• وبخلاف شاشات الويب، ترفض نقطة البيع البطاقة التي لا تطابق أي سطر في Method Group بالرسالة There is no payment method matched pgw properties. أضف سطرًا أخيرًا عامًّا إلى Method Group لتتجنب ذلك.
• إذا كان الحفظ التلقائي للفاتوره بعد الدفع بال terminal (Automatic Save Invoice After Terminal Payment) مفعّلًا في إعدادات نقاط البيع، تُحفظ الفاتورة فور أن يجعل الدفع بالبطاقة المدفوع مساويًا لإجمالي الفاتورة.

وشاشة الدفع بالبطاقة نفسها مشروحة في الدفع والتحصيل.

ما يرسله كل جهاز

في Method Group تسعة أعمدة للبيانات، وكل نوع من الأجهزة يملأ مجموعة مختلفة منها. لذلك ابنِ سطور Method Group على عمود يملؤه جهازك فعلًا، فالقاعدة على عمود يتركه الجهاز فارغًا لا تطابق أبدًا.

عمود Method Group	Geidea	InterPay	Neoleap
PAN Number / ApprovalCode	رمز نتيجة داخلي، وليس رقم البطاقة	رمز الموافقة	رقم البطاقة المخفي
Merchant Id	معرّف التاجر	فارغ	معرّف التاجر
Scheme Id / Card Scheme Name	رمز شبكة البطاقة	اسم شبكة البطاقة	رمز شبكة البطاقة، مثل P1
Terminal Id / Device Serial No	معرّف الجهاز	الرقم التسلسلي للجهاز	معرّف الجهاز
ECR Ref Number / Local Reference Number	المرجع الذي أرسله نما	الرقم المرجعي المحلي	الرقم المرجعي للعملية (RRN)
STAN Number / rrNumber	STAN	الرقم المرجعي للعملية	STAN
De55 Response	فارغ	استجابة DE55	رمز الاستجابة
Card Type	فارغ	نوع البطاقة	اسم شبكة البطاقة، مثل mada
Masked Card Number	فارغ	رقم البطاقة المخفي	رمز نشاط التاجر (MCC)

وعمليًا:

• Neoleap: طابِق على Card Type، مثل mada. ولا فرق بين الحروف الكبيرة والصغيرة.
• InterPay: طابِق على Card Type أو Scheme Id / Card Scheme Name.
• Geidea: يبقى Card Type فارغًا، فطابِق على Scheme Id / Card Scheme Name.

ولترى القيم الدقيقة التي يرسلها جهازك، خذ دفعة صغيرة بكل نوع من البطاقات وافتح نافذة Last Transactions في PGW. السطر الذي يبدأ بـ Response of payment transaction is يعرض كل البيانات، فانسخ القيمة إلى سطر Method Group. وقاعدة «يحتوي علي» (الافتراضية) هي الأكثر تسامحًا.

حين يضيع الرد

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

في فاتورة المبيعات اضغط ايجاد اخر عمليه دفع تمت ولم تصل معلوماتها (Fetch Last Terminal Payment Transaction) في المتصفح نفسه الذي أرسل الدفعة. يرسل المتصفح إلى PGW المرجع الذي حفظه في الخطوة 3، فيسأل PGW الجهاز عن آخر عملية ويعيدها فقط إن كانت تحمل المرجع نفسه، ثم يُملأ السطر تمامًا كما في الخطوة 8. وإذا كانت آخر عملية في الجهاز عملية أخرى لا يُملأ شيء ويعرض المتصفح Purchase Transaction not completed successfully.

وحين لا يملأ الاسترجاع السطر، وكذلك في نقاط البيع التي ليس فيها زر استرجاع لأجهزة PGW، راجع الإيصال الذي طبعه الجهاز ونافذة Last Transactions في PGW. فإن أظهرا الدفعة مقبولة فأدخل سطر الدفع يدويًا برمز الموافقة المطبوع في الإيصال.

لا يرسل PGW إلا دفعات، وليس فيه استرداد. فاسترداد مبلغ البطاقة يتم خارج نما بالإجراء الخاص بمزوّد الخدمة، ويُدخل سطر الاسترداد يدويًا.

حين تُرفض البطاقة

البطاقة المرفوضة تعرض Purchase Transaction refused. وحين يعيد الجهاز رمز استجابة يعرفه نما يأتي بعدها الرمز وسببه، مثل Purchase Transaction refused - 116 - Not Enough Balance. ويخبر الرمز الكاشير هل يعيد المحاولة، أم يطلب بطاقة أخرى، أم يطلب من العميل مراجعة بنكه. وكل الرموز ومعانيها في رموز رفض البطاقات.

كروم يطلب السماح بالوصول إلى هذا الجهاز

تطلب إصدارات كروم الأحدث الإذن قبل أن تتصل صفحة ويب ببرنامج على الكمبيوتر نفسه. فأول مرة يدفع فيها الكاشير بالبطاقة يعرض كروم نافذة تطلب السماح لموقع نما بـ Access other apps and services on this device (وفي الإصدارات الأقدم Look for and connect to any device on your local network). اضغط Allow.

وإن رُفض الطلب أو أُغلق فستفشل مدفوعات البطاقة برسالة المنفذ 7842 مع أن PGW يعمل. وللسماح به من جديد اضغط أيقونة معلومات الموقع على يسار العنوان، وافتح Site settings، واجعل Apps on device (في الإصدارات الأقدم: Local network access) على Allow، ثم أعد تحميل الصفحة.

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

ليس لأي من هذه الرسائل نص عربي في شاشات الويب، فتظهر بالإنجليزية على الشاشات العربية أيضًا.

الرسالة	لماذا	ما تفعله
There is no connection on port 7842, please make sure that the PGW server is running. You can download the setup file from here	لم يستطع المتصفح الوصول إلى PGW على هذا الكمبيوتر، أو لم يستطع معالجة رده.	تأكد أن PGW يعمل (أيقونته في منطقة الإشعارات) وأن Test Connection ينجح. وفي كروم تأكد أن chrome://flags/#block-insecure-private-network-requests معطّل. وفي إصدارات كروم الأحدث تأكد أن الموقع مسموح له بالوصول إلى PGW (انظر كروم يطلب السماح بالوصول إلى هذا الجهاز). وإن كان PGW يعمل واستمرت الرسالة فتأكد أن في Payment Terminal قيمة Method Group. وملف التثبيت على https://www.namasoft.com/bin/PGW-setup.msi.
«برجاء إختيار payment terminal»	المستند بلا Payment Terminal.	اختر الجهاز في رأس المستند.
Purchase Transaction refused (وقد يتبعها رمز وسبب)	رفض الجهاز أو البنك البطاقة، أو جاء الرد بلا رمز موافقة ولا نوع بطاقة.	راجع السبب في رموز رفض البطاقات، واطلب بطاقة أخرى أو وسيلة دفع أخرى.
Purchase Transaction not completed successfully	رد الجهاز بلا أي بيانات بطاقة، كأن ألغى العميل العملية على الجهاز، أو انتهت مهلة الجهاز، أو وجد الاسترجاع عملية أخيرة مختلفة.	راجع إيصال الجهاز، وإن لم يُخصم شيء فأعد الدفع.
There is no uncompleted transaction	ضُغط ايجاد اخر عمليه دفع تمت ولم تصل معلوماتها في متصفح لم يرسل أي دفعة إلى جهاز.	استخدم المتصفح الذي أرسل الدفعة، أو راجع إيصال الجهاز وأدخل السطر يدويًا.
There is no payment method matched pgw properties	في نقاط البيع: لا يطابق أي سطر في Method Group الخاص بالجهاز البطاقة.	أضف سطرًا لتلك البطاقة، أو سطرًا أخيرًا عامًّا بلا بيانات، إلى Method Group.
«من فضلك ادخل المبلغ المراد دفعه بال terminal»	في نقاط البيع: ضُغط زر الجهاز على سطر بلا مبلغ.	اكتب المبلغ في السطر أولًا.