# 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 [](https://developer.verestro.com/uploads/images/gallery/2024-04/c4-context.png) #### C4 Container diagram [](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. [](https://developer.verestro.com/uploads/images/gallery/2024-08/h7ufees-cashback-money-flow.png) #### Invoice settlementCharging 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:** (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) |
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 |
**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 |
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 event | 01-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** |
**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.