التعبئة التلقائية

المسار في لوحة الإدارة: Finance › Payment channels › Fees & limits (/payments/fees)، البطاقة Wallet & top-up (Billing › Policy)، القسم Auto top-up (Stripe / PayPal). المسار في البوابة: Billing › Settings (/billing?settings=1).

الوظيفة

عندما ينخفض رصيد محفظة العميل بشكل كبير، يقوم NexCMP بخصم المبلغ من طريقة الدفع المحفوظة الخاصة به وشحن المحفظة، حتى لا تُعلق الخدمات قيد التشغيل بسبب نقص الأموال. تفحص مهمة في الخلفية جميع العملاء المفعلين كل 5 دقائق.

المتطلبات

العنصر	المتطلب
القناة	تكوين Stripe و/أو PayPal.
Saved method	يمتلك العميل بطاقة محفوظة أو حساب PayPal.
الموقع	الموقع الرئيسي، أو موقع الموزع الذي تُجمع قناة Stripe/PayPal الخاصة به بواسطة المنصة.
Global switch	Auto top-up enabled قيد التشغيل (افتراضياً قيد التشغيل).

How it works

بعد أول عملية شحن عبر Stripe أو PayPal للعميل، يحفظ الخادم طريقة الدفع ويفعل الشحن التلقائي في وضع By usage — فقط إذا لم يقم هذا العميل بضبط الشحن التلقائي بنفسه أبداً. لا يوجد مربع اختيار إضافي على شاشة الإيداع؛ يسجل الخادم الوقت وعنوان IP والطريقة كدليل. إذا أوقف العميل الشحن التلقائي لاحقاً، فلن يتم تشغيله تلقائياً مرة أخرى أبداً.

Mode	المشغل (عندما يكون الرصيد أقل من ...)	Amount charged
By usage (افتراضياً بعد الشحن الأول)	تكلفة الساعات الـ 24 القادمة للخدمات قيد التشغيل (الخوادم الافتراضية بالساعة مضافاً إليها التجديدات المدفوعة مقدماً المستحقة خلال 24 ساعة)، ولكن أبداً أقل من $5	تكلفة الـ 24 ساعة مقربة لأعلى إلى دولار صحيح، على الأقل الحد الأدنى للشحن، وعلى الأكثر الحد الأقصى للشحن والحد الأقصى اليومي
Fixed amount	عتبة العميل الخاصة (من $1 إلى $500)	مبلغ العميل الخاص (من الحد الأدنى للشحن إلى $1,000، وأكبر من العتبة)

مع عدم وجود خدمة قيد التشغيل في وضع By usage، لا يتم خصم أي شيء.

الرصيد مقارنة بالعتبة هو المال الحقيقي في المحفظة. تُحفظ رصيدات الخدمات من رموز العروض الترويجية بشكل منفصل ولا تُحتسب (انظر Promotions).

يتم التعامل مع الرسوم مثل الشحن العادي: مع تفعيل Customer pays top-up fee، يتم خصم المبلغ مضافاً إليه الرسوم من البطاقة وتحصل المحفظة على المبلغ كاملاً؛ ومع إيقافها، تحصل المحفظة على المبلغ مطروحاً منه الرسوم.

تكوين الحدود العامة

1. افتح Finance › Payment channels › Fees & limits (/payments/fees).

2. في Auto top-up (Stripe / PayPal)، قم بتعيين:

   الإعداد	القيمة الافتراضية	النطاق	المعنى
   Auto top-up enabled	On	on or off	إيقاف يوقف كل رسوم الخلفية فوراً.
   الحد الافتراضي للتعبئة التلقائية (بالدولار الأمريكي، الوضع الثابت الاحتياطي)	$5.00	$0 إلى $10,000	يُستخدم فقط كحد بدء في الوضع الثابت.
   الحد الأقصى للتعبئات التلقائية لكل 24 ساعة لكل عميل	3	1 to 50	يحسب المحاولات الناجحة والمعلقة.
   سقف مبلغ التعبئة التلقائية لكل 24 ساعة لكل عميل (بالدولار الأمريكي)	$500.00	$0 to $1,000,000	إجمالي الرسوم التلقائية في يوم متداول.

3. انقر فوق Save Wallet & top-up.

ما يراه العميل

