> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiacom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vouchers

> Issue prepaid, free, promotional, or limited-use WiFi access codes for captive portal environments.

**Vouchers** is a controlled-access feature for captive portal environments. It allows an admin or venue operator to create access code plans and generate individual codes that guests enter at the portal login screen to gain WiFi access — no phone number or social login required.

The system has two layers: **Plans** (the rules template) and **Codes** (individual access codes generated from a plan).

## Creating a plan

Navigate to **Data Plans → Vouchers** and click **New Plan**.

### Access rules

| Setting              | Description                                                                                               |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| Plan name            | Internal label — e.g. "Coffee purchase 2hr", "Conference day pass", "Free 30min"                          |
| Location             | Which venue this plan belongs to                                                                          |
| Validity period      | Number of days the code remains valid from first use                                                      |
| Session duration     | How long a single WiFi session lasts — e.g. 2 hours, 1 day                                                |
| Download speed limit | Maximum download bandwidth per session (leave blank for unlimited)                                        |
| Upload speed limit   | Maximum upload bandwidth per session (leave blank for unlimited)                                          |
| Traffic quota        | Total data allowed per code in MB or GB (leave blank for unlimited)                                       |
| Device limit         | Maximum number of devices that can use this code                                                          |
| Device binding       | When ON, the code is permanently bound to the first device that uses it — subsequent devices are rejected |

### Branding

| Setting         | Description                                                                      |
| --------------- | -------------------------------------------------------------------------------- |
| Logo            | Displayed on the printable voucher output                                        |
| Voucher message | Custom text shown on the voucher — e.g. "Thank you for dining with us"           |
| CTA link        | Optional button on the printed voucher — e.g. "Visit our menu" with a URL        |
| QR preview      | Toggle to include a scannable QR code of the access code on the printable output |

## Generating codes

Once a plan is saved:

1. Open the plan and click **Generate codes**.
2. Enter the number of codes to generate.
3. Click **Generate**. Wiacom creates unique alphanumeric codes attached to this plan's rules.
4. Export the codes as **Excel** or **PDF**.

The PDF export formats each code as a printable voucher card — plain text code, QR code, plan name, validity, and any configured branding.

## Guest flow at the portal

<Steps>
  <Step title="Connect">
    Guest connects to the WiFi SSID. The captive portal opens.
  </Step>

  <Step title="Select Voucher">
    Guest selects **Voucher / Access Code** from the available login options.
  </Step>

  <Step title="Enter code">
    Guest enters the code from their printed voucher or digital delivery.
  </Step>

  <Step title="Validation">
    The platform checks: code exists · plan is active · code not expired · device limit not exceeded · quota not exhausted · session rules are valid.
  </Step>

  <Step title="Access granted">
    If all checks pass, WiFi access is granted through the captive portal flow.
  </Step>
</Steps>

## Tracking code status

The code list shows every generated code with its current state:

| Status        | Meaning                                           |
| ------------- | ------------------------------------------------- |
| **Active**    | Valid — not yet used                              |
| **In use**    | Used at least once and within the validity window |
| **Exhausted** | Device limit or traffic quota reached             |
| **Expired**   | Validity period has passed                        |
| **Revoked**   | Manually deactivated by an admin                  |

**Code list columns:** Code · Plan · Location · Status · First used · Device count · Data used · Expires at · Actions

## Revoking a code

Click the **Revoke** action on any code to immediately deactivate it. A revoked code is rejected at the portal with an invalid code error. This action cannot be undone — if access needs to be restored, generate a new code from the same plan.

## Export formats

| Format    | Contents                                                                                                                             |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Excel** | One row per code — code value, plan, location, status, expiry date. Suitable for mail-merge or bulk distribution.                    |
| **PDF**   | One printable voucher card per code with QR code, branding, and usage instructions. Suitable for printing and physical distribution. |