Hotspot Vouchers & Guest WiFi

ProxRad turns any MikroTik hotspot into a sellable product. You define voucher plans (how long a session lasts, how many days the code stays valid, the price), generate batches of voucher codes, and hand or sell them to guests. For public venues — cafés, hotels, clinics — you can instead run a guest WiFi flow where visitors get online with just their name and a one-time SMS code, no voucher printing required.

Everything is reseller-aware: a reseller only sees and sells their own plans and vouchers, and can design their own captive login page.

How to get here

• Sidebar → Hotspot Vouchers.
• Direct URL: /hotspot-vouchers.

The page is organised into tabs, each gated by its own permission (see Permissions). Resellers see only their own plans, vouchers, and templates.

Voucher plans

A plan is the template a voucher is minted from. Each plan defines:

Field	Meaning
Name	Shown to staff when generating vouchers.
Duration (minutes)	How long a single online session lasts. 0 = unlimited session (stay connected until the validity runs out).
Validity (days)	Days the code remains usable, counted from first login. 0 = duration-only (the voucher dies when its session time is used up).
Data cap	Optional total data allowance for the voucher.
Price	What the voucher sells for. Resellers can be given their own per-plan pricing.

Note

Plan create / edit / delete is admin-only by design — it controls how much time and data you sell. Resellers can list plans (to generate vouchers from them) but cannot change a plan’s duration or price.

Duration vs. validity — a worked example

• “1 hour, 30-day” café voucher → Duration 60, Validity 30. The guest can come back any day within a month; each login gives 60 minutes of connected time.
• “1 day unlimited” hotel voucher → Duration 0, Validity 1. One code, connect once, stay online for the day.

Because the session time is sent to the router as a standard RADIUS Session-Timeout, the hotspot enforces it locally — no dependence on the panel being reachable mid-session.

Generating vouchers

From the Vouchers tab, pick a plan and a quantity, and ProxRad mints a batch of unique code + PIN pairs. Each voucher moves through a simple lifecycle:

Status	Meaning
Unused	Freshly generated, never logged in.
Active	First login has happened; the validity clock is running.
Used	Session time / data exhausted.
Expired	Validity window passed.
Disabled	Manually revoked.

Vouchers can be printed or exported for handout. Every voucher is tied to the reseller who generated it.

Guest WiFi (name + SMS one-time code)

For venues that don’t want to hand out printed codes, switch the captive page to guest mode. The visitor flow is:

1. Guest connects to the WiFi and lands on your captive page.
2. They enter their name and phone number.
3. ProxRad sends a one-time code by SMS (via your configured SMS provider).
4. They enter the code, and they’re online.

Under the hood the verified guest is issued a short-lived voucher automatically, so guest sessions inherit the same time/data controls and reporting as normal vouchers — you simply never printed anything. Captured names and numbers become a marketing list you own.

Tip

Guest mode needs a working SMS provider under Settings → Notifications. The captive page collects only what you configure (typically name + phone).

Login-page designer

Each reseller can design the captive login page guests see, from the Login Page tab:

Option	Effect
Page type	Standard (voucher-code entry) or Guest (name + SMS code).
Title & welcome text	Branding and instructions.
Logo	Your brand mark (kept small so it renders on phones).
Terms	Optional terms-of-use text.
Redirect URL	Where the guest lands after a successful login (e.g. your website).

Saved templates are named and reusable. Hit Apply and pick a router to push the page onto that hotspot. The design is scoped to the reseller who created it — one reseller’s branding never appears on another’s page.

Setting up a hotspot on a router

The Setup tab provisions a hotspot on a chosen MikroTik: it configures the hotspot interface, an address pool for guests, DNS, and points the hotspot’s RADIUS at ProxRad. Once set up, vouchers and guest logins authenticate against ProxRad exactly like PPPoE subscribers do — the hotspot is just another NAS.

Caution

Point the hotspot’s RADIUS at this ProxRad server. A hotspot still aimed at a different RADIUS will reject every voucher.

Permissions

Permission	Grants
hotspot.view	See plans and vouchers (scoped to own, unless hotspot.view_all).
hotspot.create	Generate vouchers.
hotspot.delete	Delete vouchers.
hotspot.plans	Manage voucher plans (admin-only in practice).
hotspot.view_all	See vouchers for all resellers, not just own.
hotspot.setup	Set up / remove hotspots on routers.
hotspot.page	Design and apply the captive login page.

Give a reseller hotspot.view + hotspot.create + hotspot.page to let them sell vouchers and brand their own portal, while keeping plan pricing under your control.