# Overview Fee Management Platform (FMS), your innovative fee management system, simplifies the integration process for effortless fee handling. Designed for seamless connection to our other products, Fee Management Platform offers a streamlined approach to defining, charging, and reporting on various fees. It consists of the following key components: - Fees API - FMS core API responsible for collecting information on chargeable events, calculating fee amounts, and storing them in the database, with the optional capability to charge customers for specific transactions or actions. - Admin Panel - Administration Panel provides the user interface for defining and managing pricings in the FMS product. - Antaca API - Verestro's API responsible for charging customer balances and cards within the FMS product. When an FMS user configures pricing that involves instant charging, this API is called to provide the charging action. ### Architecture #### C4 Context diagram [![C4 Context.png](https://developer.verestro.com/uploads/images/gallery/2024-04/scaled-1680-/c4-context.png)](https://developer.verestro.com/uploads/images/gallery/2024-04/c4-context.png) #### C4 Container diagram [![C4 Container.png](https://developer.verestro.com/uploads/images/gallery/2024-04/scaled-1680-/c4-container.png)](https://developer.verestro.com/uploads/images/gallery/2024-04/c4-container.png) ### Key product features #### Instant fee charging

Calculating the fee for a defined service and instantly deducting the funds from the balance or payment card of the end-user who initiated the transaction. **This feature is available only when end-users' balances/payment cards are stored on Antaca's side or are exetrnal, but integrated with Antaca balances.**

##### Fee money flow Fee is an internal transaction for a partner who wants to **debit** the **user's balance** as a fee. Our card & balances management system (Antaca) automatically **credits** the **company balance** with the funds that were debit the user's balance. [![Fees_Cashback_money_flow.png](https://developer.verestro.com/uploads/images/gallery/2024-08/scaled-1680-/h7ufees-cashback-money-flow.png)](https://developer.verestro.com/uploads/images/gallery/2024-08/h7ufees-cashback-money-flow.png) #### Invoice settlement

Charging defined fees for specific services without actually enforcing payment. A report can be generated from the calculated fees, and then an invoice can be issued.

### Transactions (events) subject to fees
**Events we can charge for:** (instantly charge end-user’s balance/card stored in Antaca)
- Card issued (Issuer – Quicko) - Virtual card - Physical card - Card maintenance monthly (Issuer - Quicko) - Virtual card maintenance - Physical card maintenance - Cleared / authorized transaction - ATM (domestic/intra/inter) - IBAN events - Incoming transaction - Outgoing transaction - IBAN created
Events we can collect fee for (without debiting balance)
**Events we can collect fee for:** (report generating without balance charging)
- Antaca card created (Issuer – Quicko) - Virtual card - Physical card - Cleared / authorized transaction - POS (domestic/intra/inter) - eCommerce (domestic/intra/inter) - ATM (domestic/intra/inter) - ApplePay debit transaction (on-site) - ApplePay debit transaction (remote) - IBAN events - Incoming transaction - IBAN created - Transaction on technical balance - Currency exchange (FX) - Card maintenance (weekly, monthly) - Tokens maintenance (weekly, monthly)
It is possible to setup various fees charged to users for card issuing and account management activities. Fees can be setup through administration panel by product team or by customer themselves (it strongly depends on the particular customer). Fees can be managed in two ways: 1. Partner can setup own fee management system and charge users completely outside of Verestro system. 2. Partner can use Verestro fee management module.

There is implementation on-going to have conditional fees like - "I*f users do 1000 EUR transaction monthly, we do not charge monthly fee*".

### Fee settlement types Fee Management System (FMS) offers various settlement types. Each configured fee in the FMS has its own settlement type, offering flexibility to meet specific needs. ##### Instant settlement We charge the fee instantly, right after the occurrence of the event (transaction), utilizing the Antaca API. FMS can charge either customer's card or balance (the ones managed by Antaca API). ##### Invoice settlement We do not charge the fee, we only calculate it and it is stored in our database. FMS can generate a summary report (weekly or monthly) for fees of this type. ### Fee calculation types Fee Management System (FMS) provides diverse fee calculation methods, ensuring adaptability to distinct requirements. Each configured fee in the FMS is associated with a specific calculation type, allowing for tailored and precise fee management. ##### Fixed price We calculate the fee as a fixed price, defined as a specific amount with a designated currency.

