نظرة عامة

تُستخدم صفحة مزودي الدفع لإدارة إعدادات مزود الدفع المتاح للمدفوعات عبر الإنترنت ضمن الشركة. يستخدمها المحاسب المالي ومدير المالية عند إعداد التكامل مع Sherkety ERP API، وتحديد حالة المزود وطرق الدفع والعملات والحدود المالية التي ينطبق عليها.

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

الإعدادات

انتقل إلى محاسبة > التهيئة > المدفوعات عبر الإنترنت > مزودي الدفع.

افتح سجل مزود الدفع المطلوب، ثم راجع الإعدادات التالية:

الحقل	الاستخدام
الاسم (Name)	اسم مزود الدفع. هذا الحقل مطلوب.
الحالة (State)	تحدد ما إذا كان المزود معطّلاً أو مُمكّناً أو يعمل في وضع الاختبار.
الرمز (Code)	الرمز التقني لمزود الدفع. الخيارات المتاحة هي: لا يوجد مزود محدد (No Provider Set)، مخصص (Custom)، أو شركتي (Sherkety).
الشركة (Company)	الشركة التي ينطبق عليها مزود الدفع. هذا الحقل مطلوب.
رابط API ‏(API URL)	رابط الأساس لـ API الخاص بـ Sherkety ERP.
مفتاح API ‏(API Key)	مفتاح API السري المستخدم للمصادقة مع Sherkety ERP API.
المفتاح العام (Public Key)	مفتاح عام اختياري. لا يلزم لمسار إعادة التوجيه، لأن رابط صفحة الدفع المستضافة الذي يعيده Sherkety API يتضمن المفتاح العام للبوابة.
سرّ Webhook ‏(Webhook Secret)	السر المستخدم للتحقق من توقيعات Webhook.
طرق الدفع المدعومة (Supported Payment Methods)	طرق الدفع التي يدعمها هذا المزود.
السماح بحفظ طرق الدفع (Allow Saving Payment Methods)	يحدد ما إذا كان يمكن للعملاء حفظ طرق دفعهم كرموز دفع. رمز الدفع هو رابط مجهول لبيانات طريقة الدفع المحفوظة.
التحصيل اليدوي للمبلغ (Capture Amount Manually)	يسمح بتحصيل المبلغ من النظام عند اكتمال التسليم، بدلاً من تحصيله قبل التأكد من إمكانية شحن السلع.
تمكين رموز QR ‏(Enable QR Codes)	يتيح استخدام رموز QR عند الدفع بالتحويل البنكي.
السماح بالدفع السريع (Allow Express Checkout)	يتيح للعملاء استخدام طرق الدفع السريع، بما فيها Google Pay وApple Pay.
التواصل (Communication)	يحدد نوع التواصل الذي يظهر في أوامر البيع ويُعطى للعميل عند اختيار طريقة الدفع: بناءً على مرجع المستند (Based on Document Reference) أو بناءً على معرّف العميل (Based on Customer ID).
الحد الأقصى للمبلغ (Maximum Amount)	أعلى مبلغ يمكن أن يتاح له مزود الدفع. اتركه فارغاً لإتاحته لأي مبلغ.
العملات (Currencies)	العملات المتاحة مع مزود الدفع. اتركه فارغاً لعدم تقييد المزود بعملات محددة.

تحذير: تعامل مع مفتاح API ‏(API Key) وسرّ Webhook ‏(Webhook Secret) بوصفهما بيانات سرية. تحقّق من القيم المدخلة قبل تمكين المزود.

ملاحظة: استخدم المفتاح العام (Public Key) فقط عند الحاجة؛ فهو اختياري لمسار إعادة التوجيه المستضاف في Sherkety.

سير العمل

حدّد مزود الدفع والشركة قبل تهيئة الاتصال.
من لوحة مزودي الدفع، افتح سجل المزود الذي ستستخدمه للشركة المعنية. أدخل الاسم (Name)، واختر الشركة (Company)، ثم حدد الرمز (Code) المناسب للتكامل.

