Tariffs overview - Corebanq

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 limit
daily: Daily limit
weekly: Weekly limit
monthly: Monthly limit
annually: 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.