دليل التهيئة › محاسبة › التهيئة
دورة الحالة: Disabled ← Enabled ← Test Mode
الغرض
تحدد هذه الصفحة إعداد مزودي الدفع الذين يعتمد عليهم النظام في معالجة عمليات الدفع الإلكترونية ضمن المدفوعات عبر الإنترنت. يضبط هذا الإعداد خصائص المزود التقنية والتجارية، مثل حالة التفعيل، رمز المزود، بيانات واجهة برمجة التطبيقات، وسائل الدفع المدعومة، وحدود المبالغ والعملات، بحيث تتمكن المعاملات المالية من المرور عبر القناة الصحيحة وفقاً لإعدادات الشركة.
تُستخدم هذه التهيئة عند ربط مزود دفع بالنظام بحيث تصبح فواتير العملاء وعمليات السداد المرتبطة بها قابلة للمعالجة عبر المزود المحدد. كما تؤثر مباشرة في سلوك معالجة الدفعات، واستقبال الإشعارات التقنية، والتحقق من صحة التوقيعات، وتحديد ما إذا كان يمكن حفظ وسائل الدفع أو استخدام الدفع السريع أو رمز الاستجابة السريعة.
ملاحظة: سوء ضبط الحقول التقنية، مثل API Key أو Webhook Secret أو API URL، قد يؤدي إلى فشل عمليات الدفع أو عدم وصول الإشعارات الفنية من المزود.
إعدادات التهيئة
| الإعداد | القيم | الأثر |
|---|---|---|
| الاسم (Name) | إلزامي؛ نص حر | يحدد الاسم التعريفي لمزود الدفع في شاشة التهيئة وقوائم الاختيار الداخلية. |
| الحالة (State) | Disabled / Enabled / Test Mode | تتحكم في حالة مزود الدفع. في وضع الاختبار، تُجرى دفعة وهمية عبر واجهة دفع اختبارية، ويُوصى باستخدامه أثناء إعداد المزود. Enabled يجعل المزود متاحاً للاستخدام، وDisabled يعطله. |
| الرمز (Code) | إلزامي؛ No Provider Set / Custom / Sherkety | يحدد الرمز التقني لمزود الدفع. يستخدمه النظام لتمييز نوع المزود والمنطق التقني المرتبط به. |
| الشركة (Company) | إلزامي؛ شركة واحدة من الشركات المتاحة | يربط مزود الدفع بالشركة التي سيُطبَّق ضمنها هذا الإعداد. |
| عنوان URL لواجهة برمجة التطبيقات (API URL) | نص URL | يحدد عنوان الأساس لواجهة برمجة تطبيقات Sherkety ERP. |
| مفتاح واجهة برمجة التطبيقات (API Key) | نص سري | يحدد المفتاح السري المستخدم للمصادقة مع واجهة برمجة تطبيقات Sherkety ERP. |
| المفتاح العام (Public Key) | اختياري | مفتاح اختياري. يوضح النص المساعد أن عنوان الدفع المستضاف الذي تعيده واجهة Sherkety API يتضمن المفتاح العام للممر بالفعل، لذلك لا يكون هذا الحقل مطلوباً لمسار إعادة التوجيه. |
| السرّ الخاص بالإشعارات (Webhook Secret) | نص سري | يُستخدم للتحقق من صحة توقيعات الإشعارات التقنية الواردة من المزود. |
| وسائل الدفع المدعومة (Supported Payment Methods) | قائمة وسائل دفع | يحدد وسائل الدفع التي يدعمها هذا المزود. |
| السماح بحفظ وسائل الدفع (Allow Saving Payment Methods) | تفعيل أو تعطيل | يتحكم في السماح للعملاء بحفظ وسائل الدفع الخاصة بهم كرموز دفع. يوضح النص المساعد أن رمز الدفع يمثل ارتباطاً مجهول الهوية بتفاصيل وسيلة الدفع المخزنة. |
| التقاط المبلغ يدوياً (Capture Amount Manually) | تفعيل أو تعطيل | يحدد ما إذا كان يتم التقاط المبلغ من Flectra عند اكتمال التسليم. يُستخدم عندما يراد تحصيل بطاقات العملاء فقط بعد التأكد من إمكانية شحن البضاعة. |
| تفعيل رموز الاستجابة السريعة (Enable QR Codes) | تفعيل أو تعطيل | يفعّل استخدام رموز QR عند الدفع عبر التحويل البنكي. |
| السماح بالدفع السريع (Allow Express Checkout) | تفعيل أو تعطيل | يتحكم في السماح بوسائل الدفع السريعة. يوضح النص المساعد أن الدفع السريع يمكّن العملاء من الدفع عبر Google Pay وApple Pay، مع إتاحة معلومات العنوان ضمن مسار الدفع. |
| التواصل (Communication) | Based on Document Reference / Based on Customer ID | يحدد نوع التواصل الذي سيظهر في أوامر البيع. ويتم تسليم هذا التواصل إلى العميل عند اختيار وسيلة الدفع. |
| الحد الأقصى للمبلغ (Maximum Amount) | رقم؛ يترك فارغاً للسماح بأي مبلغ | يحدد الحد الأقصى لمبلغ الدفع الذي يكون هذا المزود متاحاً له. إذا تُرك الحقل فارغاً، يبقى المزود متاحاً لأي مبلغ. |
| العملات (Currencies) | قائمة عملات؛ يترك فارغاً لعدم التقييد | يحدد العملات المتاحة مع هذا المزود. إذا تُرك الحقل فارغاً، لا يتم تقييد المزود بأي عملة محددة. |
تنبيه: يجب أن تتوافق الحالة والرمز وبيانات التكامل التقنية مع نوع المزود المقصود. اختيار Test Mode مع إعدادات غير مكتملة قد يخفي مشكلات التكامل الفعلية حتى مرحلة التشغيل.
الاعتماديات
قبل تهيئة مزود الدفع، يجب أن تكون الشركة المستهدفة موجودة ومحددة، وأن تكون المدفوعات عبر الإنترنت ضمن هيكل التهيئة الخاص بالمحاسبة متاحة في النظام. كما يعتمد هذا الإعداد على توفر بيانات المزود التقنية، خصوصاً API URL وAPI Key وWebhook Secret عند استخدام Sherkety.
تؤثر هذه التهيئة في معالجة الدفعات، وفواتير العملاء، واختيار وسائل الدفع، وإشعارات الويبهوك الواردة من المزود. كما يعتمد التقاط المبلغ يدوياً على سيناريوهات تتعلق بإكمال التسليم قبل التحصيل، بينما يعتمد السماح بحفظ وسائل الدفع والسماح بالدفع السريع على سياسات الشركة في قبول رموز الدفع وخيارات الدفع السريعة.
الأثر على العمليات
عند تفعيل مزود الدفع وتهيئته بشكل صحيح، يتمكن النظام من توجيه عمليات السداد الإلكترونية وفق القواعد المحددة لهذا المزود، بما في ذلك التحقق من الإشعارات، وقبول أو رفض العمليات بحسب الحالة والعملات والمبالغ المسموح بها. كما ينعكس ذلك على معالجة فواتير العملاء وعمليات التحصيل المرتبطة بها، وعلى ظهور التواصل المعتمد في أوامر البيع عند اختيار وسيلة الدفع.
إذا تم ضبط السماح بحفظ وسائل الدفع أو السماح بالدفع السريع أو تفعيل رموز الاستجابة السريعة، فإن ذلك يغيّر قدرات الدفع المتاحة للمستخدمين النهائيين دون تغيير منطق التهيئة نفسه. أما الحالة فتحدد ما إذا كان المزود متاحاً فعلياً، أو يعمل في وضع الاختبار، أو يكون معطلاً.
ملاحظة: قد يؤدي ترك العملات أو الحد الأقصى للمبلغ دون تقييد إلى إتاحة المزود لمدى أوسع من المعاملات، وهو أمر ملائم في البيئات العامة لكنه قد لا يكون مناسباً عندما تُفرض قيود تشغيلية أو تعاقدية على مزود محدد.
Was this page helpful?