نظرة عامة

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

التهيئة

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

الحقول الأساسية

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

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

إعدادات التكامل مع Sherkety ERP API

عند ربط المزوّد ببوابة Sherkety، استخدم الحقول التالية:

API URL: عنوان الأساس لواجهة Sherkety ERP API.
API Key: مفتاح API السري للمصادقة مع الواجهة.
Public Key: مفتاح عام اختياري؛ لا يلزم في مسار التحويل لأن رابط صفحة الدفع المستضافة يتضمن المفتاح العام بالفعل.
Webhook Secret: السر المستخدم للتحقق من توقيعات Webhook.

إعدادات سلوك الدفع

طرق الدفع المدعومة: تحدد طرق الدفع التي يسمح بها هذا المزوّد.
السماح بحفظ طرق الدفع: يتيح للعميل حفظ طريقة الدفع كرابط دفع مجهول المصدر في قاعدة بيانات المزود، بما يسمح بإعادة استخدامها لاحقاً.
تحصيل المبلغ يدوياً: يحدد ما إذا كان التحصيل يتم من النظام عند اكتمال التسليم.
تمكين كود QR: يتيح استخدام أكواد QR عند الدفع عن طريق التحويل البنكي.
السماح بالدفع والخروج والسريع: يتيح استخدام طرق الدفع السريعة مثل Google Pay وApple Pay.
التواصل: يحدد طريقة التواصل التي ستظهر على أوامر البيع، مع خيارين:
- بناءً على مرجع المستند
- حسب مُعرف العميل
الحد الأقصى للمبلغ: أعلى مبلغ يمكن أن يكون المزوّد متاحاً عنده؛ اتركه فارغاً ليكون متاحاً لأي مبلغ.
العملات: العملات المتاحة مع هذا المزوّد؛ اتركه فارغاً إذا لم ترغب في تقييد العملة.

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

سير العمل

افتح شاشة مزودي الدفع من المسار: محاسبة > التهيئة > المدفوعات عبر الإنترنت > مزودي الدفع.
راجع حالة المزوّد في الولاية لتقرر الخطوة التالية:
- إذا كان معطل، فالمزوّد غير جاهز للاستخدام.
- إذا كان وضع الاختبار، فأنت في مرحلة التحقق التجريبي من التكامل.
- إذا كان ممكن، فالمزوّد جاهز للاستخدام في عمليات الدفع.
إذا كان الهدف هو التجربة والتحقق قبل الإتاحة، اترك المزوّد في وضع الاختبار وراجع الإعدادات المرتبطة بـ API URL وAPI Key وWebhook Secret وطرق الدفع المدعومة.
هذا يضمن اختبار الدفع عبر الواجهة التجريبية قبل تشغيله فعلياً.
إذا كانت الإعدادات صحيحة وأردت إتاحة المزوّد، غيّر الولاية إلى ممكن.
عند هذه النقطة يصبح المزوّد متاحاً لاستخدامه في الدفع وفقاً للقيود المحددة في الحقول الأخرى.
إذا كان المزوّد يحتاج إلى إعادة معالجة الرسائل غير المنفذة أو المعلّقة، استخدم إعادة تحميل الرسالة المعلقة.
استخدم هذا الإجراء عندما يكون هناك محتوى أو إشعار لم يكتمل التعامل معه ويحتاج إلى إعادة تحميله من جديد.
إذا كنت قد أنشأت المزوّد للتو أو عدّلت إعداداته الأساسية، استخدم تثبيت لتثبيت التغييرات وربط المزوّد بالحالة التشغيلية المناسبة.
بعد التثبيت، تحقق من أن الاسم والشركة ورمز وبيانات الواجهة قد اكتملت بما يطابق طريقة التشغيل المطلوبة.

تحذير: لا تجعل Public Key إلزامياً إذا كان مسار الدفع المعتمد لديك هو مسار التحويل عبر الصفحة المستضافة، لأن المفتاح العام يكون مضمَّناً في رابط الخروج نفسه حسب الوصف الوارد للحقل.

أمثلة

لنفترض أن قسم المالية يريد تفعيل مزوّد دفع باسم Sherkety Gateway لشركة الشركة الأم لاستخدامه في سداد فواتير العملاء عبر الإنترنت.

افتح مزودي الدفع.
أنشئ أو حدّث بطاقة المزوّد بحيث تكون القيم كالتالي:
- الاسم: Sherkety Gateway
- الولاية: وضع الاختبار
- الشركة: الشركة الأم
- رمز: Sherkety
- API URL: https://api.sherkety.example
- API Key: مفتاح سري خاص بالبيئة التجريبية
- Webhook Secret: سر التحقق من الإشعارات
- طرق الدفع المدعومة: البطاقات والتحويل البنكي
- السماح بحفظ طرق الدفع: مفعّل
- تحصيل المبلغ يدوياً: غير مفعّل
- تمكين كود QR: مفعّل
- السماح بالدفع والخروج والسريع: مفعّل
- التواصل: بناءً على مرجع المستند
- الحد الأقصى للمبلغ: 5000
- العملات: SAR
بعد حفظ التهيئة التجريبية، اترك الولاية على وضع الاختبار وأجرِ دفعة تجريبية للتأكد من أن بوابة الدفع والـ Webhook تعملان كما هو متوقع.
عند اكتمال الاختبار بنجاح، غيّر الولاية إلى ممكن ثم استخدم تثبيت لإتاحة المزوّد عملياً.
إذا وردت رسالة معلّقة من بوابة الدفع أثناء الاختبار أو بعده، استخدم إعادة تحميل الرسالة المعلقة لمعالجة المحتوى غير المنفذ من جديد.

نصائح

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

ملاحظة: الحقل Public Key اختياري، ولا يلزم في مسار التحويل إذا كان رابط الصفحة المستضافة يضم المفتاح العام بالفعل.

تحذير: إذا حدّدت الحد الأقصى للمبلغ أو العملات بشكل ضيق، فقد يصبح مزوّد الدفع غير متاح لبعض أوامر البيع أو الدفعات.

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

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

العرض لا يظهر كمتاح للدفع → غالباً تكون الولاية على معطل أو ما زالت في وضع الاختبار → غيّرها إلى ممكن بعد التأكد من صحة الإعدادات.
التحقق من الدفع لا يكتمل → قد يكون API Key أو Webhook Secret غير صحيحين → راجع بيانات Sherkety ERP API وأعد الحفظ.
مزوّد الدفع لا يظهر لبعض المعاملات → قد يكون السبب الحد الأقصى للمبلغ أو العملات المحددة بشكل يقيّد الاستخدام → وسّع النطاق أو اترك الحقول فارغة.
الرسائل المعلّقة لا تُعالج → قد تحتاج إلى استخدام إعادة تحميل الرسالة المعلقة بعد تعديل الإعدادات أو إصلاح مشكلة الاتصال.

مزودي الدفع