> ## Documentation Index
> Fetch the complete documentation index at: https://help.agatabo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dividends Overview

> Distribute organizational profits to members based on participation and contributions

## What are Dividends?

**Dividends** are distributions of organizational profits to members. In tontines and savings groups, dividends reward members for their participation and savings, returning a share of the organization's earnings directly to member equity accounts.

<Note>
  **How it works**: Dividends transfer funds from organizational retained earnings to individual member savings accounts. This reduces organization equity and increases member equity by the same amount - total equity remains unchanged.
</Note>

## Why Distribute Dividends?

<Note>
  **Key benefits:**

  * Reward members for participation and loyalty
  * Share organizational success with membership
  * Incentivize savings and active membership
  * Demonstrate financial health and profitability
  * Fulfill member expectations (many join tontines expecting dividends)
  * Maintain member engagement and retention
  * Provide tangible return on savings
  * Build trust through transparent profit-sharing
</Note>

## How Dividends Work in Agatabo

### 1. Create Dividend Pool (Draft)

Set up a dividend distribution for a specific period:

**Required information**:

* **Period Label**: Human-readable name (e.g., "Q1 2026", "Annual Dividend 2025")
* **Period Start**: Beginning of dividend period (e.g., 2026-01-01)
* **Period End**: End of dividend period (e.g., 2026-03-31)
* **Amount**: Total to be distributed to all eligible members

**Status**: Pool starts as **draft** (journalEntryId = null)

**Validation**:

* Period end must be on or before last closed accounting period
* Period cannot overlap with existing dividend pools
* Amount must be at least 0.01

<Note>
  **Draft state**: Draft pools are like proposals - they calculate allocations and show what each member would receive, but don't actually distribute funds until you mark them as distributed.
</Note>

***

### 2. Calculate Individual Shares (Automatic)

Agatabo automatically calculates each member's dividend based on configured distribution method:

**Distribution Methods**:

| Method                 | How it Works                           | Best For                                |
| ---------------------- | -------------------------------------- | --------------------------------------- |
| **Equal Distribution** | Every eligible member gets same amount | Small groups with similar contributions |
| **By Contribution**    | Proportional to savings balance        | Groups with varying savings levels      |

**Time-Weighting** (optional):

* Can be enabled for either method
* Accounts for membership duration during period
* Prevents new members from getting full dividend
* Adjusts allocation based on participation days

**Eligibility Criteria**:

* ✅ Member must be **active** (isActive = true)
* ❌ **NO** minimum savings balance required
* ❌ **NO** loan status restrictions
* ❌ **NO** minimum tenure requirements (time-weighting handles this)

***

### 3. Distribute Dividends (Execution)

When ready, mark pool as **distributed**:

**What happens**:

1. Creates DIVIDEND\_DISTRIBUTION journal entry
2. Debits RETAINED\_EARNINGS (organization)
3. Credits each member's SAVINGS account (individual allocations)
4. Updates pool status to "distributed" (journalEntryId populated)
5. **Permanent** - cannot be undone (only reversed via delete operation)

**Payment method**: Dividends are **automatically credited to member savings accounts** - no cash withdrawal, checks, or bank transfers.

**Requirements**:

* Distribution date must be after last closed accounting period
* Requires idempotency key (prevents duplicate distributions)
* Organization must have sufficient retained earnings

<Warning>
  **Important constraints:**

  * **Accounting period**: Dividend period end must fall within a closed accounting period
  * **Distribution timing**: Distribution date must be after the last closed period
  * **No overlapping periods**: Cannot create pools with overlapping date ranges
  * **Permanent action**: Distribution cannot be undone (only reversed by deleting pool)
  * **No approval workflow**: Direct transition from draft to distributed (no intermediate approval step)
</Warning>

***

## Common Dividend Periods

| Period            | Frequency      | Use Case                                         | Example                            |
| ----------------- | -------------- | ------------------------------------------------ | ---------------------------------- |
| **Quarterly**     | Every 3 months | Active tontines with regular profits             | Mar 31, Jun 30, Sep 30, Dec 31     |
| **Semi-Annual**   | Every 6 months | Medium-activity groups                           | Jun 30, Dec 31                     |
| **Annual**        | Once per year  | Conservative groups, formal organizations        | Dec 31                             |
| **Project-Based** | Ad-hoc         | One-time distributions after successful projects | After building sale, special event |

