> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corebanq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 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

<Note>
  See individual endpoint documentation for detailed request/response formats and examples.
</Note>