Introduction
This documentation covers the advanced account management features available on the UBU Finance System Platform (https://system.ubu-economy.com). The platform implements a sophisticated hierarchical account structure where:
- Bank Accounts serve as the primary container with a shared account number
- Currency Accounts are sub-accounts within a bank account, each handling a specific currency
- Balance Indexing Accounts are the operational level where actual banking operations occur and cards are assigned
- Joint Ownership allows multiple customers to share account access with different permission levels
- Card Management enables assignment and management of cards at the balance indexing level
This structured approach ensures efficient account management while maintaining flexibility for different customer needs and regulatory compliance.
System Platform URL: https://system.ubu-economy.com
The system platform is designed for bank administrators and staff to manage all aspects of customer accounts, from creation to advanced features like joint ownership and card management.
Account Hierarchy Structure
1. Bank Account (Primary Level)
- Shared Account Number: All currency accounts under a bank account share the same account number
- Account Type Configuration: Determines features like joint ownership support and maximum joint owners
- Customer Association: Links to the primary account holder
2. Currency Account (Secondary Level)
- Currency-Specific: Each currency account handles a specific currency (RWF, USD, EUR, etc.)
- Balance Management: Maintains separate balances for each currency
- Account Type Currency Configurations: Specific settings for each currency within an account type
3. Balance Indexing Account (Operational Level)
- Operational Unit: Where actual banking operations are performed
- Card Assignment: Cards are assigned at this level
- Transaction Processing: All transactions occur at the balance indexing level
- Multiple Wallets: Each currency account can have multiple balance indexing accounts
Account Management Features
Bank Account Management
View Bank Accounts List Feature
| Aspect |
Description |
| Permission |
View Accounts |
| Functionality |
View list of all bank accounts with filtering options |
| Access |
Accounts sidebar button |
| Platform |
System Platform |
Create New Bank Account Feature
| Aspect |
Description |
| Permission |
Create Accounts |
| Functionality |
Add new bank accounts to the system with account type selection |
| Access |
Create New Account button on customer profile page, under Bank Accounts Tab |
| Platform |
System Platform |
View Bank Account Details Feature
| Aspect |
Description |
| Permission |
View Account Details |
| Functionality |
View detailed bank account information including all currency accounts |
| Access |
View icon button on account row |
| Platform |
System Platform |
Activate/Deactivate Bank Account Feature
| Aspect |
Description |
| Permission |
Update Account Status |
| Functionality |
Change bank account status |
| Access |
Deactivate account button on account details page |
| Platform |
System Platform |
Currency Account Management
View Currency Accounts Feature
| Aspect |
Description |
| Permission |
View Accounts |
| Functionality |
View all currency accounts within a bank account |
| Access |
Currency accounts section in bank account details |
| Platform |
System Platform |
Add Currency to Bank Account Feature
| Aspect |
Description |
| Permission |
Update Accounts |
| Functionality |
Add a new currency account to an existing bank account |
| Access |
"Add Currency" button in currency accounts view |
| Platform |
System Platform |
Edit Currency Account Feature
| Aspect |
Description |
| Permission |
Update Accounts |
| Functionality |
Modify currency account settings |
| Access |
Edit button on currency account row |
| Platform |
System Platform |
Delete Currency Account Feature
| Aspect |
Description |
| Permission |
Delete Accounts |
| Functionality |
Remove a currency account |
| Access |
Delete icon button on currency account row |
| Platform |
System Platform |
Balance Indexing Account Management
View Balance Indexing Accounts Feature
| Aspect |
Description |
| Permission |
View Accounts |
| Functionality |
View all balance indexing accounts within a currency account |
| Access |
Balance indexing section in currency account details |
| Platform |
System Platform |
Create Balance Indexing Account Feature
| Aspect |
Description |
| Permission |
Create Accounts |
| Functionality |
Add a new balance indexing account to a currency account |
| Access |
"Add Balance Indexing" button in balance indexing accounts view |
| Platform |
System Platform |
Activate/Deactivate Balance Indexing Account Feature
| Aspect |
Description |
| Permission |
Update Account Status |
| Functionality |
Change balance indexing account status |
| Access |
Status toggle on balance indexing account row |
| Platform |
System Platform |
Close Balance Indexing Account Feature
| Aspect |
Description |
| Permission |
Update Account Status |
| Functionality |
Close a balance indexing account permanently |
| Access |
Close account button on balance indexing details |
| Platform |
System Platform |
Joint Ownership Management
Joint Account Support
Account Type Joint Configuration
| Aspect |
Description |
| Permission |
Update Account Types |
| Functionality |
Configure joint ownership support for account types |
| Access |
Account type configuration settings |
| Platform |
System Platform |
- Account types can be configured to support joint ownership
- Maximum number of joint owners can be set per account type
- Joint ownership settings are applied when creating bank accounts
Joint Owner Management
View Joint Owners Feature
| Aspect |
Description |
| Permission |
View Accounts |
| Functionality |
View all joint owners for a bank account |
| Access |
Joint Owners section in bank account details |
| Platform |
System Platform |
Add Joint Owner Feature
| Aspect |
Description |
| Permission |
Update Accounts |
| Functionality |
Add a new customer as joint owner to a bank account |
| Access |
"Add Joint Owner" button in joint owners section |
| Platform |
System Platform |
Requirements for Adding Joint Owner:
- Customer must be KYC verified
- Account type must support joint ownership
- Maximum joint owners must be more than 1
Joint Owner Types
| Type |
Description |
| Primary |
Primary joint owner with full account access |
| Secondary |
Secondary joint owner with limited permissions |
Edit Joint Owner Feature
| Aspect |
Description |
| Permission |
Update Accounts |
| Functionality |
Modify joint owner permissions and settings |
| Access |
Edit button on joint owner row |
| Platform |
System Platform |
Deactivate Joint Owner Feature
| Aspect |
Description |
| Permission |
Update Accounts |
| Functionality |
Deactivate a joint owner (temporary suspension) |
| Access |
Deactivate button on joint owner row |
| Platform |
System Platform |
Transfer Primary Ownership Feature
| Aspect |
Description |
| Permission |
Update Accounts |
| Functionality |
Transfer primary ownership to another joint owner |
| Access |
Transfer Primary button on joint owner row |
| Platform |
System Platform |
Card Management
Card Type Management
View Card Types Feature
| Aspect |
Description |
| Permission |
View Card Types |
| Functionality |
View list of all card types available in the system |
| Access |
Card Types sidebar button |
| Platform |
System Platform |
Create Card Type Feature
| Aspect |
Description |
| Permission |
Create Card Types |
| Functionality |
Add new card types to the system |
| Access |
Create Card Type button on card types list page |
| Platform |
System Platform |
Edit Card Type Feature
| Aspect |
Description |
| Permission |
Update Card Types |
| Functionality |
Modify card type settings |
| Access |
Edit button on card type row |
| Platform |
System Platform |
Delete Card Type Feature
| Aspect |
Description |
| Permission |
Delete Card Types |
| Functionality |
Remove card types from the system |
| Access |
Delete button on card type row |
| Platform |
System Platform |
Card Assignment and Management
View Cards Feature
| Aspect |
Description |
| Permission |
View Cards |
| Functionality |
View all cards assigned to balance indexing accounts |
| Access |
Cards section in balance indexing account details |
| Platform |
System Platform |
Assign Card to Balance Indexing Account Feature
| Aspect |
Description |
| Permission |
Create Cards |
| Functionality |
Assign a new card to a balance indexing account |
| Access |
"Assign Card" button in cards section |
| Platform |
System Platform |
Card Management Actions
| Action |
Permission |
Description |
| Lock Card |
Update Cards |
Temporarily lock a card |
| Unlock Card |
Update Cards |
Unlock a previously locked card |
| Renew Card |
Update Cards |
Renew an expiring card |
| Activate Card |
Update Cards |
Activate a new card |
| Deactivate Card |
Update Cards |
Deactivate an active card |
| Expire Card |
Update Cards |
Mark a card as expired |
Account Type Management
Account Type Configuration
View Account Types Feature
| Aspect |
Description |
| Permission |
View Account Types |
| Functionality |
View list of account types and their features |
| Access |
Account Types sidebar button |
| Platform |
System Platform |
Create Account Type Feature
| Aspect |
Description |
| Permission |
Create Account Types |
| Functionality |
Add new account types to the system |
| Access |
Create Account Type button on types list page |
| Platform |
System Platform |
Edit Account Type Feature
| Aspect |
Description |
| Permission |
Update Account Types |
| Functionality |
Modify account type settings |
| Access |
Edit button on account type row |
| Platform |
System Platform |
Delete Account Type Feature
| Aspect |
Description |
| Permission |
Delete Account Types |
| Functionality |
Remove account types from the system |
| Access |
Delete button on account type row |
| Platform |
System Platform |
Account Type Currency Configurations
View Currency Configurations Feature
| Aspect |
Description |
| Permission |
View Account Types |
| Functionality |
View currency-specific configurations for account types |
| Access |
Currency configurations section in account type details |
| Platform |
System Platform |
Edit Currency Configuration Feature
| Aspect |
Description |
| Permission |
Update Account Types |
| Functionality |
Modify currency-specific settings for account types |
| Access |
Edit button on currency configuration row |
| Platform |
System Platform |
Delete Currency Configuration Feature
| Aspect |
Description |
| Permission |
Delete Account Types |
| Functionality |
Remove currency configuration from account type |
| Access |
Delete button on currency configuration row |
| Platform |
System Platform |
Account Filtering and Search
Search Feature
| Aspect |
Description |
| Permission |
View Accounts |
| Functionality |
Search accounts by number, customer, type |
| Access |
Search bar on accounts list page |
| Platform |
System Platform |
Advanced Filtering Feature
| Aspect |
Description |
| Permission |
View Accounts |
| Functionality |
Filter by type, status, balance range, dates |
| Access |
Filter button on accounts list page |
| Platform |
System Platform |
System Administration
- Multi-level Account Management: Complete control over bank accounts, currency accounts, and balance indexing accounts
- Joint Ownership Administration: Full management of joint account relationships and permissions
- Card Management: Comprehensive card type creation and assignment capabilities
- Account Type Configuration: Advanced settings for account types and currency configurations
Security and Compliance
- KYC Verification Integration: Joint owners must be KYC verified before being added
- Permission-Based Access: All features are protected by granular permissions
- Audit Trail: Complete logging of all account management activities
- Multi-level Validation: Validation at bank account, currency account, and balance indexing levels
Summary Table of Features
| Feature Category |
Description |
Permission Required |
Platform |
| Bank Account Management |
Create, view, edit, and manage bank accounts |
View/Create/Update Accounts |
System Platform |
| Currency Account Management |
Manage currency-specific sub-accounts within bank accounts |
View/Create/Update Accounts |
System Platform |
| Balance Indexing Management |
Manage operational accounts where cards are assigned |
View/Create/Update Accounts |
System Platform |
| Joint Ownership Management |
Add, edit, and manage joint account owners |
View/Update Accounts |
System Platform |
| Card Type Management |
Create and manage card types |
View/Create/Update Card Types |
System Platform |
| Card Assignment |
Assign and manage cards on balance indexing accounts |
View/Create/Update Cards |
System Platform |
| Account Type Configuration |
Configure account types and currency settings |
View/Create/Update Account Types |
System Platform |
See Also