پرش به مطلب اصلی

کارمزدها

این صفحه کارمزدهای موجود در پیش‌فاکتور پرداخت را توضیح می‌دهد؛ یعنی آنچه پرداخت‌کننده علاوه بر مبلغ فروشنده می‌فرستد. این جایگزین تعرفه پلتفرم میزبانی‌شده نیست (۰٫۵٪ هر تراکنش در OrcaRail میزبانی‌شده پس از ۱٬۰۰۰ تراکنش رایگان؛ نرم‌افزار نصب روی سرور خودتان رایگان است).

OrcaRail می‌تواند تا سه نوع کارمزد روی یک پرداخت اعمال کند: کارمزد پشتیبانی، کمیسیون و کارمزد پل. همه بر حسب توکن پرداخت‌کننده بیان می‌شوند و در مبلغ کل که پرداخت‌کننده باید بفرستد لحاظ می‌شوند. پاسخ‌های پیش‌فاکتور (و payment intent) این مبالغ و پرچم‌ها را نشان می‌دهند.

فرمول مبلغ کل​

مبلغی که پرداخت‌کننده باید بفرستد:

totalAmount = originalAmountInPayerToken + bridgeFeeInPayerToken + supportAmount + commissionAmount
  • originalAmountInPayerToken — مبلغ درخواستی پس از تبدیل به توکن پرداخت‌کننده (پیش از هر کارمزد).
  • bridgeFeeInPayerToken — کارمزد پل/swap وقتی توکن یا شبکه پرداخت‌کننده با توکن/شبکه دریافتی فرق دارد (از Relay). اگر پل لازم نباشد null است.
  • supportAmount — کارمزد پشتیبانی اختیاری بر حسب توکن پرداخت‌کننده (ادامه را ببینید).
  • commissionAmount — کمیسیون اختیاری بر حسب توکن پرداخت‌کننده (ادامه را ببینید).

پاسخ‌های دریافت پیش‌فاکتور و پیش‌فاکتور payment intent این فیلدها را مطابق تعریف API (مثلاً QuoteResponseDto) برمی‌گردانند.

کارمزد پشتیبانی​

  • چیست: درصدی اختیاری از مبلغ اصلی (مبلغی که فروشنده دریافت می‌کند).
  • پیش‌فرض: از متغیر محیطی PAYMENTS_DEFAULT_SUPPORT_PERCENT. اگر تنظیم نشده باشد پیش‌فرض API 0.5 (۰٫۵٪) است.
  • جایگزینی: می‌توانید درصد پشتیبانی را برای هر پیش‌فاکتور یا تراکنش با پارامتر supportPercent تغییر دهید (مثلاً در دریافت پیش‌فاکتور یا هنگام ساخت/ویرایش تراکنش).
  • کف حداقلی: وقتی درصد پشتیبانی بیشتر از ۰ باشد، مبلغ پشتیبانی محاسبه‌شده دست‌کم به حداقل شبکه آن زنجیره می‌رسد (برای جلوگیری از خرده‌ها). وقتی این کف اعمال شود، پیش‌فاکتور supportMinimumApplied: true دارد.
  • مقصد: کیف پول پشتیبانی OrcaRail (قابل تنظیم در سمت سرور).

کارمزد پشتیبانی (پاسخ پیش‌فاکتور)​

فیلدتوضیح
supportPercentدرصد کارمزد پشتیبانی اعمال‌شده (string).
supportAmountمبلغ پشتیبانی بر حسب توکن پرداخت‌کننده (string).
supportMinimumAppliedوقتی مبلغ پشتیبانی به حداقل شبکه رسانده شده باشد true است.

کمیسیون​

  • چیست: درصدی اختیاری از مبلغ اصلی که برای هر کلید API (commissionPercent) تنظیم می‌شود. فقط وقتی اعمال می‌شود که لینک پرداخت یا payment intent با آن کلید API ساخته شود.
  • پیکربندی: هنگام ساخت یا ویرایش کلید API تنظیم می‌شود (در داشبورد یا با API کلیدهای API). اگر تنظیم نشود، کمیسیون ۰ است.
  • قاعده ۰٫۰۱ دلار: اگر مبلغ کمیسیون کمتر از ۰٫۰۱ دلار باشد، API کمیسیون را ۰ می‌کند (کمیسیونی دریافت نمی‌شود).
  • کف حداقلی: مانند پشتیبانی: وقتی درصد کمیسیون بیشتر از ۰ باشد، مبلغ کمیسیون دست‌کم به حداقل شبکه می‌رسد. وقتی این کف اعمال شود، پیش‌فاکتور commissionMinimumApplied: true دارد.
  • مقصد: آدرس برداشت مالک کلید API برای زنجیره مربوط (هنگام پردازش برداشت استفاده می‌شود).

کمیسیون (پاسخ پیش‌فاکتور)​

فیلدتوضیح
commissionPercentدرصد کمیسیون (از کلید API) که روی مبلغ اصلی اعمال شده (string).
commissionAmountمبلغ کمیسیون بر حسب توکن پرداخت‌کننده (string).
commissionMinimumAppliedوقتی مبلغ کمیسیون به حداقل شبکه رسانده شده باشد true است.

کارمزد پل​

  • چه زمانی اعمال می‌شود: وقتی توکن یا شبکه پرداخت‌کننده با توکن یا شبکه دریافتی فرق دارد، پل یا swap لازم است. کارمزد پل هزینه این عملیات است.
  • منبع: کارمزد از Relay گرفته و در پیش‌فاکتور لحاظ می‌شود.
  • در مبلغ کل: کارمزد پل (بر حسب توکن پرداخت‌کننده) در totalAmount لحاظ می‌شود تا پرداخت‌کننده به اندازه کافی برای پوشش پل بفرستد و مبلغ درخواستی همچنان به فروشنده برسد.

کارمزد پل (پاسخ پیش‌فاکتور)​

فیلدتوضیح
bridgeFeeکارمزد پل/swap در صورت وجود (بر حسب توکن پرداخت‌کننده)؛ بدون پل null.
bridgeFeeUsdکارمزد پل به دلار؛ بدون پل null.
bridgeFeeInPayerTokenکارمزد پل بر حسب توکن پرداخت‌کننده؛ بدون پل null.
requiresBridgeوقتی پل/swap لازم باشد true است.

همچنین ببینید​