Add-on Services Feature

Executive Summary

The Add-on Services feature is a comprehensive credit-based billing and service management system that enables users to purchase and consume virtual credits for various application services. The system operates on a prepaid credit model where users buy credits upfront and consume them as they use services, with intelligent threshold monitoring and automated notifications to prevent service interruptions.

Core Value Proposition

• Predictable Costs: Users prepay for services with transparent credit pricing
• Service Continuity: Automatic threshold monitoring prevents unexpected service interruptions
• Flexible Pricing: Support for both bundle packages and pay-per-use models
• Real-time Monitoring: Live credit balance tracking with proactive notifications

Supported Services

The system currently supports two primary service types:

1. SMS Messaging Service

Credits for sending SMS messages through the application

• Service Key: 'SMS Messaging'
• Credit Label: 'sms'
• Usage Pattern: One credit per SMS sent
• Integration: Direct integration with SMS gateway APIs

2. Local Purchase Orders (LPO) Service

Credits for processing LPO documents via OCR

• Service Key: 'Eva Docs'
• Credit Label: 'pages'
• Usage Pattern: Credits based on document page count
• Integration: External OCR service processing

Note: The system is designed to be extensible for additional service types in the future, but currently only these two services are implemented and in active use.

Key Features

Credit Management

• Purchase Credits: Currently supports MPesa. In future we will be able to support multiple payment methods (Card, for example)
• Credit Tracking: Real-time balance monitoring
• Usage Analytics: Detailed consumption reports and trends
• Hold Mechanism: Credits can be held for async operations

Payment Processing

• MPesa Integration: STK Push payments with verification
• Invoice Generation: Automatic invoice creation and delivery
• Payment Verification: Real-time payment confirmation

Threshold Monitoring

• Configurable Thresholds: Set custom low-credit alerts per service
• Automated Notifications: Email and real-time alerts when credits run low
• Multiple Alert Levels: Healthy, Low, and Empty status indicators
• Proactive Alerts: Prevent service interruptions through early warnings

Business Benefits

For Users

• Transparent Pricing: Clear cost visibility before service usage
• No Surprises: Prepaid model eliminates unexpected charges
• Service Continuity: Proactive alerts prevent service interruptions
• Flexible Payment: Multiple payment options for credit purchases

For Administrators

• Revenue Predictability: Prepaid model provides predictable cash flow
• Automated Management: Reduced manual intervention through automation
• Comprehensive Reporting: Detailed usage and revenue analytics
• System Health Monitoring: Proactive monitoring and alerting

For Developers

• Extensible Architecture: Easy to add new service types
• Clean APIs: Well-documented REST APIs for integration
• Event-Driven Design: Real-time updates through WebSocket events
• Comprehensive Logging: Detailed audit trails for troubleshooting

---

The Add-on Services feature represents a significant innovation in service monetization and management, providing a robust foundation for scaling service offerings while maintaining excellent user experience and operational efficiency.