Getting Started
Welcome to the Benopro Documentation! This portal provides comprehensive guides, API references, and tutorials for using and integrating the Benopro platform.
Overview of Benopro Platform
Benopro is a comprehensive platform designed for NGOs, development programs, and organizations working with beneficiaries, VSLA groups, cooperatives, and field projects.
Key features include:
- Beneficiary Registration & Management
- VSLA & SACCO Management
- Cooperatives & Small Enterprises
- Field Data Collection (online/offline)
- Livelihood Tracking
- Market Linkage
- Executive Dashboards & Reporting
- Finance & Payment Integration
Roles & Permissions
Benopro supports multiple user roles with different permission levels:
Full system access including user management, module configuration, system health monitoring, and payment setup.
Access to team management, reporting, beneficiary oversight, and approval workflows.
Mobile app access for data collection, beneficiary registration, and activity tracking in online/offline mode.
Executive dashboard access for program oversight, analytics, and high-level reporting.
System Requirements
To use Benopro effectively, ensure your systems meet these requirements:
Web Platform
- Modern web browser (Chrome 80+, Firefox 75+, Safari 13+, Edge 80+)
- JavaScript enabled
- Internet connection (for real-time features)
Mobile App
- Android 8.0+ or iOS 13.0+
- Minimum 2GB RAM
- GPS capability (for location tracking)
- Camera (for photo documentation)
API Reference
Benopro provides a comprehensive REST API for integration with other systems and custom applications.
Authentication
All API requests require authentication using JWT tokens. Obtain your API key from the admin panel.
POST /api/v1/auth/login
{
"username": "your_username",
"password": "your_password"
}
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 3600
}
Beneficiary API
Manage beneficiary data through our REST API.
GET /api/v1/beneficiaries
POST /api/v1/beneficiaries
{
"first_name": "Rajabu",
"last_name": "Masiki",
"phone": "+255700000000",
"location": {
"latitude": -6.7924,
"longitude": 39.2083
}
}
Tutorials & Video Guides
Learn how to use Benopro with our step-by-step tutorials and video guides.
Video Tutorials
Benopro Platform Walkthrough Video
Interactive Tutorials
Try our interactive tutorials to learn Benopro features hands-on:
Learn how to register beneficiaries with step-by-step guidance.
Start Tutorial
Learn how to create and manage VSLA groups, track savings and loans.
Start Tutorial
Frequently Asked Questions
Common Issues
If you're having trouble logging in:
- Ensure you're using the correct username/email and password
- Check if Caps Lock is on (passwords are case-sensitive)
- Try resetting your password using the "Forgot Password" link
- Clear your browser cache and cookies, then try again
- If using MFA, ensure you're entering the correct code
If your mobile app data isn't syncing:
- Check your internet connection
- Ensure you have the latest version of the app
- Try manually triggering sync from the app menu
- Restart the app and try again
- If the problem persists, contact support with details of the issue
STK Payment Issues
If beneficiaries are not receiving STK push prompts:
- Verify the phone number is correct and registered with a mobile money provider
- Check if the user has sufficient airtime or mobile money balance
- Ensure the phone number is in the correct format (e.g., +255700000000)
- Try resending the STK push
- If the issue persists, check the payment logs in the admin panel