Skip to main content

Fee Resolution and Reconciliation

This chapter outlines two critical support processes managed by the Core Payment Service: calculating broker fees for transactions and reconciling off-chain fiat payments with on-chain states.

Fee Resolution​

During the payment lifecycle (for example, when a bond purchase or settlement is executed), the DEUSS platform calculates and extracts applicable broker or platform fees before the final payout to the seller.

  1. Fee Schedules:

    • The Partner Service maintains the fee schedules for each Whitelabel Broker.
    • Fee classification is determined dynamically based on the transaction attributes (e.g., deal type, transaction amount, and broker tier).

  2. Fee Application:

    • When the Core Payment Service prepares a fiat transfer command for the PSP, it synchronously queries the Partner Service to resolve the correct fee.
    • The total fiat amount collected from the buyer is split: the principal (minus fees) is routed to the seller's IBAN, while the extracted fee is routed to the Broker's or Platform's operational account.

Blockchain Reconciliation​

Because fiat transfers (off-chain) and token transfers (on-chain) occur asynchronously across different ledgers, the platform employs a strict reconciliation engine to ensure data integrity.

  1. State Validation:

    • All fiat payments are validated against the on-chain MarketDeal state via the Blockchain Indexer.
    • Before commanding the smart contract to execute settleDeal, the system ensures the off-chain payment state is exactly PAID.
    • After the smart contract emits a success event, the system verifies that the on-chain token balances match the expected post-trade state.

  2. Mismatch Handling:

    • If the Indexer reports a state that contradicts the off-chain payment ledger (e.g., the buyer's fiat was returned but the on-chain deal was marked as settled), a State Mismatch error is recorded.
    • Such errors immediately halt further automated processing for the affected transaction and flag the payment for manual intervention by the Broker Admin or Platform Operator.

Sequence Diagram​