The Accounting Service serves as the backbone for managing the organization’s financial transactions, ensuring precision, transparency, and compliance with financial best practices. It is built on a robust accounting engine capable of double-entry bookkeeping, a method that provides accurate and reliable tracking of all assets and liabilities. This capability enables the organization to maintain a clear and comprehensive view of its financial health, fostering informed decision-making.

Merchant Account Aggregates:

The service creates and manages aggregates for each merchant account, handling multiple balance accounts such as:

• MerchantDebt
• ClientFunds
• PSPReceivable
• Escrow
• Caps
• Revenue

Transaction Management:

For every payment action, fee, or remittance, the service records transactions using specific transaction types:

• CHARGE
• FEE_ADDED
• REFUND
• CHARGEBACK
• TOPUP
• RESERVE_REMITTANCE
• RESERVE_CANCEL
• REMIT_RESERVED
• REMITTANCE
• REVERSE_REMITTANCE
• CAPS_REMITTANCE
• REVERSE_CAPS_REMITTANCE
• ADJUSTMENT_DEBIT
• ADJUSTMENT_CREDIT
• SCHEME_FEE

Refund Management:

During a successful authorization for a refund, the service reserves the corresponding amount. The reservation is held until the refund is confirmed, after which it is released. By managing these complex operations with a high degree of accuracy, the Accounting Service provides the tools necessary for businesses to monitor and control their financial operations while maintaining compliance with industry standards.

Entity Relationships

This section shows the relationships between all entities in the AccountingAndTreasury domain.

Entity Overview

The AccountingAndTreasury domain contains 7 key entities organized into two categories:

Core Entities

• MerchantAccount - Individual account records with IBAN, BIC, and currency details
• Platform - Payment platform configurations with account holder associations

Configuration Entities

• ChartOfAccounts - High-level account structure definitions
• AccountDefinition - Individual account types within charts (e.g., MerchantDebt, PSPReceivable)
• BookKeepingConfig - Configuration linking charts to transaction processing rules
• TransactionDefinition - Specific transaction types (CHARGE, REFUND, etc.)
• PostingRule - Double-entry bookkeeping rules linking transactions to accounts

Database Foreign Key Relationships

The entities are connected through the following database relationships:

Key Relationships Summary

• AccountDefinition → belongs to ChartOfAccounts (via CHART_OF_ACCOUNTS_FK)
• BookKeepingConfig → references ChartOfAccounts (via CHART_OF_ACCOUNTS_FK)
• TransactionDefinition → belongs to BookKeepingConfig (via BOOKKEEPING_CONFIG_FK)
• PostingRule → references AccountDefinition (via ACCOUNT_DEFINITION_FK)
• PostingRule → references TransactionDefinition (via TRANSACTION_DEFINITION_FK)
• Platform → associated with account holders (via account_holder_id)