Designing Chart of Accounts with Negative Balances

In Formance, accounts can be configured to carry negative balances, enabling accurate modeling of real-world financial obligations such as debts, credit lines, pending payments, or unsettled invoices.

Why Allow Negative Balances?

Allowing an account to go negative is a common way for representing liabilities or temporary obligations. For example, if a user owes funds to a platform or another user, their account balance can reflect that deficit until the obligation is cleared.

Example: Debt Settlement

When a user pays off a debt, the transaction simply reduces the negative balance on the lender's account. This brings the balance closer to zero (or above), effectively recording the settlement of the liability. This mirrors standard double-entry accounting, where one account's reduction offsets another's increase.

Best Practices: Avoid "world" as a Generic Source

To ensure clarity and traceability in your ledger:

• Avoid introducing funds from the generic world account.

• Use specific account addresses like users:123:payment:4567 to represent the exact source or context of the transaction.

This approach maintains a transparent audit trail and helps stakeholders understand the purpose of each transaction—e.g., associating a transfer with a specific payment or user action.