Blog
Implementation notes.
What we learn configuring Fineract in production, written for the person who has to make the technical call.
- November 10, 2026
Taxes and withholding in Fineract: where they live and what happens when a rate changes
Fineract separates the tax component from the group that bundles it, and keeps rate history. Why that separation matters, where it applies, and what it does not cover.
- November 3, 2026
IFRS 9 provisioning on Fineract: what the core computes and what you have to build
Fineract ships aging-bucket provisioning: day ranges, a percentage and GL accounts. That is incurred loss, not expected loss. What it covers, what it does not, and how to complete it without forking the core.
- October 27, 2026
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.
- October 20, 2026
The chart of accounts in Fineract: what to create before configuring the first product
A cash-based loan product requires 19 GL account mappings; on accrual, 25. Which ones they are, which ones always get forgotten, and why the order matters.
- October 13, 2026
Migrating a live portfolio to Fineract: the decision made before the first load
A migration is not decided by the loading tool but by two earlier questions: what gets migrated and where you cut. Getting either wrong surfaces the day accounting cannot reconcile the opening balance.
- October 6, 2026
Funds in Fineract: the three decisions that decide whether the model survives an audit
NAV mechanics are the easy part. What separates an operable fund from an expensive prototype are three design decisions — where value comes from, where the investor position lives, and whether history can be rewritten — that almost always get deferred.
- October 1, 2026
externalId: the field that decides whether your integration can retry
A timeout makes the originating system resend the request and the same loan gets disbursed twice. Fineract ships the mechanism to prevent it, but it only works if you pick the right value.
- September 29, 2026
NAV per unit in Fineract: how an investor comes in and out without diluting anyone
Fineract ships no investment fund product, but NAV-per-unit mechanics sit on top of savings accounts. How it works, with the worked example you should verify before writing any code.
- September 27, 2026
Fineract without a fork: five patterns to extend it and keep upgrading
How to add custom logic, integrations and reporting to Apache Fineract without modifying the core, so that every new Apache release is a version bump and not a migration project.
- September 20, 2026
OIDC in Fineract: stop managing passwords in the core
How to delegate Apache Fineract authentication to an identity provider (Keycloak, Entra ID, Google) with OpenID Connect, what changes in the API and what does not change in permissions.
- September 13, 2026
Term loans in Fineract: the seven decisions that define the product
What each key parameter of a term loan product means in Apache Fineract, how it changes the installment and the journal entry, and which combinations produce results nobody can explain later.
- September 6, 2026
Working capital in Fineract: three ways to model a revolving line
Fineract has no out-of-the-box 'revolving line' product. We compare the three ways to build one (multiple disbursements, savings overdraft, and a master limit with child loans) and when each one fits.