Shariah compliant lending on Apache Fineract
Most core banking systems can hold an Islamic product. Very few can account for one.
With Fiter, one product flag rewrites the general ledger, so your Islamic financing is not a conventional loan with a different name.
The problem
Phantom losses on the P&L. Late payment income your Shariah board rejects. Manual journal adjustments to clean up both. A conventional ledger misstates every Islamic product, and your finance team pays for it every close.
Interest is revenue. Forgiveness is loss.
Profit is fixed, known and earned over time.
The build
Everything is accounting behaviour. No new screens, no new buttons, no change to how a financing is originated or serviced.
01
An "Is Shariah compliant" checkbox on the financing product. One switch moves the product onto the Shariah accounting path.
02
Accrual (Upfront) booking, so the full Murabaha markup is raised at disbursement instead of accruing over the term.
03
A GL mapping that holds unearned markup as a liability rather than as income waiting to be earned.
04
Early settlement rebates are split automatically between unearned and earned profit, based on deferred and accrued balances, not on a manual judgement call.
05
Late payment charges redirected away from income into a charity fund liability, on accrual and on collection.
06
A reversal in three steps that unwinds deferred and earned profit before any principal is expensed.
Who it is for
Late payment income stays at zero. Charity Fund Payable shows a single auditable balance to review and sign off before every disbursement.
Unearned profit sits as a liability, write offs show the real credit loss, and month end closes without manual journal adjustments.
No new screens and no new buttons. Origination and servicing stay standard Apache Fineract; the Shariah logic lives in the posting rules.
At a glance
What a conventional core posts on a Murabaha contract, and what the Shariah flag changes.
| Operation | Stock Fineract posts | With the Shariah build |
|---|---|---|
| Disbursement | Principal to portfolio; interest recognised across the term | Principal plus total markup raised upfront; unearned profit held in a deferred liability |
| Early settlement rebate | Debits a waiver expense; the bank books a loss | Splits the rebate: deferred liability for unearned profit, income reversal for earned profit |
| Late charge applied | Credits Income from Penalties (Revenue) | Credits Charity Fund Payable (Liability); never touches revenue |
| Late charge collected | Cash clears the receivable into penalty income | Cash clears the receivable; the charity obligation stays on the balance sheet |
| Write off | Expenses the entire outstanding balance, unearned profit included | Reverses deferred and earned profit first, then expenses principal only |
GL mapping
Two mappings carry the whole model. Deferred profit as a liability prevents phantom losses. Late payment charges as a liability keep Gharamah out of the bank's revenue and available for charity.
| Fineract field | Islamic finance meaning | GL account type |
|---|---|---|
| Loan Portfolio | Principal cost | Asset |
| Interest Receivable | Total profit markup | Asset |
| Deferred Interest | Unearned future profit | Liability |
| Income from Interest | Realised, earned profit | Revenue |
| Income from Penalties | Charity fund (Gharamah) | Liability, never revenue |
| Losses Written Off | Actual capital loss | Expense |
Under the hood
Ibra
The standard Waive button is unchanged. The engine splits the rebate between profit already recognised and profit still deferred.
Unearned portion Dr Deferred Profit (Liability) Cr Profit Receivable (Asset) Earned portion Dr Profit Income (Revenue) Cr Profit Receivable (Asset)
The unearned portion is simply cancelled and never touches the P&L. Only profit already recognised as income is reversed.
Gharamah
Islamic finance prohibits profiting from a debtor’s delay, so late payment charges are routed to a charity liability before they can reach any income account.
1 Accrual Dr Late Charge Receivable (Asset) Cr Charity Fund Payable (Liability) 2 Collection Dr Cash / Bank (Asset) Cr Late Charge Receivable (Asset)
Funds sit in Charity Fund Payable until finance disburses them: one auditable balance for the board to sign off.
Write off
Profit is unwound before principal is expensed, so the loss reported is the loss the bank actually took.
1 Reverse unearned profit Dr Deferred Profit (Liability) Cr Profit Receivable (Asset) 2 Reverse earned profit Dr Profit Income (Revenue) Cr Profit Receivable (Asset) 3 Expense the principal Dr Losses Written Off (Expense) Cr Financing Receivable (Asset)
Unearned markup is cleared against the liability. Only principal and profit already recognised reach the P&L.
Quantified
In this example, a conventional core overstates credit losses by 16%. What does that do to your reported cost of risk?
$800
cleared against deferred profit: unearned markup that was never the bank’s money and never hits the P&L
$4,200
the real loss: principal plus profit already recognised as income
$0
phantom loss, manual month end adjustments, or restated write off reports
Illustrative figures from the product documentation. A conventional core would expense the full $5,000; $800 of it is unearned markup. Account names shown as configured for Islamic products.
Product setup
Fiter sets them up and validates them with your finance team.
Profit method
Flat
The markup is fixed and known at contract date, as the Murabaha sale requires.
Is Shariah compliant
Checked
Activates the specialised rebate, late payment and write off accounting rules.
Accounting rule
Accrual (Upfront)
Total profit is booked as a receivable at disbursement.
100+
Fineract projects implemented
40
Countries served
ASF
Apache Fineract PMC members on the team
No. Origination, servicing, rebates and write offs use the standard Fineract actions. Only the accounting behind them changes.
No. The engine splits every rebate automatically, using the deferred and accrued profit balances on the contract.
The build covers Murabaha. Talk to us to scope other structures such as Ijarah, Musharakah or Tawarruq for your market.
Disbursement is a deliberate step by the finance team. Funds stay in Charity Fund Payable until finance pays them to a charitable organisation, so the board reviews and signs off a single auditable balance.
Yes. The flag is set per product, so Shariah and conventional products share one Fineract instance with separate accounting paths.
No. Compliance is approved by your Shariah Supervisory Board. Fiter makes the Core Banking post the entries the contract requires and gives the board the evidence to review them.
No. Apache Fineract is open source under the Apache License 2.0. You pay for implementation, services and support, not for the software.
A 20 minute live demo in the journal entry screen: configure a Murabaha product, disburse, apply an early settlement rebate and a late payment charge, then write off, side by side with a conventional twin product.