<Note>
  **Frequency trade-offs:**

  * **Quarterly**: Keeps members engaged, more administrative work
  * **Annual**: Larger impactful payouts, less frequent distribution effort
  * **Recommendation**: Start quarterly, move to annual if administrative burden too high
</Note>

***

## Distribution Methods Explained

### Method 1: Equal Distribution

**How it works**: Total amount ÷ Number of eligible members = Each member's share

**Formula**:

```
Member Dividend = Total Pool Amount ÷ Number of Active Members
```

**Example**:

```
Pool: 5,000,000 RWF
Eligible members: 50 (all active)
Each receives: 100,000 RWF

Member A: 100,000 RWF
Member B: 100,000 RWF
Member C: 100,000 RWF
...
Total distributed: 5,000,000 RWF
```

**Best for**:

* Small groups where everyone participates equally
* Cooperative ownership models
* Simple, easy-to-explain approach
* Groups with similar savings levels

**Advantages**:

* Simple to understand and explain
* Perceived as fair (everyone equal)
* No disputes about calculations

**Disadvantages**:

* Doesn't reward higher savings
* May discourage large savers

***

### Method 2: Distribution by Contribution

**How it works**: Member's dividend = (Member savings ÷ Total savings) × Pool amount

**Formula**:

```
Member Dividend = (Member Savings Balance / Total All Savings) × Total Pool Amount
```

**Example**:

```
Pool: 5,000,000 RWF
Total savings: 50,000,000 RWF

Member A saved: 2,000,000 RWF
  → Dividend: (2,000,000 / 50,000,000) × 5,000,000 = 200,000 RWF (4%)

Member B saved: 500,000 RWF
  → Dividend: (500,000 / 50,000,000) × 5,000,000 = 50,000 RWF (1%)

Member C saved: 10,000,000 RWF
  → Dividend: (10,000,000 / 50,000,000) × 5,000,000 = 1,000,000 RWF (20%)
```

**Best for**:

* Groups with varying member savings levels
* When fairness means "more contribution = more reward"
* Incentivizing higher savings
* Larger organizations with diverse membership

**Advantages**:

* Rewards members who save more
* Incentivizes higher savings
* Mathematically proportional

**Disadvantages**:

* More complex to explain
* Large savers get disproportionately large dividends
* May discourage small savers

***

### Time-Weighting (Optional Enhancement)

**Applies to both methods**: Can enable time-weighting for equal OR contribution-based distribution

**How it works**: Adjusts allocation based on how long member was active during period

**Equal + Time-Weighted Example**:

```
Pool: 3,000,000 RWF for Q1 2026 (90 days, Jan 1 - Mar 31)

Member A: Active all 90 days (joined before period start)
Member B: Joined Feb 1 (active 59 days: Feb 1 - Mar 31)
Member C: Joined Mar 1 (active 31 days: Mar 1 - Mar 31)

Total participation days: 90 + 59 + 31 = 180

Member A: (90 / 180) × 3,000,000 = 1,500,000 RWF (50%)
Member B: (59 / 180) × 3,000,000 = 983,333 RWF (32.8%)
Member C: (31 / 180) × 3,000,000 = 516,667 RWF (17.2%)

Total: 3,000,000 RWF
```

**Contribution + Time-Weighted Example**:

```
Pool: 5,000,000 RWF for Q1 2026 (90 days)

Member A:
  - Savings: 1,000,000 RWF (held all 90 days)
  - Weighted contribution: 1,000,000 × 90 = 90,000,000

Member B:
  - Savings: Started at 0, deposited 500,000 on day 30
  - Weighted contribution: 0 × 30 + 500,000 × 60 = 30,000,000

Total weighted: 120,000,000

Member A: (90,000,000 / 120,000,000) × 5,000,000 = 3,750,000 RWF (75%)
Member B: (30,000,000 / 120,000,000) × 5,000,000 = 1,250,000 RWF (25%)
```

