الرسوم
تصف هذه الصفحة الرسوم المضمّنة في عرض سعر الدفع، أي ما يرسله الدافع فوق مبلغ التاجر. وهي لا تحل محل تسعير المنصة المستضافة (0.5% من كل معاملة في OrcaRail المستضافة بعد أول 1,000 معاملة مجانية؛ والبرمجيات المستضافة ذاتيًا مجانية).
يمكن أن تطبّق OrcaRail حتى ثلاثة أنواع من الرسوم على الدفعة: رسوم الدعم، ورسوم العمولة، ورسوم الجسر. تُعبَّر جميعها برمز الدافع وتُضمَّن في المبلغ الإجمالي الذي يجب على الدافع إرساله. وتعرض استجابات عرض السعر (والـ payment intent) هذه المبالغ والمؤشرات.
معادلة المبلغ الإجمالي
المبلغ الذي يجب على الدافع إرساله هو:
totalAmount = originalAmountInPayerToken + bridgeFeeInPayerToken + supportAmount + commissionAmount
- originalAmountInPayerToken — مبلغ الدفع المطلوب محوّلًا إلى رمز الدافع (قبل أي رسوم).
- bridgeFeeInPayerToken — رسوم الجسر/التبديل عندما يختلف رمز الدافع أو شبكته عن الرمز أو الشبكة المستحقة (من Relay). تكون
nullعندما لا يلزم جسر. - supportAmount — رسوم دعم اختيارية برمز الدافع (انظر أدناه).
- commissionAmount — عمولة اختيارية برمز الدافع (انظر أدناه).
تعيد استجابات الحصول على عرض سعر وعرض سعر الـ payment intent هذه الحقول كما هي معرّفة في API (مثل QuoteResponseDto).
رسوم الدعم
- ما هي: نسبة اختيارية من المبلغ الأصلي (المبلغ الذي يتلقاه التاجر).
- الافتراضي: من متغير البيئة
PAYMENTS_DEFAULT_SUPPORT_PERCENT. القيمة الافتراضية في API هي0.5(0.5%) إن لم يُضبط. - التجاوز: يمكنك تجاوز نسبة الدعم لكل عرض سعر أو معاملة عبر المعامل
supportPercent(مثلًا في الحصول على عرض سعر أو عند إنشاء معاملة/تحديثها). - الأرضية الدنيا: عندما تكون نسبة الدعم أكبر من 0، يُرفع مبلغ الدعم المحسوب إلى الحد الأدنى للشبكة لتلك السلسلة على الأقل (لتجنب الفتات). يتضمن عرض السعر
supportMinimumApplied: trueعند تطبيق هذه الأرضية. - الوجهة: محفظة الدعم في OrcaRail (قابلة للضبط من جهة الخادم).
رسوم الدعم (استجابة عرض السعر)
| الحقل | الوصف |
|---|---|
supportPercent | نسبة رسوم الدعم المطبقة فعليًا (string). |
supportAmount | مبلغ الدعم برمز الدافع (string). |
supportMinimumApplied | true عند رفع مبلغ الدعم إلى الحد الأدنى للشبكة. |
رسوم العمولة
- ما هي: نسبة اختيارية من المبلغ الأصلي تُضبط لكل مفتاح API (
commissionPercent). لا تُطبَّق إلا عند إنشاء رابط الدفع أو الـ payment intent بذلك المفتاح. - الإعداد: تُضبط عند إنشاء مفتاح API أو تحديثه (من لوحة التحكم أو عبر API مفاتيح API). إن لم تُضبط فالعمولة 0.
- قاعدة 0.01 دولار: إذا كان مبلغ العمولة بالدولار أقل من 0.01 دولار، تضبط API العمولة على 0 (لا تُحصَّل عمولة).
- الأرضية الدنيا: كما في الدعم: عندما تكون نسبة العمولة أكبر من 0، يُرفع مبلغ العمولة إلى الحد الأدنى للشبكة. يتضمن عرض السعر
commissionMinimumApplied: trueعند تطبيق هذه الأرضية. - الوجهة: عنوان سحب مالك مفتاح API للشبكة المعنية (يُستخدم عند معالجة السحوبات).
رسوم العمولة (استجابة عرض السعر)
| الحقل | الوصف |
|---|---|
commissionPercent | نسبة العمولة (من مفتاح API) المطبقة على المبلغ الأصلي (string). |
commissionAmount | مبلغ العمولة برمز الدافع (string). |
commissionMinimumApplied | true عند رفع مبلغ العمولة إلى الحد الأدنى للشبكة. |
رسوم الجسر
- متى تُطبَّق: عندما يختلف رمز الدافع أو شبكته عن الرمز أو الشبكة المستحقة، يلزم جسر أو تبديل. ورسوم الجسر هي تكلفة تلك العملية.
- المصدر: تُحصَّل الرسوم من Relay وتُضمَّن في عرض السعر.
- في الإجمالي: تُضمَّن رسوم الجسر (برمز الدافع) في
totalAmountليرسل الدافع ما يكفي لتغطية الجسر مع وصول المبلغ المطلوب كاملًا إلى التاجر.
رسوم الجسر (استجابة عرض السعر)
| الحقل | الوصف |
|---|---|
bridgeFee | رسوم الجسر/التبديل إن وُجدت (برمز الدافع)؛ null عند عدم وجود جسر. |
bridgeFeeUsd | رسوم الجسر بالدولار؛ null عند عدم وجود جسر. |
bridgeFeeInPayerToken | رسوم الجسر برمز الدافع؛ null عند عدم وجود جسر. |
requiresBridge | true عندما يلزم جسر/تبديل. |
انظر أيضًا
- الحدود الدنيا للدفع — كيف تؤثر الحدود الدنيا على مبالغ الدعم والعمولة.
- مرجع API المدفوعات — الحصول على عرض سعر ونقاط النهاية المرتبطة.
- مفاتيح API — اضبط
commissionPercentلكل مفتاح API.