← Back to blog

October 27, 2026 · 3 min read

Accrual or cash in Fineract: the accounting decision you cannot undo

Fineract offers four accounting rules per product. The difference is not configuration: changing it with a live portfolio is a migration, not an adjustment. What each one implies and how to choose.

Accounting · Accrual · Product design

When you create a product in Fineract there is a dropdown with four options that determines more than any other field on the screen: the accounting rule. NONE, CASH_BASED, ACCRUAL_PERIODIC or ACCRUAL_UPFRONT.

It takes ten seconds to pick and you live with it for years, because changing it once you have a portfolio is not reconfiguration: it is migration. Entries already generated keep the old logic and new ones get the new, and reconciling that overlap is manual work somebody will have to do.

What each one does

NONE generates no entries at all. It exists for testing and for institutions keeping accounting elsewhere. Choose it in production and the core stops being the accounting source of truth; reconciliation becomes a permanent process you own.

CASH_BASED generates the entry when money moves. Interest is recognised as income the day the client pays, not the day it accrues. Simple to understand, simple to reconcile, and it produces statements that do not reflect the period’s result.

ACCRUAL_PERIODIC recognises income as it accrues, through a daily process. It is what most regulators expect from a supervised institution.

ACCRUAL_UPFRONT recognises all income at disbursement. It has legitimate uses in some fee-driven products, but as a general rule for lending it distorts the first period’s result.

What accrual demands beyond the switch

It is not just a toggle. A cash-based loan product maps 19 GL accounts; on accrual, 25. The six extra are the bridge accounts where recognised-but-uncollected income lives: interest receivable, fees receivable, penalties receivable and the deferred income liability.

If your chart of accounts does not have them, it is not missing configuration: the institution was not really doing accrual, and that is a conversation with accounting before it is one with the system.

It also demands a daily process that never misses. Periodic accrual is computed during the day-end close; if the job does not run one day, that day does not accrue, and income shows up displaced. It is not a failure you notice immediately — you notice it at month close.

The criterion I would apply

The question is not which is better in the abstract, but what your regulator requires and what your team can operate.

If you are a supervised institution in Latin America, the answer is almost always periodic accrual, and there is little to deliberate: the income statement has to reflect the period.

If you are an early-stage fintech with no reporting obligation and a small team, cash basis gets you live sooner with fewer moving parts to watch. That is a defensible choice if you know it is temporary and you plan the change, not if you pick it for convenience and discover the problem when supervision arrives.

And if you are unsure, there is an honest middle path: CASH_BASED with the chart of accounts already designed for accrual. The six extra accounts sitting unused bother nobody, and on the day you switch, half the work is done.

What I would never do

Choose accrual without settling who watches that the daily process runs. An accrual that fails silently is worse than no accrual, because it produces statements that look right and are not.

And mix rules across products of the same nature. Fineract allows it — the rule is per product, not per institution — and that is useful when products genuinely differ. But two consumer loan products on different accounting rules produce an income statement nobody can explain.

Before you choose

Ask accounting three things, in this order. Whether the regulator requires accrual. Whether the chart of accounts has the bridge accounts. And who will check each morning that last night’s process ran.

If those three answers are not clear, you are not yet choosing between accrual and cash: you are choosing between configuring now and configuring properly.