Vouchers

Vouchers are prepaid WiFi codes that customers can use to activate packages. Generate vouchers in bulk through voucher series, then distribute them to customers for self-activation.

Overview

The voucher system has two parts:

Voucher Series - Batch generation settings for creating multiple vouchers at once.

Vouchers - Individual codes generated from a series that customers redeem.

Navigate to Voucher Series to create bulk vouchers, or Vouchers to view individual codes.

Voucher Code Configuration

Before creating voucher series, configure how voucher codes are generated in Operator Settings.

Code Generation Settings

Navigate to Operator Settings → Captive Portal Configuration → Voucher Configuration to customize:

Voucher Code Length - Length of generated voucher codes (5-15 characters). Default: 10 characters.

Voucher Code Type - Character type used in voucher codes:

• Number - Numeric codes only (0-9). Example: 1234567890
• Alpha - Alphabetic codes only (A-Z). Example: ABCDEFGHIJ
• Alphanumeric - Mix of letters and numbers (A-Z, 0-9). Example: A1B2C3D4E5

Code Configuration Impact

These settings apply to all newly generated voucher series. Existing vouchers retain their original code format. Configure these settings before creating your first voucher series for consistency.

Code Type Selection Guide

Number (Default) - Best for:

• Easy telephone/verbal communication
• Simple manual entry on keypads
• Customers unfamiliar with typing letters

Alpha - Best for:

• Higher code uniqueness with shorter length
• Avoiding number confusion (0 vs O, 1 vs I)
• Premium/exclusive voucher appearance

Alphanumeric - Best for:

• Maximum code combinations
• Enhanced security
• Large-scale voucher generation

Example Code Formats

10-digit Number: 7392648501

8-character Alpha: XPQWKLMZ

12-character Alphanumeric: X3K9P2W7M5A1

Creating a Voucher Series

Click + Add on the Voucher Series page to generate bulk vouchers. Fill in the following fields:

Basic Settings

Name (required) - Internal reference name for this voucher batch (e.g., "Summer Promo 2024", "Hotel Guest Vouchers").

Operator Package (required) - Select the WiFi package that vouchers will activate. Auto-fills the prefix and price fields.

Location (required) - Location where vouchers can be redeemed.

Quantity (required) - Number of voucher codes to generate (e.g., 10, 100, 500). Cannot be changed after creation.

Voucher Configuration

Prefix (required) - Text prefix for voucher codes (e.g., "HOTEL", "DAILY", "PREMIUM"). Auto-filled from package name.

Price (required) - Selling price per voucher. Auto-filled from package price but can be modified.

Expired By (required) - Voucher expiration method:

• Package Validity - Voucher expires based on the package's validity period after activation
• Activation Time - Voucher expires after a set time from creation (requires Time Expired fields)

Time Expired (if Activation Time selected) - Number of time units before voucher expires.

Time Unit (if Activation Time selected) - Time period:

• Minute
• Hour
• Day
• Week
• Month

Use Another Location - Toggle to allow vouchers to be redeemed at locations other than the assigned one.

Expiry Types

• Package Validity: Voucher stays valid indefinitely until redeemed, then follows package duration
• Activation Time: Voucher code itself expires (e.g., "Valid for 30 days from generation")

Voucher Series Examples

Hotel Daily Vouchers

Name: Hotel Guest Vouchers - Dec 2024
Package: 24-Hour Guest WiFi
Location: Main Hotel
Quantity: 100
Prefix: HOTEL
Price: 0.00
Expired By: Package Validity
Use Another Location: No

Paid Day Passes

Name: Cafe Daily Pass
Package: Daily Pass
Location: Downtown Cafe
Quantity: 50
Prefix: CAFE
Price: 5.00
Expired By: Activation Time
Time Expired: 30 Days
Use Another Location: Yes

Promotional Codes

Name: Holiday Promo
Package: Free 2 Hours
Location: Mall WiFi
Quantity: 500
Prefix: PROMO
Price: 0.00
Expired By: Activation Time
Time Expired: 7 Days
Use Another Location: Yes

