Tariffs
Tariffs overview
API reference for managing tariffs and fee calculations
Overview
The Tariffs API provides functionality for managing:- Tariff definitions
- Fee range configurations
- Fee calculations
- Multi-currency pricing
- Channel-based fees
Core Concepts
Fee Calculation Methods
| Method | Description | Formula |
|---|---|---|
fixed | Fixed amount fee | fee = fixed_fee |
percentage | Percentage of amount | fee = amount * (percent_fee/100) |
greater | Greater of fixed/percent | fee = max(fixed_fee, percent_fee) |
lesser | Lesser of fixed/percent | fee = min(fixed_fee, percent_fee) |
sum | Sum of fixed and percent | fee = fixed_fee + percent_fee |
Fee Range Properties
| Field | Description |
|---|---|
range_start | Starting amount |
range_end | Ending amount |
fixed_fee | Fixed fee amount |
percent_fee | Percentage fee |
min_fee | Minimum fee |
max_fee | Maximum fee |
Velocity Controls
| Type | Description |
|---|---|
transaction_count | Limit by count |
amount | Limit by value |
Time Intervals
once: One-time limitdaily: Daily limitweekly: Weekly limitmonthly: Monthly limitannually: Annual limit
Validation Rules
Amount Rules
- Non-negative values
- Non-overlapping ranges
- Valid date ranges
Fee Rules
- Min fee ≤ Max fee
- Valid calculation method
- Active status check
Security Requirements
- Tariff updates need approval
- Range changes are audited
- Calculations are logged
- Version control applied
See individual endpoint documentation for detailed request/response formats and examples.