إذا كان المزود مخصصاً، اختر مخصص (Custom) ضمن الرمز (Code). وللتكامل مع Sherkety، اختر شركتي (Sherkety).
قرّر بين التعطيل والاختبار والتمكين.
راجع الحالة (State) واتخذ القرار المناسب:
- اختر معطّل (Disabled) عندما لا تريد إتاحة المزود للمدفوعات.
- اختر وضع الاختبار (Test Mode) عند إعداد المزود أو اختبار الاتصال. في هذا الوضع، تُعالج دفعة تجريبية عبر واجهة دفع اختبارية.
- اختر مُمكّن (Enabled) عندما تكون إعدادات المزود مكتملة وجاهزة للاستخدام الفعلي.
إن كنت تنتقل من إعداد جديد إلى اختبار، غيّر الحالة (State) إلى وضع الاختبار (Test Mode). وبعد نجاح التحقق، غيّرها إلى مُمكّن (Enabled). ولإيقاف الإتاحة، غيّرها إلى معطّل (Disabled).
أدخل بيانات اتصال Sherkety عند استخدامه.
عند اختيار شركتي (Sherkety) في الرمز (Code)، أدخل رابط API ‏(API URL) الذي يمثل رابط الأساس لـ Sherkety ERP API، ثم أدخل مفتاح API ‏(API Key) للمصادقة. أدخل سرّ Webhook ‏(Webhook Secret) للتحقق من توقيعات Webhook.

عند الحاجة، أدخل المفتاح العام (Public Key)، مع العلم بأنه اختياري لمسار إعادة التوجيه المستضاف.
حدّد طريقة الإتاحة والتحصيل المناسبة لسياسة البيع.
راجع طرق الدفع المدعومة (Supported Payment Methods)، ثم اتخذ القرارات التالية بحسب سياسة الشركة:
- فعّل السماح بحفظ طرق الدفع (Allow Saving Payment Methods) إذا أردت السماح للعملاء بحفظ طرق دفعهم كرموز دفع.
- فعّل التحصيل اليدوي للمبلغ (Capture Amount Manually) إذا كان يجب تحصيل المبلغ بعد اكتمال التسليم.
- فعّل تمكين رموز QR ‏(Enable QR Codes) عند استخدام التحويل البنكي والدفع برموز QR.
- فعّل السماح بالدفع السريع (Allow Express Checkout) إذا أردت إتاحة Google Pay وApple Pay للعملاء.
قيّد الاستخدام بالمبلغ والعملات عند الحاجة.
أدخل قيمة في الحد الأقصى للمبلغ (Maximum Amount) إذا كان المزود يجب أن يكون متاحاً للمدفوعات حتى حد معين فقط. اترك الحقل فارغاً إذا لم ترغب في تطبيق حد للمبلغ.

حدّد العملات (Currencies) التي يدعمها المزود. اترك الحقل فارغاً إذا كان المزود يجب أن يظل متاحاً دون تقييد بالعملات.
حدّد مرجع التواصل الذي سيظهر في أوامر البيع.
في التواصل (Communication)، اختر بناءً على مرجع المستند (Based on Document Reference) إذا أردت أن يرتبط التواصل بمرجع المستند، أو اختر بناءً على معرّف العميل (Based on Customer ID) إذا كان المرجع يجب أن يستند إلى معرّف العميل. يظهر هذا التواصل في أمر البيع ويُعطى للعميل عند اختياره طريقة الدفع.
عالج الرسائل المعلقة أو ثبّت المزود عند توفر الإجراء.
استخدم إعادة تحميل الرسائل المعلقة (Reload Pending Message) لإعادة تحميل الرسائل المعلقة المعروضة للمزود. وإذا ظهر إجراء تثبيت (Install) للمزود، استخدمه لتثبيت المزود، ثم راجع الحالة (State) وبيانات الاتصال قبل وضعه في وضع الاختبار (Test Mode) أو الحالة مُمكّن (Enabled).

نصيحة: اترك الحد الأقصى للمبلغ (Maximum Amount) والعملات (Currencies) فارغين فقط عندما يكون المزود مناسباً لجميع مبالغ الدفع والعملات دون تقييد.

