بوابات الدفع الخاصة بالشركة لشحن رصيد تجارها

الغرض#

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

من يستطيع استخدامها#

• إعداد البوابات: أدمن الشركة فقط. يظهر بند «بوابات الدفع لتجارك» في القائمة لهذا النوع من الحسابات وحده، ويحصل بقية موظفي الشركة (مسؤولو الفروع وموظفو الفروع) على صفحة 403.
• الدفع: التجار التابعون لشركة توصيل. أما التاجر المستقل، أو التاجر الذي يملك شركة توصيل داخلية، فيستخدم بوابات المنصة؛ وإذا حاول مثل هذا الحساب استخدام خدمة شحن رصيد تجار الشركات فيحصل على 403 «هالخدمة لتجار الشركات.».
• لا يلزم علم (flag) في الباقة ولا مفتاح صلاحية.

ما المتاح فعلاً#

توجد ثلاث بوابات فقط: Stripe (بطاقة) وشام كاش وPaymera. تُنشئها الصفحة عند فتحها أول مرة وكل منها «متوقفة» وفي الوضع «تجريبي»، فلا تُقبل أي دفعة حتى تحفظ البيانات وتفعّل خانة التفعيل. ويُحفظ اسم كل بوابة لحظة إنشائها، فيظهر بلغة الواجهة التي فُتحت بها الصفحة أول مرة (مثل «Stripe (بطاقة)» و«شام كاش» إن كانت العربية). وتُستخدم لغرض واحد فقط هو شحن رصيد تجارك: فلا تُعرض أبداً لدفع الباقات أو لشحنات الأفراد (الشحن بلا حساب)، ولا تُعرض بوابات المنصة على تجارك.

أما بوابات PayPal وSkrill وSSLCommerz وAamarpay وbKash وRazorpay وPaystack وPaymob القديمة فمغلقة، وقائمة «Payment Gateway» القديمة للحسابات البنكية وحسابات الجوال ليست جزءاً من هذه الميزة، وبندها مخفي في القائمة.

إعداد بوابة#

1. افتح الصفحة

   اختر «بوابات الدفع لتجارك» من القائمة الجانبية. لكل بوابة بطاقة، وتحتها جدول «آخر عمليات الشحن الإلكتروني».

2. أدخل بيانات الاعتماد

   املأ حقول بيانات الاعتماد. وهي خانات كلمة مرور وتُخزَّن مشفّرة. تعني شارة «محفوظ» أن القيمة مخزّنة؛ وترك الخانة فارغة («فاضي = منخلي المحفوظ») يُبقيها كما هي، ولا يستطيع النموذج مسح قيمة محفوظة.

3. اختر الوضع والعملة

   اختر «الوضع»: تجريبي أو حقيقي. وفي Paymera، إذا تركت «Base URL» فارغاً فالوضع هو الذي يحدد العنوان المستخدم: عنوان Paymera التجريبي في «تجريبي» (وهو الوضع الافتراضي للبوابة الجديدة)، وعنوان الإنتاج في «حقيقي»؛ فاختر «حقيقي» أو أدخل العنوان الفعلي قبل قبول دفعات حقيقية. وفي شام كاش اختر أيضاً «عملة الدفع» (دولار أو ليرة سورية). وفي شام كاش وPaymera أدخل «سعر الدولار بالليرة (إذا الدفع بالسوري)»، وهو سعرك الخاص بهذه البوابة.

4. فعّل البوابة واحفظ

   فعّل الخانة «مفعّلة لتجاري» واضغط «حفظ». تظهر رسالة «انحفظت ...» مع اسم البوابة. وإذا فعّلت الخانة وحقل مطلوب فارغ فلا يُحفظ شيء، وتعرض الصفحة «كمّل بيانات ... قبل التفعيل:» يليها أسماء الحقول الناقصة بصيغتها التقنية (مثل secret_key أو agent_key أو terminal_id) مفصولة بفاصلة عربية.

النتيجة المتوقعة. يرى تجار شركتك البوابة الآن في صفحة محفظتهم.

كيف يدفع التاجر#

