Understanding Double-Entry Accounting

What is Double-Entry Accounting?

Double-entry accounting is a method where every financial transaction affects at least two accounts: one is debited, and another is credited. The total debits always equal total credits, keeping the accounting equation balanced.

Key principle: For every transaction, total debits = total credits. This ensures the books always balance and errors are easily detected.

The Accounting Equation

Assets = Liabilities + Equity

Every transaction in Agatabo maintains this fundamental balance:

Assets: What the organization owns (cash, loans receivable, fixed assets)
Liabilities: What the organization owes (member savings, payables)
Equity: The organization’s net worth (retained earnings, reserves)

Example:

Cash: 10,000,000 RWF (asset)
Member Savings: 8,000,000 RWF (liability)
Retained Earnings: 2,000,000 RWF (equity)

10,000,000 = 8,000,000 + 2,000,000 ✓ Balanced

Debits and Credits

Basic Rules

Account Type	Increase	Decrease	Normal Balance
Assets (Cash, Loans Receivable, Fixed Assets)	Debit	Credit	Debit
Liabilities (Member Savings, Payables)	Credit	Debit	Credit
Equity (Retained Earnings, Reserves)	Credit	Debit	Credit
Income (Interest Income, Fees)	Credit	Debit	Credit
Expenses (Operating Expenses, Salaries)	Debit	Credit	Debit

Memory aid: DEALER

Debits increase: Dividends (distributions), Expenses, Assets, Losses
Credits increase: Equity (except distributions), Accounts payable, Revenue (Income)

Transaction Examples (from Agatabo)

Example 1: Member Deposits Cash

Transaction: Member Alice deposits 100,000 RWF to her savings account Journal entry created:

Account	Type	Debit	Credit
Cash (organization:org123)	Asset	100,000
Member Savings (organizationUser:alice)	Liability		100,000

Effect:

Organization has more cash (asset increases)
Organization owes more to Alice (liability increases)
Accounting equation remains balanced

Explanation: The organization receives cash (debit to increase asset) but must return it on demand, so it’s a liability (credit to increase liability).

Example 2: Loan Disbursement

Transaction: Organization lends 500,000 RWF to member Bob Journal entry created:

Account	Type	Debit	Credit
Loan Receivable (loan:bob-loan-123)	Asset	500,000
Cash (organization:org123)	Asset		500,000

Effect:

Cash decreases (credit to decrease asset)
Loan Receivable increases (debit to increase asset)
Total assets unchanged (one asset traded for another)

Explanation: Cash is given to member, but organization gains a loan receivable (right to collect principal + interest in future).

Example 3: Loan Payment with Interest

Transaction: Member Bob repays 110,000 RWF (100,000 principal + 10,000 interest) Journal entry created:

Account	Type	Debit	Credit
Cash (organization:org123)	Asset	110,000
Loan Receivable (loan:bob-loan-123)	Asset		100,000
Interest Income (organization:org123)	Income		10,000

Effect:

Cash increases by 110,000 (debit to increase asset)
Loan Receivable decreases by 100,000 (credit to decrease asset)
Interest Income increases by 10,000 (credit to increase income)

Explanation: Organization receives cash, reduces the loan receivable, and earns interest income (revenue).

Example 4: Recording an Expense

Transaction: Pay 50,000 RWF rent for office space Journal entry created:

Account	Type	Debit	Credit
Operating Expense (organization:org123)	Expense	50,000
Cash (organization:org123)	Asset		50,000

Effect:

Cash decreases by 50,000 (credit to decrease asset)
Expense increases by 50,000 (debit to increase expense, reduces profit)

Explanation: Cash is paid out, and expense is recorded. Expenses reduce net income.

Example 5: Dividend Distribution

Transaction: Distribute 200,000 RWF dividends to members (50 members × 4,000 RWF each) Journal entry created:

Account	Type	Debit	Credit
Retained Earnings (organization:org123)	Equity	200,000
Member Savings (organizationUser:alice)	Liability		4,000
Member Savings (organizationUser:bob)	Liability		4,000
Member Savings (organizationUser:carol)	Liability		4,000
… (50 members total)	Liability		…

Effect:

Retained earnings decreases by 200,000 (debit to decrease equity)
Each member’s savings balance increases (credit to increase liability)
Total liabilities increase by 200,000

Explanation: Dividends distribute accumulated profits (equity) to member savings accounts (liability). Members can withdraw their dividends or leave them to compound.

Common misconception: Dividends in Agatabo credit SAVINGS accounts (liability), NOT a separate “Member Equity” account. Member savings are liabilities because the organization owes these funds to members on demand.

Example 6: Reserve Allocation

Transaction: Allocate 1,000,000 RWF from retained earnings to emergency fund reserve Journal entry created:

Account	Type	Debit	Credit
Reserve Allocation (reserve:emergency-fund)	Equity	1,000,000
Retained Earnings (organization:org123)	Equity		1,000,000

Effect:

Reserve balance increases by 1,000,000 (debit to increase equity)
Retained earnings decreases by 1,000,000 (credit to decrease equity)
Total equity unchanged (internal transfer within equity)

Explanation: Both are equity accounts. This is an internal reclassification of equity from general retained earnings to a designated reserve.

Example 7: Member Withdraws Savings

Transaction: Member Alice withdraws 50,000 RWF from her savings Journal entry created:

Account	Type	Debit	Credit
Member Savings (organizationUser:alice)	Liability	50,000
Cash (organization:org123)	Asset		50,000

Effect:

Alice’s savings balance decreases by 50,000 (debit to decrease liability)
Cash decreases by 50,000 (credit to decrease asset)
Both assets and liabilities decrease equally

Explanation: Organization pays cash to Alice, reducing its liability (what it owes her) and its cash (asset).

Scope Keys and Per-Entity Accounts

Agatabo uses scope keys to create separate accounts for different entities: Format: {entity_type}:{entity_id} Examples:

organizationUser:alice123 - Alice’s personal SAVINGS account
organizationUser:bob456 - Bob’s personal SAVINGS account
loan:loan-789 - Specific loan’s LOAN_RECEIVABLE account
reserve:emergency-fund - Emergency fund RESERVE_ALLOCATION account
organization:org123 - Organization-wide CASH account

Why this matters:

Each member has their own SAVINGS account (all are liabilities, but tracked separately)
Each loan has its own LOAN_RECEIVABLE account
Each reserve has its own RESERVE_ALLOCATION account
Enables per-member, per-loan, per-reserve accounting

Why Agatabo Uses Double-Entry

Benefits:Accuracy & Error Detection:

Errors are immediately apparent (debits must equal credits)
Unbalanced entries are rejected by the system
Self-checking mechanism prevents many common mistakes

Complete Transaction View:

See both sides of every transaction (what’s given and what’s received)
Understand impact on multiple accounts simultaneously
Clear audit trail for every financial event

Automated Financial Statements:

Balance Sheet generated from account balances
Income Statement from income and expense accounts
Cash Flow Statement from account changes

Compliance & Audit:

Required for formal financial reporting
Meets accounting standards (GAAP, IFRS)
Provides complete audit trail
Supports external audits and reviews

Business Insights:

Track exactly where money comes from and goes to
Understand financial health at a glance
Make informed decisions based on complete data
Monitor profitability, liquidity, and solvency

Journal Entries in Agatabo

Every transaction in Agatabo creates a journal entry with: Components:

Kind: Type of transaction (SAVINGS_DEPOSIT, LOAN_DISBURSEMENT, DIVIDEND_DISTRIBUTION, RESERVE_TOP_UP, EXPENSE_PAYMENT, etc.)
Transaction date: When transaction occurred
Status: POSTED (permanent, affects balances) or DRAFT (temporary, can be edited)
Lines: 2 or more lines showing debits and credits (must balance)
Metadata: Title, description, supporting documents
Idempotency key: Prevents duplicate entries

Example journal entry structure:

{
  "id": "je-123",
  "kind": "SAVINGS_DEPOSIT",
  "transactionDate": "2026-06-12",
  "status": "POSTED",
  "lines": [
    {
      "side": "DEBIT",
      "amount": 100000,
      "account": "Cash (organization:org123)"
    },
    {
      "side": "CREDIT",
      "amount": 100000,
      "account": "Savings (organizationUser:alice)"
    }
  ]
}

Learn about journal entries →

Common Questions

Q: Do I need to understand debits and credits to use Agatabo?

A: No! Agatabo creates journal entries automatically when you record deposits, loans, expenses, dividends, and reserves. Understanding double-entry helps with:

Troubleshooting discrepancies
Creating manual journal entries
Advanced accounting tasks
Financial statement interpretation

But it’s not required for daily operations like recording deposits or loan payments.

Q: What if debits don’t equal credits?

A: Agatabo won’t allow posting unbalanced entries:

All automatic entries are validated before creation
Manual journal entries are rejected if debits ≠ credits
System enforces balance requirement at all times

If you somehow encounter an unbalanced entry, it’s a system bug that should be reported.

Q: Why does my cash go up (debit) but member savings also go up (credit)?

A: Because they’re different account types:

Cash (asset) increases with debit
Member Savings (liability) increases with credit

Both can increase simultaneously because the transaction affects different parts of the accounting equation:

Assets (Cash ↑) = Liabilities (Savings ↑) + Equity

The equation remains balanced!

Q: What’s the difference between Income and Revenue?