أمثلة

تريد شركة تعمل مع Sherkety إتاحة الدفع الإلكتروني لطلبات البيع، مع اختبار التكامل قبل إتاحته فعلياً.

افتح مزود الدفع الخاص بالشركة من محاسبة > التهيئة > المدفوعات عبر الإنترنت > مزودي الدفع.
أدخل الاسم (Name) بالقيمة: Sherkety - الشركة الرئيسية.
اختر الشركة الرئيسية في الشركة (Company)، واختر شركتي (Sherkety) في الرمز (Code).
أدخل رابط Sherkety الأساسي في رابط API ‏(API URL)، وأدخل مفتاح المصادقة في مفتاح API ‏(API Key)، وأدخل قيمة التحقق في سرّ Webhook ‏(Webhook Secret).
اختر وضع الاختبار (Test Mode) في الحالة (State) لمعالجة دفعة تجريبية عبر واجهة الاختبار.
فعّل التحصيل اليدوي للمبلغ (Capture Amount Manually) لأن الشركة لا تريد تحصيل مبالغ البطاقات إلا بعد اكتمال التسليم.
اختر بناءً على مرجع المستند (Based on Document Reference) في التواصل (Communication)، ليظهر مرجع أمر البيع ضمن المعلومات المعطاة للعميل عند اختيار الدفع.
حدّد العملات المطلوبة في العملات (Currencies)، مثل الريال السعودي والدولار الأمريكي، واترك الحد الأقصى للمبلغ (Maximum Amount) فارغاً حتى لا يُفرض حد على قيمة الدفع.
بعد التحقق من إعدادات الاختبار، غيّر الحالة (State) من وضع الاختبار (Test Mode) إلى مُمكّن (Enabled) لإتاحة المزود.

نصائح

ملاحظة: لا تستخدم الحالة مُمكّن (Enabled) قبل إدخال رابط API ‏(API URL) ومفتاح API ‏(API Key) وسرّ Webhook ‏(Webhook Secret) عند استخدام تكامل Sherkety.

استخدم وضع الاختبار (Test Mode) عند إعداد مزود جديد، لأن هذا الوضع يعالج دفعات تجريبية عبر واجهة اختبار.
فعّل التحصيل اليدوي للمبلغ (Capture Amount Manually) عندما يعتمد قرار التحصيل على اكتمال التسليم.
راجع التواصل (Communication) بعناية، لأنه يمثل المعلومات التي تظهر في أمر البيع وتُعطى للعميل عند اختيار طريقة الدفع.
استخدم تمكين رموز QR ‏(Enable QR Codes) فقط عندما يكون الدفع بالتحويل البنكي جزءاً من طرق الدفع المعتمدة.

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

العَرَض	السبب المحتمل	الإجراء
لا يمكن استخدام مزود الدفع للمدفوعات الفعلية.	الحالة (State) مضبوطة على معطّل (Disabled) أو وضع الاختبار (Test Mode).	راجع اكتمال الإعدادات، ثم اختر مُمكّن (Enabled) في الحالة (State) عند الجاهزية.
لا ينجح التحقق من تكامل Sherkety.	بيانات الاتصال في رابط API ‏(API URL) أو مفتاح API ‏(API Key) أو سرّ Webhook ‏(Webhook Secret) غير مكتملة أو غير صحيحة.	راجع القيم المدخلة، وتأكد من استخدام رابط الأساس الصحيح ومفاتيح المصادقة والتحقق الصحيحة.
لا يظهر المزود لبعض مبالغ الدفع.	توجد قيمة مقيّدة في الحد الأقصى للمبلغ (Maximum Amount).	عدّل الحد الأقصى أو اتركه فارغاً لإتاحة المزود لأي مبلغ.
لا يتاح المزود لبعض العملات.	تم تحديد عملات في العملات (Currencies) لا تشمل عملة الدفع.	أضف العملة المطلوبة أو اترك الحقل فارغاً لإزالة تقييد العملات.

مزودو الدفع