الحدود الدنيا للدفع

تفرض OrcaRail حدودًا دنيا لمبالغ التحويل لكل شبكة على المدفوعات. تُستخدم هذه الحدود للتحقق من مبلغ الدفع وكأرضية لمبالغ رسوم الدعم والعمولة، حتى لا تُنشئ الرسوم الصغيرة جدًا فتاتًا (dust) على السلسلة.

متغيرات البيئة

تُضبط الحدود الدنيا لكل نوع شبكة عبر متغيرات البيئة. القيم بأصغر وحدة في الشبكة (lamports وwei وsats).

المتغير	الشبكة	الافتراضي	الوصف
PAYMENTS_MIN_AMOUNT_SOLANA_LAMPORTS	سولانا	890880	الحد الأدنى للتحويل بالـ lamports.
PAYMENTS_MIN_AMOUNT_EVM_WEI	EVM (Ethereum وPolygon وBase وغيرها)	(لا يوجد)	اختياري. عند ضبطه يكون الحد الأدنى بالـ wei.
PAYMENTS_MIN_AMOUNT_BITCOIN_SATS	بيتكوين	546	الحد الأدنى بالساتوشي (حد الفتات).

عندما لا يُضبط متغير لنوع شبكة ما، لا تفرض API حدًا أدنى لتلك الشبكة (باستثناء سولانا وبيتكوين اللتين تستخدمان الافتراضيات أعلاه). لا قيمة افتراضية لـ EVM؛ إن أردت حدًا أدنى على EVM فاضبط PAYMENTS_MIN_AMOUNT_EVM_WEI.

كيف يُستخدم الحد الأدنى

1. التحقق من مبلغ الدفع

عند إنشاء رابط دفع أو التحقق من مبلغ الدافع، تتحقق API من أن مبلغ الدفع ليس أقل من الحد الأدنى لشبكة الدافع.

• في الرموز الأصلية (مثل SOL وETH وBTC)، يُقارن الحد الأدنى مباشرةً بأصغر وحدة للرمز (lamports وwei وsats).
• في الرموز غير الأصلية (مثل USDC على Ethereum)، يُعرَّف الحد الأدنى بالوحدة الأصلية للشبكة؛ وتحوّله API إلى وحدات رمز الدافع باستخدام سعر الدولار ليُطبَّق الحد الأدنى الاقتصادي نفسه. إذا تعذّر حساب الحد الأدنى المحوّل (مثل غياب السعر)، فقد يُتخطّى التحقق لذلك الرمز.

إذا كان المبلغ أقل من الحد الأدنى، تعيد API خطأ (مثل Amount is below the minimum for this network).

2. أرضية رسوم الدعم والعمولة

عندما تكون نسبة الدعم أو نسبة العمولة أكبر من 0، تحسب API مبلغ الرسوم كنسبة من المبلغ الأصلي. ولتجنب الفتات (مخرجات صغيرة جدًا غير اقتصادية أو غير صالحة على السلسلة)، ترفع API كلًا من هذه المبالغ إلى الحد الأدنى للشبكة على سلسلة الدافع.

• supportMinimumApplied: عند رفع رسوم الدعم إلى الحد الأدنى للشبكة، يضبط عرض السعر supportMinimumApplied: true. وقد يكون مبلغ الدعم الفعلي أعلى من النسبة الدقيقة للمبلغ الأصلي.
• commissionMinimumApplied: عند رفع رسوم العمولة إلى الحد الأدنى للشبكة، يضبط عرض السعر commissionMinimumApplied: true. وقد يكون مبلغ العمولة الفعلي أعلى من النسبة الدقيقة.

يضمن ذلك أنك إذا تقاضيت نسبة صغيرة (مثل 0.1%)، فلن تصبح الرسوم جزءًا من السنت دون الحد الأدنى للسلسلة؛ بل تُرفع إلى الحد الأدنى ليكون المخرج صالحًا.

الملخص

الحالة	السلوك
مبلغ الدفع منخفض جدًا	يُرفض الطلب (خطأ تحقق).
رسوم الدعم > 0، والمبلغ المحسوب < الحد الأدنى	مبلغ الدعم = الحد الأدنى؛ supportMinimumApplied: true.
رسوم العمولة > 0، والمبلغ المحسوب < الحد الأدنى	مبلغ العمولة = الحد الأدنى؛ commissionMinimumApplied: true.

انظر أيضًا

• الرسوم — كيف يُحسب الدعم والعمولة ويُضمَّنان في عرض السعر.
• الحدود الدنيا للسحب — عتبة السحب التلقائي (منفصلة عن الحدود الدنيا للدفع).