Vouchers

Vouchers are pre-generated access codes that grant temporary network access. They are commonly used in hotels (one voucher per guest), cafes (printed on receipts), and events (distributed to attendees). Each voucher can have time limits, data caps, and bandwidth restrictions.

Creating Vouchers

Single Voucher

1. Navigate to Users > Vouchers
2. Click Add Voucher
3. Configure settings:
   • Code - Auto-generated or custom
   • Validity - Duration the voucher is usable
   • Usage Limit - Number of times it can be used
4. Click Save

Bulk Generation

1. Navigate to Users > Vouchers
2. Click Generate Batch
3. Configure:
   • Quantity - Number of vouchers
   • Prefix - Optional prefix for codes
   • Validity - Duration for all vouchers
   • Session Limits - Time/data limits per use
4. Click Generate

Voucher Settings

Time Limits

Setting	Description
Validity Period	How long the voucher code remains valid
Session Duration	Maximum time per connection session
Total Time	Cumulative time allowed across all sessions

Data Limits

Setting	Description
Download Limit	Maximum download data
Upload Limit	Maximum upload data
Total Data	Combined upload/download limit

Usage Settings

Setting	Description
Single Use	Voucher works once only
Multi-Use	Voucher can be used multiple times
Device Limit	Maximum devices per voucher
Concurrent Sessions	Simultaneous connections allowed

Voucher Attributes

Apply standard RADIUS attributes to vouchers:

Bandwidth Limits

Session Timeout

Session-Timeout := 3600

Voucher Authentication

On Captive Portal

1. User connects to guest WiFi
2. Splash page appears
3. User enters voucher code
4. Authentication processed
5. Access granted with configured limits

Configuration

1. Create a Captive Portal
2. Add "Voucher" as an Authentication Provider
3. Configure the splash page to show voucher input
4. Optionally customize the voucher form appearance

Managing Vouchers

Viewing Vouchers

The voucher list shows:

• Code
• Status (Active, Used, Expired)
• Creation date
• Expiration date
• Usage count

Filtering

Filter vouchers by:

• Status
• Creation date range
• Usage status

Exporting

Export voucher codes:

1. Select vouchers or "Select All"
2. Click Export
3. Choose format (CSV, PDF)
4. Download file

Printing

Print voucher cards:

1. Select vouchers
2. Click Print
3. Choose template (cards, list)
4. Print or save as PDF

Integration with PMS

For hotels using Property Management Systems:

1. Enable PMS integration in Account Settings
2. Configure the PMS connector
3. Vouchers can be auto-generated on guest check-in
4. Vouchers auto-expire on check-out

Best Practices

1. Set appropriate limits - Balance usability with resource management
2. Use prefixes - Organize vouchers by date, event, or purpose
3. Regular cleanup - Delete expired vouchers periodically
4. Monitor usage - Review voucher authentication reports
5. Secure distribution - Don't publicly share voucher codes

Common Use Cases

Hotel Guest Access

• Generate on check-in
• Validity matches stay duration
• Moderate bandwidth limits
• Single device or unlimited

Event WiFi

• Bulk generate before event
• Fixed validity (event duration)
• Higher bandwidth for business events
• Lower for public events

Cafe/Restaurant

• Print on receipts
• Short validity (2-4 hours)
• Single use
• Basic bandwidth

Frequently Asked Questions

Q: How many vouchers can I generate at once?

You can generate vouchers in bulk using the Generate Batch feature. The exact limit depends on your subscription plan. Each batch can include a custom prefix, validity period, and session limits applied uniformly to all generated vouchers.

Q: Can a single voucher be used on multiple devices?

Yes, if you configure the voucher as multi-use and set a device limit greater than 1. For example, a hotel room voucher could allow up to 3 concurrent devices. Single-use vouchers work only once and cannot be reused after the session ends.

Q: What happens when a voucher expires?

When a voucher's validity period ends, it can no longer be used to start new sessions. Any active session authenticated with that voucher continues until the session timeout is reached or the user disconnects. Expired vouchers remain visible in the voucher list with an "Expired" status.

Q: Can I print voucher codes as cards for guests?

Yes. Select vouchers from the list, click Print, and choose a template (cards or list format). The output can be printed directly or saved as a PDF. Card templates are designed for easy cutting and distribution to hotel guests or event attendees.

Q: How do I add bandwidth limits to vouchers?

Add RADIUS reply attributes to the voucher configuration. Set

WISPr-Bandwidth-Max-Down

for download speed and

WISPr-Bandwidth-Max-Up

for upload speed (values in bits per second). You can also set

Session-Timeout

to limit session duration.

Related Topics

• Captive Portal Configuration -- set up the portal where guests redeem voucher codes
• Authentication Providers -- enable voucher authentication alongside social login or email
• ShareCodes -- alternative access code distribution method
• User Account Management -- manage accounts created through voucher authentication
• Groups and Access Policies -- apply shared bandwidth and session limits to voucher users