**Best for**:

* Groups with frequent new member joins
* Preventing "last-minute joiners" from getting full dividend
* Fairness when membership changes during period
* Sophisticated organizations with technical capacity

***

## Dividend Pool Status

Pools have two states:

| Status          | Determination         | Meaning                                    | Actions Available              |
| --------------- | --------------------- | ------------------------------------------ | ------------------------------ |
| **Draft**       | journalEntryId = null | Allocations calculated but not distributed | View, Edit, Delete, Distribute |
| **Distributed** | journalEntryId ≠ null | Funds distributed to members               | View, Delete (reverses)        |

<Note>
  **No intermediate approval**: Agatabo does not have a formal approval workflow. Pools go directly from draft to distributed when you execute distribution. If your organization requires approval, implement it outside Agatabo (e.g., board approval before distribution).
</Note>

***

## Payment Method

**Single payment method: Credit to Savings Account**

When dividends are distributed:

* Each member's **SAVINGS account** is credited automatically
* **NO** cash withdrawal
* **NO** checks issued
* **NO** bank transfers
* **NO** manual payment required

**Member access**:

* Members can view increased savings balance immediately
* Members can withdraw from savings if desired (separate operation)
* Or leave dividend in savings to continue earning

<Warning>
  **No tax withholding**: Agatabo does NOT withhold taxes or any deductions from dividend distributions. The full amount is credited to member savings accounts. Members are responsible for their own tax obligations on dividend income.
</Warning>

***

## Accounting Treatment

When dividends are distributed, Agatabo creates a DIVIDEND\_DISTRIBUTION journal entry:

**Journal Entry**:

```
Kind: DIVIDEND_DISTRIBUTION
Date: Distribution date
Status: POSTED

Dr RETAINED_EARNINGS                 TotalAmount
   Cr SAVINGS (Member A)             AllocationA
   Cr SAVINGS (Member B)             AllocationB
   Cr SAVINGS (Member C)             AllocationC
   ...
```

**Effect**:

* Organization's retained earnings **decrease** by total pool amount
* Each member's savings balance **increases** by their allocation
* Total organization equity **unchanged** (internal transfer from org to members)

**Example**:

```
Pool: 5,000,000 RWF
Members: A (2M), B (1.5M), C (1.5M)

Dr RETAINED_EARNINGS                 5,000,000
   Cr SAVINGS (Member A)             2,000,000
   Cr SAVINGS (Member B)             1,500,000
   Cr SAVINGS (Member C)             1,500,000

Organization:
  Retained Earnings: -5,000,000 RWF (decreased)
  Member Equity (SAVINGS): +5,000,000 RWF (increased)
  Net equity: 0 (unchanged)

Members:
  Member A savings: +2,000,000 RWF
  Member B savings: +1,500,000 RWF
  Member C savings: +1,500,000 RWF
```

***

## Integration with Other Features

### Retained Earnings

Dividends are paid from **retained earnings** (accumulated profit over time).

**Source of funds**:

* Net income from Profit & Loss accumulates in retained earnings
* Must have sufficient retained earnings to create dividend pool
* System validates balance before distribution

**Calculation**:

```
Available for Dividends = Retained Earnings - Reserve Allocations

Example:
Total Retained Earnings:     25,000,000 RWF
Reserve Allocations:        -10,000,000 RWF
──────────────────────────────────────────
Available for Dividends:     15,000,000 RWF (maximum pool amount)
```

[Learn about profit & loss →](/tontines/reports/profit-and-loss)

***

### Member Savings

For **contribution-based dividends**, Agatabo uses member savings balances to calculate proportional shares.

**Balance used**:

* Without time-weighting: Current savings balance at period end
* With time-weighting: Average daily balance during period (time-weighted calculation)

**Savings accounts**:

* Each member has one SAVINGS ledger account
* Balance tracked through journal entries (deposits, withdrawals, dividends)
* Dividend credits increase savings balance automatically

[Learn about deposits & savings →](/tontines/deposits/overview)

***

### Reserves

Many organizations set aside a **dividend reserve** before creating pools, ensuring funds are available for distribution.

