03.09 FX, Currency Conversion, and Fees

Status: draft for discussion

1. Goal

The system must correctly calculate currency conversion, conversion fee, and processing fee.

2. Base Currency

Base currency for calculations is EUR.

Amounts in rules and limits are calculated through EUR.

Original amount and original currency are stored in the transaction.

3. Conversion Fee

Conversion fee applies on SUB MID / SUB MID AGGREGATOR level.

Conversion fee is paid by customer.

Fee is added on top of the amount.

4. Processing Fee

Processing fee applies on MASTER MID.

Processing fee is paid by merchant during settlement. It does not affect the transaction at processing time.

Fee can depend on monthly turnover thresholds.

Thresholds are calculated by calendar month and COMPLETED transactions.

UI shows threshold values in EUR.

5. Visibility

Merchant user sees only the financial details that the business allows them to see.

Provider financial configuration and internal financial settings are hidden without business access.

6. Transaction Financial Breakdown

Transaction details should show the financial values needed for investigation and reconciliation:

• original amount;
• original currency;
• amount in EUR;
• conversion rate;
• conversion date/time;
• conversion fee when applicable;
• processing fee when applicable and visible by access.

The product should keep enough financial context to explain how the transaction was processed.

Advanced reporting is not part of MVP, but transaction-level financial transparency is required.