1. في صفحة «محفظتي عند ...» يعرض مربع «شحن الرصيد» خياراً لكل بوابة مفعّلة. وإذا لم تُفعَّل أي بوابة فلا يظهر نموذج الدفع الإلكتروني.
2. يكتب التاجر المبلغ بعملة العرض لديه (من 0.01 إلى 1,000,000)، ويختار بوابة ويضغط «ادفع واشحن» (زر الدفع الذي يشحن الرصيد). والطلبات محدودة بعشرة في الدقيقة.
3. تحوّل المنصة المبلغ إلى دولار بسعر المنصة ثم إلى عملة البوابة: Stripe دائماً بالدولار، وشام كاش بالدولار ما لم تختر الليرة السورية، وPaymera دائماً بالليرة السورية. وتحتاج البوابة التي تحصّل بالليرة إلى سعرك؛ فإذا كان فارغاً أو صفراً لا تبدأ العملية ويرى التاجر الرسالة «سعر صرف الدولار بالسوري غير مضبوط لبوابة ...».
4. يُحوَّل التاجر إلى صفحة البوابة، ثم يعود إلى صفحة «تأكيد الدفع» التي تحدّث نفسها وهي تعرض «جاري تأكيد الدفع...». وتنتهي بـ«تم الدفع بنجاح» (مثلاً «أُضيف 25.00 $ إلى رصيدك.»، وهو المبلغ المضاف بالدولار الأمريكي) أو بـ«لم يكتمل الدفع» مع زر «المحاولة مرة أخرى».
5. لا تضيف المنصة المبلغ بالدولار إلى «رصيد الشحن» الخاص بالتاجر لدى شركتك إلا بعد أن تؤكد البوابة نفسها الدفع، وليس بمجرد عودة المتصفح، ومرة واحدة فقط. ويظهر القيد في حركات التاجر باسم «شحن إلكتروني».
6. وكاحتياط، تعيد المنصة تلقائياً كل 10 دقائق سؤال البوابة عن الدفعات التي بقيت معلّقة بعد 12 دقيقة، وتعدّ الدفعة منتهية بعد فحص أخير إذا مضى عليها أكثر من يوم.

وما يغطيه الرصيد يتبع إعداد التاجر «كيف بيدفع أجرة التوصيل» الذي تغيّره الشركة من صفحة «تجار الشركة ومحافظهم»: مع «من رصيده مسبقاً» تُخصم أجرة كل طرد من الرصيد عند إنشائه، ومع «من التحصيل» تُخصم من المبلغ المحصَّل نقداً.

متابعة الدفعات#

يعرض جدول «آخر عمليات الشحن الإلكتروني» آخر 30 محاولة لشركتك: التاريخ والتاجر والبوابة والمبلغ (بعملة البوابة) والرصيد المضاف والحالة (تم أو فشل أو انتهت أو بانتظار). وتجد أرصدة كل تاجر وحركاته في «تجار الشركة ومحافظهم».

أخطاء شائعة#

• عدم ضبط سعر الدولار لدفعة بالليرة. لا يشترط الحفظ إدخال السعر، فقد تُفعَّل Paymera، أو شام كاش المضبوطة على الليرة، ثم تفشل مع كل تاجر برسالة السعر أعلاه.
• ترك Paymera على «تجريبي» دون Base URL. يتجه التجار حينها إلى عنوان Paymera التجريبي؛ اختر «حقيقي» أو أدخل العنوان الفعلي قبل قبول دفعات حقيقية.
• استخدام «تجريبي» و«حقيقي» للتبديل في Stripe. لا أثر لهذا الإعداد في Stripe؛ فالمفتاح السري هو الذي يحدد.
• توقع قبول الدفع المتأخر. بعد أن تنتهي المحاولة لا يستطيع أن يضيفها إلا إشعار من شام كاش؛ أما محاولات Stripe وPaymera المنتهية فلا تُفحص مجدداً.

الحدود والصلاحيات#

• لأدمن الشركة فقط؛ ولا يستخدم التجار البوابات إلا من صفحة محفظتهم.
• للشحن فقط: لا دفع باقات ولا دفع شحنات الأفراد ولا استخدام لبوابات المنصة.
• يستطيع التجار أيضاً إرسال طلب شحن يدوي من صفحة المحفظة نفسها؛ ولا يتناوله هذا الدليل.