Understanding the Voucher Series Table

ID - Series identifier.

Name - Series reference name.

Operator - Company/business name.

Package - WiFi package assigned to vouchers.

Location - Redemption location.

Quantity - Number of codes generated.

Price - Selling price per voucher.

Expiry Info - Expiration method and details.

Status - Series status:

• Active (🟢) - Vouchers can be redeemed
• Inactive (🔴) - Vouchers cannot be used

Vouchers Stats - Active vouchers count (e.g., "45/100 Active" means 45 unused out of 100 total).

Created At - Series generation date.

Managing Voucher Series

Editing a Series

Click the edit icon (✏️) to modify series settings. You can change:

• Name, package, location
• Price, expiry settings
• Use another location toggle

Note: Quantity cannot be changed after creation.

Deleting a Series

Click the delete icon (🗑️) to remove a voucher series. This deletes the series and all associated voucher codes.

Delete Caution

Deleting a series removes all vouchers permanently. Customers holding those codes will no longer be able to redeem them.

Viewing Individual Vouchers

Navigate to Vouchers page to see all generated voucher codes. Each entry shows:

• Voucher code (unique activation code)
• Series name
• Package details
• Status (pending/used/expired)
• Assigned subscriber (if redeemed)
• Creation and usage dates

Use the search function to find specific voucher codes or filter by series.

Distributing Vouchers

After generating a voucher series, view individual codes in the Vouchers page. Copy codes from the table to distribute to customers.

For Hotels

Write voucher codes on welcome cards or room information sheets:

Welcome WiFi Code: HOTEL-ABC123
Valid for 24 hours

For Cafes & Restaurants

Display codes on table cards or receipts:

Free WiFi Code: CAFE-XYZ789

For Events

Share voucher codes via email to registered attendees.

For Retail

Display codes on promotional materials or share via SMS/email.

Common Use Cases

Daily Sales at Reception

Generate 100 daily pass vouchers monthly. Sell codes at reception desk for $5 each. Track sales through voucher redemption stats.

Hotel Room Vouchers

Generate enough vouchers for expected monthly guests. Share unique codes on welcome cards. Replace used series monthly.

Promotional Campaigns

Create time-limited vouchers (e.g., 7-day expiry) for marketing campaigns. Distribute codes via email or social media. Monitor redemption rates.

Bulk Corporate Sales

Generate vouchers for corporate clients purchasing WiFi access in bulk. Set appropriate expiry period and pricing. Share codes with client.

Best Practices

Code configuration - Set voucher code type and length in Operator Settings before generating your first series:

• Use Number type for easy verbal communication
• Use Alphanumeric for maximum security and uniqueness
• Shorter codes (5-8 chars) are easier to type but less unique
• Longer codes (12-15 chars) provide more combinations

Naming series - Include date/month and purpose (e.g., "Hotel Dec 2024", "Summer Promo").

Quantity planning - Generate based on expected demand. Avoid waste by using expiry dates.

Prefix selection - Use clear, short prefixes that identify the series (e.g., "VIP", "GUEST", "PROMO").

Price strategy - Set voucher price to match or discount package price for bulk purchases.

Expiry management:

• Use Package Validity for evergreen vouchers
• Use Activation Time for promotional/seasonal vouchers

Location control - Disable "Use Another Location" to restrict vouchers to specific venues.

Troubleshooting

Vouchers Not Working

Check series status - Ensure status is "Active" (green).

Verify expiry - Confirm vouchers haven't passed expiration date.

Confirm location - Check if "Use Another Location" is enabled if redeeming elsewhere.

Cannot Delete Series

Active vouchers exist - Wait until vouchers expire or are used.

Solution - Set series status to Inactive instead of deleting.

Wrong Package Assigned

Cannot change after creation - Edit not possible.

Solution - Create new series with correct package, delete old series if unused.

---

Next Steps

After generating vouchers, customers can redeem them on the WiFi login page. Monitor voucher usage through the Vouchers list and redemption statistics.