**Best practice workflow**:

1. Close accounting period and calculate net income
2. Allocate portion of profit to reserves (emergency, loan loss, etc.)
3. Allocate remaining amount to dividend reserve
4. Create dividend pool using dividend reserve amount
5. Distribute dividends

**Example**:

```
Net Income for Q1: 10,000,000 RWF

Allocations:
  Emergency Reserve:    2,000,000 RWF (20%)
  Loan Loss Reserve:    1,000,000 RWF (10%)
  Building Fund:        2,000,000 RWF (20%)
  Dividend Reserve:     5,000,000 RWF (50%)
──────────────────────────────────────────
Total Allocated:       10,000,000 RWF

Then:
  Create dividend pool: 5,000,000 RWF
  Release from dividend reserve: 5,000,000 RWF
  Distribute to members
```

[Learn about reserves →](/tontines/reserves/overview)

***

### Accounting Periods

**Critical constraint**: Dividend distribution requires closed accounting periods.

**Period requirements**:

* **Pool period end** must be on or before last closed period end
* **Distribution date** must be after last closed period end
* Cannot distribute dividends for periods not yet closed

**Example**:

```
Last closed period: 2026-03-31

✅ Valid:
  Pool period: 2026-01-01 to 2026-03-31 (within closed period)
  Distribution date: 2026-04-05 (after closed period)

❌ Invalid:
  Pool period: 2026-01-01 to 2026-04-30 (period end after closed period)

❌ Invalid:
  Pool period: 2026-01-01 to 2026-03-31 (valid)
  Distribution date: 2026-03-25 (before/during closed period)
```

**Why this constraint**:

* Ensures profit calculations are finalized
* Prevents distributing profits before period close
* Maintains accounting integrity

[Learn about period closing →](/tontines/advanced/period-closing)

***

## Validation and Constraints

### Input Validation

**Period Label**:

* ✅ Must be non-empty string
* ✅ Descriptive name for the period
* ❌ Cannot be blank

**Period Start/End**:

* ✅ Must be valid ISO dates
* ✅ End must be after start
* ✅ End must be on or before last closed period
* ❌ Cannot overlap with existing dividend pools

**Amount**:

* ✅ Must be at least 0.01
* ✅ Must match organization's currency decimal places
* ❌ Cannot be negative or zero
* ❌ Cannot exceed available retained earnings (unless skipNegativeBalanceCheck)

### Business Logic Validation

**Period Overlap Check**:

* System checks for existing pools with overlapping date ranges
* Error if overlap found: "A dividend pool already exists for overlapping period: {periodLabel}"

**Accounting Period Constraint**:

* Pool end date must be within closed accounting period
* Distribution date must be after last closed period
* Error if violated

**Retained Earnings Check**:

* Validates sufficient retained earnings before distribution
* Can skip with `skipNegativeBalanceCheck: true` (requires special permission)

**Eligibility Validation**:

* At least one active member must exist
* Error if no active members: "No active organizationUsers eligible for dividend distribution"

**Idempotency**:

* All distribution operations require idempotency key (header: `x-idempotency-key`)
* Prevents duplicate distributions from retries
* Safe for network failures

***

## Best Practices

