Overview
Vouchers are time or data-limited access tokens that grant customers internet access. Each voucher is linked to a specific customer and internet plan.Understanding Vouchers
What is a Voucher?
A voucher grants internet access for a specific duration or data amount
How It Works
Customer pays → Voucher assigned → Internet access until expiry
Voucher List
The Vouchers page displays all active vouchers:| Column | Description |
|---|---|
| # | Row number |
| Percent Used | Visual progress bar showing usage |
| Customer | Account number |
| Phone Number | Customer’s phone |
| Code | Unique voucher code |
| Plan | Internet plan name |
| Purchase Date | When voucher was assigned |
| Expiry Date | When voucher expires |
Percent Used Indicator
The progress bar shows voucher time usage:Assigning a Voucher
1
Click Assign Voucher
Click the Assign Voucher button at the top
2
Select Customer
Choose a customer from the dropdown
3
Select Plan
Choose an internet plan
4
Optional: Use Coupon
Check “Use Coupon” to apply an existing coupon instead
5
Confirm
Click Assign to create the voucher
Balance Check
Viewing Voucher Details
Click the info icon on any voucher row to see:- Full voucher code
- Customer details
- Plan information
- Start and end times
- Usage statistics
Deleting a Voucher
1
Click Delete Icon
Click the delete (trash) icon on the voucher row
2
Confirm Deletion
Click Delete in the confirmation dialog
Searching Vouchers
Search by:- Customer Account Number
- Voucher Code
- Plan Name
- Phone Number
Voucher Lifecycle
How Customers Get Vouchers
Through Captive Portal
Through Captive Portal
Customer pays via M-PESA STK push, voucher auto-assigned
Manual Assignment
Manual Assignment
Admin assigns voucher after receiving payment
Using Coupon
Using Coupon
Customer redeems a pre-assigned coupon
Kopa (BNPL)
Kopa (BNPL)
Customer gets voucher now, pays later
Auto-Expiry
Vouchers automatically expire based on:| Type | Expiry Trigger |
|---|---|
| Time-based | When validity period ends |
| Data-based | When data limit is reached |
| Combined | Whichever comes first |
Voucher Codes
Each voucher has a unique code:Best Practices
Monitor Active Vouchers
Monitor Active Vouchers
Regularly check for vouchers near expiry
Time Zones
Time Zones
All times are in your server’s timezone
Expiry Notifications
Expiry Notifications
Configure SMS reminders for expiring vouchers
Troubleshooting
| Issue | Possible Cause | Solution |
|---|---|---|
| Customer can’t connect | Voucher expired | Assign new voucher |
| Voucher shows but no access | RADIUS sync issue | Check RADIUS connection |
| Duplicate vouchers | Same plan assigned twice | Delete duplicate |
| Wrong expiry time | Time zone mismatch | Verify server timezone |