Member Share Lifecycle

This guide explains how to test the full share lifecycle: configure a share product, open a member share account, record share capital activity, issue certificates, pledge or restrict units, declare dividends, and review governance and accounting outcomes.

Use this flow for cooperatives, SACCOs, investment clubs, companies, or member-based organizations where shares define ownership, voting rights, dividend eligibility, and member capital.

Workspace Reference

Workspace	How Users Reach It	What Users Usually Do There
Parties	Parties -> Individual Clients, Groups, or Organizations	Create or confirm the member or shareholder record.
Share Products	Shares -> Setup -> Products	Configure share class, pricing, dividend, transfer, pledge, withdrawal, voting, and accounting behavior.
Share Accounts	Shares -> Registry -> Accounts	Open the share account and review ownership balances.
Share Capital	Shares -> Capital	Record purchases, transfers, pledges, capital calls, withdrawals, and redemptions.
Certificates And Beneficiaries	Shares -> Registry	Issue certificates and maintain beneficiaries.
Dividends	Shares -> Distributions -> Dividends	Declare, allocate, approve, reinvest, or pay dividends.
Governance	Shares -> Governance -> Meetings	Record meetings, attendance, resolutions, voting, and proxy activity.
Accounting And Payments	Accounting and Payments & Settlement workspaces	Review postings and execute payouts where needed.

Scenario

Nakasero Farmers Cooperative admits Sarah as a member and issues shares to her.

The team must:

• confirm Sarah as a party record
• configure or select the correct share product
• open Sarah's share account
• record the first share purchase
• issue a certificate
• test a pledge or restriction if the product allows it
• declare a dividend event later
• pay or reinvest the dividend
• review accounting, balances, and governance rights

End-To-End Flow

Step	Workspace	Business Meaning
1	Parties	Member identity and contact data are confirmed.
2	Share Product Setup	Product rules are ready before ownership is recorded.
3	Share Account	The member receives an ownership account.
4	Share Transaction	Purchase, allotment, transfer, or adjustment changes ownership units.
5	Certificate	Formal proof of ownership is issued where policy requires it.
6	Pledge Or Restriction	Available units are restricted when used as security or under policy.
7	Dividend Event	Eligible units are included in dividend allocation.
8	Payout Or Reinvestment	Dividend is paid through Payments or reinvested into shares.
9	Governance	Voting rights and meeting participation are reviewed.
10	Accounting And Reports	Ownership, payout, and GL outcomes are checked.

Key Steps And Fields

1. Confirm The Member

Open Parties.

Confirm the member name, contact details, active status, approval status, and any membership classification needed by the share product. Avoid duplicate party records because duplicate members split ownership, dividends, certificates, and governance history.

2. Confirm Share Product

Open Shares -> Setup -> Products.

Important product settings:

Setting	Why It Matters
Share Type Or Class	Determines the broad ownership behavior.
Currency And Par Value	Controls share value and financial presentation.
Issue And Holding Limits	Prevents invalid purchases or over-allocation.
Transfer, Pledge, Withdrawal Rules	Controls which capital actions are allowed.
Dividend Policy	Determines eligibility, allocation basis, and payout or reinvestment behavior.
Governance Rights	Controls voting and meeting behavior.
Accounting Readiness	Prevents approved transactions from failing during finance review.

3. Open Share Account

Open Shares -> Registry -> Accounts.

Create the account for the member and selected share product.

Important account fields:

Field	Meaning
Share Product	Product whose rules the account follows.
Account Holder	Member or shareholder who owns the shares.
Business Unit	Branch or operating unit responsible for the account.
Opening Or Initial Units	Starting units where allowed.
Status	Controls whether share actions are allowed.
Notes	Membership decision, opening explanation, or exception reason.

4. Record Share Capital Transaction

Open Shares -> Capital -> Transactions.

Record a purchase, allotment, transfer, adjustment, redemption, or call payment according to the product rules.

Check the transaction type, account, units, unit price, amount, effective date, reference, and notes. Approve only when the units, value, and funding evidence are correct.

5. Issue Certificate

Open Shares -> Registry -> Certificates.

Issue certificates only from approved ownership. Check share account, certificate type, units, issue date, certificate number, and surrender or replacement rules.

6. Test Pledge Or Withdrawal

Open Shares -> Capital -> Pledges or Shares -> Capital -> Withdrawals.

Check available units before creating a pledge or withdrawal request. Total units may be higher than available units because units can be pledged, locked, pending transfer, or restricted by product rules.

7. Declare Dividend

Open Shares -> Distributions -> Dividends.

Create the dividend event, review projection, run final allocation, approve the event, and process payout or reinvestment.

Important dividend fields:

Field	Meaning
Share Product	Product whose accounts are eligible.
Period Or Fiscal Year	Distribution window.
Dividend Basis	Rule used to calculate entitlement.
Allocation Run	Projection or final result.
Payment Or Reinvestment Option	Determines whether value leaves through Payments or increases share capital.

8. Review Governance

Open Shares -> Governance -> Meetings.

Confirm the member's voting eligibility, attendance, proxy representation, resolutions, and voting outcome. Governance should follow approved ownership and product rules.

Pass Criteria For The Test Flow

The flow is complete when:

• member party is active and not duplicated
• share product rules control account and transaction behavior
• share account shows correct total, paid-up, available, pledged, and restricted units
• certificate links to approved ownership
• pledge or withdrawal respects available units
• dividend event includes only eligible accounts
• payout or reinvestment is traceable
• governance rights match ownership rules
• accounting and reports agree with share activity

Common Problems

Problem	What To Check
Account cannot open	Party status, product status, business unit restrictions, and approval requirements.
Transaction is blocked	Product flags, available units, limits, status, and funding evidence.
Certificate units are wrong	Approved transactions, account balance, replacements, and surrendered certificates.
Dividend allocation is wrong	Eligibility date, paid-up units, dividend method, restrictions, and final run.
Payout fails	Payment instrument, batch type, channel, approval, and execution result.

Related Guides

• Shares Overview
• Shares Setup
• Share Registry
• Share Capital
• Share Distributions
• Hybrid Share + Deposit Distributions