<Note>
  **Dividend management tips:**

  **Policy & Planning:**

  * Establish consistent dividend schedule (e.g., quarterly on last day of quarter)
  * Document dividend policy in bylaws (method, frequency, eligibility)
  * Communicate policy clearly to members before they join
  * Reserve 50-60% of profit for dividends, rest for reserves and growth

  **Reserve Management:**

  * Set aside dividend reserve before creating pools
  * Don't distribute 100% of profit (maintain reserves)
  * Common split: 50% dividends, 30% reserves, 20% retained for growth

  **Approval & Governance:**

  * Get board/committee approval for dividend pools before distribution
  * For large pools (> 2M RWF), consider full member vote
  * Document approval in meeting minutes
  * Implement external approval workflow if needed (Agatabo doesn't have built-in approval)

  **Communication:**

  * Notify members before distribution (explain allocation method)
  * Allow time for members to verify calculations
  * Communicate dividend distribution clearly
  * Celebrate milestone dividends with members

  **Timing:**

  * Create draft pools early (members can see projected allocations)
  * Distribute within 30 days of period close
  * Avoid delays (members expect timely distributions)

  **Method Selection:**

  * Use **equal** for small, homogeneous groups
  * Use **contribution-based** for diverse savings levels
  * Enable **time-weighting** if frequent new member joins
  * Be consistent - don't change method frequently
</Note>

***

## Example Dividend Policy

Provide to members for transparency:

```
DIVIDEND DISTRIBUTION POLICY
[Organization Name]

Effective Date: June 12, 2026
Last Review: June 2026
Next Review: June 2027

────────────────────────────────────────────────────────

1. FREQUENCY
   Dividends distributed quarterly on:
   - March 31 (Q1)
   - June 30 (Q2)
   - September 30 (Q3)
   - December 31 (Q4)

2. ELIGIBILITY
   All members with active status as of last day of quarter
   No minimum savings balance required
   Members who join mid-quarter receive prorated allocation

3. DISTRIBUTION METHOD
   Method: By contribution (proportional to savings balance)
   Time-Weighting: Enabled (accounts for join date)
   Calculation: (Member weighted savings / Total weighted savings) × Pool

4. PROFIT ALLOCATION
   Net income allocated as follows:
   - 50% distributed as dividends
   - 20% allocated to reserves (Emergency, Loan Loss, Building)
   - 30% retained for operations and growth

5. APPROVAL PROCESS
   - Treasurer creates draft dividend pool within 15 days of quarter close
   - Executive committee reviews and approves
   - Pools > 2,000,000 RWF require full member vote
   - Distribution occurs within 30 days of quarter close

6. PAYMENT METHOD
   Dividends automatically credited to member savings accounts
   Members may withdraw or leave in savings (continues earning)
   No automatic cash distribution

7. MINIMUM DISTRIBUTION
   Quarterly dividend pool minimum: 500,000 RWF
   If net income insufficient, may skip quarter and distribute semi-annually

8. TAXATION
   Members responsible for own tax obligations on dividend income
   Organization provides annual dividend statements for tax purposes

────────────────────────────────────────────────────────

GENERAL PROVISIONS:
- Policy reviewed annually at AGM
- Changes require 2/3 member vote
- Members notified 7 days before distribution
- Dispute resolution: Executive committee decision final

Approved by: Member Assembly
Date: June 10, 2026
Next Review: Annual General Meeting 2027
```

***

## Permissions Required

| Action                | Permission        | Scope       |
| --------------------- | ----------------- | ----------- |
| View dividend pools   | `dividends:read`  | ANY or SELF |
| Create dividend pool  | `dividends:write` | ANY         |
| Distribute pool       | `dividends:write` | ANY         |
| Delete pool           | `dividends:write` | ANY         |
| View member dividends | `dividends:read`  | SELF or ANY |
| View analytics        | `dividends:read`  | ANY         |

<Note>
  **Typical roles**:

  * Administrators and Accountants have `dividends:write`
  * Members have `dividends:read` with SELF scope (can view their own dividends only)
  * Board members may have `dividends:read` with ANY scope
</Note>

***

## Related Topics

<CardGroup cols={2}>
  <Card title="Creating Dividend Pools" icon="plus" href="/tontines/dividends/creating-dividend-pools">
    Set up dividend distributions
  </Card>

  <Card title="Distributing Dividends" icon="hand-coins" href="/tontines/dividends/distributing-dividends">
    Mark pools as distributed
  </Card>

  <Card title="Dividend Reporting" icon="chart-bar" href="/tontines/dividends/dividend-reporting">
    View dividend history and analytics
  </Card>

  <Card title="Profit & Loss" icon="chart-line" href="/tontines/reports/profit-and-loss">
    Calculate net income for dividends
  </Card>

  <Card title="Reserves" icon="piggy-bank" href="/tontines/reserves/overview">
    Set aside funds for dividends
  </Card>

  <Card title="Period Closing" icon="lock" href="/tontines/advanced/period-closing">
    Close periods before distribution
  </Card>
</CardGroup>