A: In Agatabo (and many accounting systems):

Income: Preferred term for earned revenue (INTEREST_INCOME, FEE_INCOME, PENALTY_INCOME)
Revenue: General term for money earned

They mean the same thing. Agatabo uses “Income” in account names for consistency.

Q: Why are member savings a liability?

A: Because the organization owes these funds to members:

Members can withdraw their savings at any time
Organization has an obligation to return the funds on demand
This is a liability (money owed to others)

Even though members are “owners,” their savings accounts are liabilities, not equity. Dividends that members choose to leave in savings also increase this liability.

Q: How do reserves work in double-entry?

A: Reserves are equity accounts (designated retained earnings):

Both Retained Earnings and Reserve Allocations are equity
Allocating to reserves moves money from general equity to designated equity
Total equity doesn’t change (internal reclassification)
Both sides of the entry are equity accounts

Example:

DEBIT: Reserve Allocation (equity) +1,000,000
CREDIT: Retained Earnings (equity) -1,000,000

Visual Guide: Account Flow

ASSETS                    LIABILITIES
┌─────────────┐          ┌─────────────┐
│             │          │             │
│  Cash       │          │  Member     │
│  Loans      │          │  Savings    │
│  Fixed      │          │             │
│  Assets     │          │             │
│             │          │             │
└─────────────┘          └─────────────┘
      ↕                        ↕
  Debit ↑                  Credit ↑
 Credit ↓                   Debit ↓

EQUITY                    INCOME
┌─────────────┐          ┌─────────────┐
│             │          │             │
│  Retained   │          │  Interest   │
│  Earnings   │          │  Fees       │
│  Reserves   │          │  Penalties  │
│             │          │             │
│             │          │             │
└─────────────┘          └─────────────┘
      ↕                        ↕
 Credit ↑                  Credit ↑
  Debit ↓                   Debit ↓

EXPENSES
┌─────────────┐
│             │
│  Operating  │
│  Bad Debt   │
│  Bank       │
│  Charges    │
│             │
└─────────────┘
      ↕
  Debit ↑
 Credit ↓

Best Practices

For non-accountants:

Trust automatic journal entries (they’re correct)
Focus on business transactions, not accounting mechanics
Review financial reports (Balance Sheet, Income Statement) instead of raw journal entries
Ask an accountant if creating manual entries

For accountants:

Review journal entries regularly for accuracy
Verify trial balance balances monthly
Document all manual journal entries clearly
Use consistent account names and classifications
Train staff on basic double-entry concepts
Monitor for unusual transactions or patterns

Need Help?

Viewing Journal Entries

See transaction details and audit trail

General Ledger Overview

Complete accounting system overview

Balance Sheet

See accounting equation in action

Income Statement

View revenue and expenses

Manual Journal Entries

Create manual accounting entries

​What is Double-Entry Accounting?

​The Accounting Equation

​Debits and Credits

​Basic Rules

​Transaction Examples (from Agatabo)

​Example 1: Member Deposits Cash

​Example 2: Loan Disbursement

​Example 3: Loan Payment with Interest

​Example 4: Recording an Expense

​Example 5: Dividend Distribution

​Example 6: Reserve Allocation

​Example 7: Member Withdraws Savings

​Scope Keys and Per-Entity Accounts

​Why Agatabo Uses Double-Entry

​Journal Entries in Agatabo

​Common Questions

​Q: Do I need to understand debits and credits to use Agatabo?

​Q: What if debits don’t equal credits?

​Q: Why does my cash go up (debit) but member savings also go up (credit)?

​Q: What’s the difference between Income and Revenue?

​Q: Why are member savings a liability?

​Q: How do reserves work in double-entry?

​Visual Guide: Account Flow

​Best Practices

​Need Help?

Viewing Journal Entries

General Ledger Overview

Balance Sheet

Income Statement

Manual Journal Entries

What is Double-Entry Accounting?

The Accounting Equation

Debits and Credits

Basic Rules

Transaction Examples (from Agatabo)

Example 1: Member Deposits Cash

Example 2: Loan Disbursement

Example 3: Loan Payment with Interest

Example 4: Recording an Expense

Example 5: Dividend Distribution

Example 6: Reserve Allocation

Example 7: Member Withdraws Savings

Scope Keys and Per-Entity Accounts

Why Agatabo Uses Double-Entry

Journal Entries in Agatabo

Common Questions

Q: Do I need to understand debits and credits to use Agatabo?

Q: What if debits don’t equal credits?

Q: Why does my cash go up (debit) but member savings also go up (credit)?

Q: What’s the difference between Income and Revenue?

Q: Why are member savings a liability?

Q: How do reserves work in double-entry?

Visual Guide: Account Flow

Best Practices

Need Help?