1. في البوابة، يفتح العميل Billing وينقر فوق Settings.
2. تعرض لوحة التحكم الطريقة (الطرق) المحفوظة، ومفتاح التشغيل/الإيقاف، والوضع (By usage أو Fixed amount)، والاستخدام الحالي المقدر والرسوم التالية، وRecent automatic top-ups.
3. التبديل إلى Fixed amount يتيح لهم إدخال الحد والمبلغ. إيقاف المفتاح يؤدي إلى وقف الرسوم.

التحقق

1. باعتبارك عميلاً تجريبياً، قم بإجراء أول عملية تعبئة بطاقة اختبار (Stripe). افتح Billing › Settings: التعبئة التلقائية مفعلة.
2. قم بتشغيل جهاز افتراضي صغير ليكون هناك استخدام، واجعل الرصيد ينخفض دون الحد الأدنى (على سبيل المثال عبر Customers › customer › Credit / debit).
3. في غضون 5 دقائق تقريباً، يتم تنفيذ خصم. في بطاقة Overview › Payment الخاصة بالعميل، يوضح Auto top-up history المحاولة بحالة Done، ويتم إرسال إشعار Top-up received.

الحدود والملاحظات

• خصم واحد لكل انخفاض. بعد الخصم، تنتظر المهمة حتى يرتفع الرصيد مجدداً فوق الحد الأدنى أو ينتهي وقت الانتظار: 1 ساعة بعد العملية الناجحة، و24 ساعة بعد عملية معلقة، و30 دقيقة بعد خطأ في النظام.
• الحدود اليومية. عند الوصول إلى أي من الحدين اليوميين، لا يتم إجراء أي خصم وتتم كتابة سطر Daily limit reached (مرة واحدة على الأكثر كل 6 ساعات).
• حالات الفشل. تُعد البطاقة المرفوضة أو منتهية الصلاحية أو عدم كفاية الرصيد بمثابة فشل للبطاقة. تعيد المهمة المحاولة بعد 1 ساعة، ثم بعد 6 ساعات، ثم بعد 24 ساعة. بعد 3 حالات فشل متتالية للبطاقة يتم إيقاف auto top-up وإشعار العميل (Auto top-up failed). لا تُحتسب الدفعة التي تتطلب تأكيد العميل (على سبيل المثال 3-D Secure) كحالة فشل؛ بل يُطلب من العميل تأكيدها.
• لا توجد رسوم مزدوجة. يتم طلب كل خصم بشكل ذرات لكل انخفاض تحت الحد الأدنى ويستخدم مفتاح تماثل في بوابة الدفع.
• إزالة البطاقة تؤدي إلى إيقاف تشغيل التعبئة التلقائية.
• الموزعون. إذا استخدم الموزع قناة الدفع الخاصة به، فلا يمكن للعميل تفعيل التعبئة التلقائية (HTTP 403 feature_disabled).

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

العَرَض	السبب	الحل
لا يمكن للعميل تشغيلها: "شحن مرة واحدة ببطاقة أو PayPal"	لا توجد طريقة محفوظة	قم بإجراء عملية شحن واحدة للبطاقة أو PayPal أولاً.
خطأ no_card (422)	بوابة الدفع المختارة ليس لها طريقة محفوظة	اختر بوابة الدفع التي تحتوي على واحدة، أو احفظ طريقة.
خطأ invalid_argument في المبلغ	الوضع الثابت خارج النطاقات المسموحة	الحد الأدنى $1 إلى $500، المبلغ بين الحد الأدنى للشحن و$1,000، والمبلغ أكبر من الحد الأدنى.
لا يتم خصم أي شيء على الرغم من انخفاض الرصيد	المفتاح العام مغلق، لا توجد خدمة قيد التشغيل في وضع حسب الاستخدام، تم الوصول إلى الحد اليومي، أو الخصم السابق لا يزال قيد الانتظار	تحقق من المفتاح والسجل والحدود.
"N محاولات فاشلة متتالية — تتوقف التعبئة التلقائية بعد 3 محاولات"	البطاقة تستمر في الفشل	يستبدل العميل البطاقة بإيداع جديد.
الحالة Needs your confirmation	البنك يتطلب المصادقة 3-D Secure	يكمل العميل عملية الشحن العادية مرة واحدة.