Example: We can calculate 0,5 EUR for any issued card.

##### Percentage We calculate the fee as a percentage, defined as a specific rate of the transaction amount. The fee can then be stored either in the transaction's currency, or we can predefine a settlement currency for this type of fee.

Example: We can calculate 0,5% for ATM withdrawal, charged in transaction currency.

##### Mix We can combine the two aforementioned types (fixed, percentage) to form a single fee. The fee will be stored in predefined settlement currency.

Example: We can calculate 0,2 EUR + 0,5% for ATM withdrawal, charged in predefined settlement currency e.g. EUR.

### Service types Another important aspect of the system is that we can distinguish whether the fee is defined for individual units or cumulative. In simple terms, if a user intends to charge a fee for each unit, it is labeled as a Unit service. On the other hand, if they prefer to apply tiered or volume pricing for a set number of transactions (events), we refer to it as a Cumulative service. When defining a fee, the user needs to specify whether it will be a fee for a unit service or a cumulative service. ##### Unit service The FMS allows to define the fee for unit services when the price should be independent of the quantity of services used by the customer. This means that for any transaction (event) that occurs, we calculate a predefined price.Example: We can calculate 0,5 EUR for any issued card.
**Fee calculation time**instantly
**Available price calculation models**fixed, percentage, fixed + percentage
**Settlement types**instant (debit balance/card), invoice (store settlement in database)
**Additional features**- free tier per actor per period (e.g. first 2 issued cards (lifetime period) per cardholder are free) - filtering events by any event field (e.g. define fee only for domestic transactions, charge only for card isued with EUR currency etc.)
**Examples**- Card issuance fee – 0.5 EUR per issued card - ATM withdrawal fee – 2% of transaction amount
##### Cumulative service The FMS allows to define the fee for a cumulative service when the price depends on the quantity of services used by the customer. This means that we calculate a total price after we receive a summary event, which provides information about the quantity of transactions (events).
**Fee calculation time**at the end of the billing period (weekly, monthly)
**Available price calculation models**tiered pricing, volume pricing
**Settlement types**invoice (store settlement in database)
**Additional features**- Free tier when define first tier from 1 001 event (first 1000 events won’t be charged)
**Examples**- Card maintenance fee: 0.2 EUR up to 10 000 cards, 0.18 EUR up to 20 000 cards - Token maintenance fee: 0.02 EUR up to 100 000 tokens, 0.018 EUR up to 500 000 tokens
In simple terms, if FMS user wants to apply tiered or volume pricing for a set number of transactions (events), they should opt for the Cumulative service.

Example and comparison of Tiered vs Volume pricing is in table below.

**Volume pricing****Tiered pricing**
01-20 = $10 per event 21-30 = $8.5 per event 31-40 = $7 per event 41+ = $5.5 per event01-20 = $10 per event 21-30 = $8.5 per event 31-40 = $7 per event 41+ = $5.5 per event
**Cost breakdown:** You have sold 60 widgets. This is in the range of 41+; all widgets will cost $5.5 each. **Cost breakdown:** You have sold 60 widgets. First 20 widgets cost $10 each. Next 10 widgets cost $8.5 each. Next 10 widgets cost $7 each. Additional widgets cost $5.5 each.
**Total cost =60 x $5.5 = $330** **Total cost: (20 x $10) + (10 x $8.5) + (10 x $7) + (20x $5.5) = $465**
##### Recurring service The FMS allows to define the fee for recurring service when they want to establish a recurring fee with a fixed price. This means that at the beginning of every billing period, the fixed price will be saved in the settlements. This type of service is only applicable with invoice settlement.
**Fee calculation time**at the beginning of the billing period (daily, weekly, monthly, yearly)
**Available price calculation models**fixed price
**Settlement types**invoice (store settlement in database)
**Additional features**- Fee can be charged once in a period (daily, weekly, monthly, yearly)
**Examples**- Monthly project fee - Monthly maintenance fee per project

\* The functionality marked with '\*' is currently under construction. We appreciate your understanding as we work to enhance this feature.