Accounts
Vouchers
Vouchers are single-use or time-limited access codes. They share the same underlying table as Users but are identified by ktype = 'voucher'. Guests redeem them on the captive portal without needing a pre-registered account.
Image not uploaded yet
public/assets/img/docs/vouchers/overview.png
Key Fields
| Field | Description |
|---|---|
username | The voucher code guests type on the portal |
status | n = unused, y = redeemed / active |
profile_subs | Access profile applied when redeemed |
date_expiry | Code expires even if unredeemed |
session_time / quota_in / quota_out | Consumed usage counters |
login_count | Times this code has been used to log in |
bulk_id | Batch identifier — groups codes generated together |
Generate Vouchers
Click Generate to open the batch creation form:
- Quantity — number of codes to generate
- Profile — access profile to assign
- Expiry date — optional; codes expire even if unredeemed
- Code prefix — optional string prepended to each code
- Code length — total characters (prefix + random suffix)
- Remark — internal label for the batch
Large batches are queued via GenerateVouchersJob. A progress indicator polls until generation completes.
All codes in one generation share the same bulk_id. You can filter the grid by bulk_id to select and print an entire batch at once.
Actions
- Reset — clears usage counters (session_time, quota). Useful to re-issue a partially used voucher.
- Reset MAC — removes the MAC binding so the code can be used on a different device.
- Delete — permanently removes the voucher code.
- Login Records — view every redemption event for this code.
- Active Sessions — see if this code is currently in use.
Required Permissions
view-vouchers · create-vouchers · update-vouchers · delete-vouchers