WitRADIUSWitRADIUS
Back to guide

Distributor — Complete Guide

Operate under a Network Admin's umbrella. Generate voucher batches, manage your retail customer base, customize the splash screen, and track sales — all without touching infrastructure or billing.

1. What a Distributor does

A Distributor is a reseller who operates inside a Network Admin's account. Your parent admin owns the infrastructure (servers, hotspots, hardware) — you focus on the commercial side: defining what you sell, generating voucher batches, printing them, and managing the end customers who use them.

A typical real-world arrangement: your local internet café chain owner is the Admin. They flash the routers, configure the hotspots, and pay the monthly subscription. They onboard you as a Distributor so you can run the day-to-day voucher business — printing batches at scale, voiding bad codes, helping customers who lost their card, and reporting back on sales.

Your scope vs your parent Admin's scope

You (Distributor)Parent Admin
Add or remove hotspots
Configure server / RADIUS❌ (read-only too — controlled by platform)
Bill / pay subscription
Create login page templates
Create voucher profiles
Generate voucher batches
Print vouchers
Manage WiFi users
View sessions & statistics
Onboard sub-admins
Buy hardware from the store
Access billing / wallet

If you ever need an action from the second column, ask your parent admin — the platform won't even show those menus to you.

How you got here

Your parent admin created your account from their Admins screen. They sent you a login email with a temporary password. After your first login, change your password from the Account menu (top-right corner).


2. Dashboard

Your landing screen. Same overview your admin sees, but scoped to the data you generated or are responsible for.

What you see

  • Active sessions across the hotspots you're permitted to see
  • Today's revenue from voucher sales attributed to your batches
  • Top batches by burn rate — which products are selling fastest
  • Top users by data consumption — useful for spotting heavy users
  • System status — green/amber/red for the controller and RADIUS

The dashboard auto-refreshes every few seconds. Use the date-range picker (top-right) to look back over the day, week, or month.


3. Hotspots (view-only)

You can see the hotspots you're allowed to operate on, but you cannot create, edit, or delete them. That's the parent admin's job.

What the list shows

  • Name — the friendly name your admin gave it (e.g. "Lobby AP")
  • NAS IP — internal identifier (you usually don't need this)
  • Status — online / offline / never seen
  • Last seen — useful when a customer reports "WiFi was down yesterday"
  • Active sessions now / Sessions today

What you can do

  • Open a hotspot to see its live sessions, history, and usage charts
  • Filter by hotspot in Batches, Users, and Sessions screens
  • Use the Map view (top of Hotspots screen) for a geographic overview if your admin has set GPS coordinates

What you cannot do

If a hotspot needs reconfiguration, a router needs to be flashed, or a new location needs to be added — message your parent admin. You don't have the buttons, and trying to call those endpoints directly returns 403.


4. Login Pages

The login page is the splash screen WiFi users see when they first connect. As a distributor you can create new templates and edit existing ones — but deletion is reserved for the admin.

What you can customize

  • Logo — upload PNG/JPG (max 1 MB)
  • Brand colors — primary and accent
  • Welcome message — bilingual (EN + AR fields)
  • Login methods — toggle voucher / username+password / social / free-with-ad
  • Terms of service — paste your text or upload a PDF
  • Walled garden — domains a user can reach before logging in (your menu site, payment gateway, font CDNs)

Live preview

The right panel shows what users will see — desktop, tablet, and mobile sizes update as you edit. Click Save to commit. Active sessions are not affected; only new sessions get the new look.

Removing an old template

If a template is no longer needed, ask your parent admin to delete it. From your account it will appear in the list but the row's delete button will be hidden.


5. Profiles

A profile is a "WiFi product" — it defines what each voucher (or user) gets: time, data, speed, concurrent sessions, and validity window.

You have full control over profiles: create, rename, edit, and delete. Most distributors maintain a tight catalog of 4-8 well-named products that map directly to their price list.

Profile fields

  • Name — keep it customer-friendly: "1 hour, 500 MB", "Daily unlimited", "Monthly 10 GB"
  • Time quota — total minutes (60 = 1 hr, 1440 = 24 hr, 0 = unlimited)
  • Data quota — total bytes up + down (524288000 = 500 MB, 0 = unlimited)
  • Speed limits — download / upload kbps (0 = no limit)
  • Concurrent sessions — usually 1 (one device per code) or 2-3 for family/group cards
  • Validity window — how long after first use the voucher remains valid (e.g. 24 hours means the user has 24 hours to consume their quota once they first connect)
  • Idle timeout — auto-logout after N minutes of inactivity. Default 10
  • Monthly recurring — enable for prepaid users where the quota resets monthly

Tips

  • Clone an existing profile when creating a similar one — saves time and keeps naming consistent
  • Profiles are shared with your parent admin and other distributors under the same admin. Coordinate names so you don't end up with three slightly different "1 Hour" products
  • Once a profile is used by an active voucher, deleting it can break those vouchers' authentications. Mark it inactive instead, or wait until all vouchers using it have expired

6. Batches (vouchers)

This is your daily workshop. A batch is a group of voucher codes generated together for the same profile and (optionally) the same hotspot.

Creating a batch

  1. Click Add batch
  2. Pick a profile — this determines time/data/speed
  3. Pick the hotspot(s) the codes are valid at (default: all hotspots in your scope)
  4. Set quantity — how many codes to generate
  5. Optionally set expiry — when unused codes auto-expire
  6. Optionally add a batch name ("March-2026 first run") for tracking
  7. Choose a printing template
  8. Click Generate. Codes are created instantly. Click Print to download a print-ready PDF

Editing an existing batch

You can rename a batch and adjust its expiry / batch-name metadata after creation. You cannot delete a batch — that's reserved for the parent admin. If you generated a batch by mistake, ask the admin to delete it.

Selling vouchers

Hand the printed cards to your cashier or sub-resellers. Customers pay, scratch the silver foil, enter the code on the captive portal, and start using WiFi.

Tracking sales

The batch list view shows: total codes, used codes, remaining codes, total revenue (qty × price × sold), and "burn rate" — average codes used per day. Use burn rate to predict when you'll need to print more.

Voiding & refunds

Open a batch → click any voucher row → Void to invalidate an unused code. If a customer already used it but had a problem, Refund credits their wallet (when applicable).

Exports

Every batch has Export PDF (the printable cards again) and Export CSV (raw codes + status, useful for accounting or for handing to a sub-reseller).


7. Printing Templates

Customize the look of your printed voucher cards.

Built-in templates

  • Compact — 12 cards per A4 page, minimal design
  • Premium — 6 cards per A4 with gradient background and your logo prominent
  • Receipt-roll — single-column for thermal receipt printers (80 mm width)

Creating your own

Click Add template:

  • Set page size (A4, A5, receipt roll)
  • Set cards-per-page
  • Upload background image and logo
  • Choose font (Cairo for Arabic, Inter for English; auto-switches based on locale)
  • Drag-and-drop the code, expiry, and instructions text blocks
  • Save → preview → use in any batch

Editing existing templates

You can edit any template you (or your admin) created. Deletion is reserved for the parent admin — ask them when a template is no longer needed.

Print quality tips

Use a 600 dpi printer, scratch-off stickers (sold in stationery shops), and laminate the front for durability. Receipt-roll templates work well with mobile Bluetooth thermal printers for field sales.


8. WiFi Users

Anyone who has ever authenticated at a hotspot in your scope appears here, voucher-based or registered.

List view columns

  • Username — the voucher code or registered username
  • Profile — the WiFi product they're on
  • MAC address — auto-detected on first connection
  • Status — Active / Expired / Disabled / Wallet
  • Total used — bytes consumed
  • Last seen — last successful auth

Per-user actions

You have full CRUD on users. Open any user to:

  • View their full session history
  • Disable them (cannot log in until re-enabled)
  • Reset accounting (clear their data counter — useful for monthly users in edge cases)
  • Delete a specific session (force-disconnect a stuck session without disabling the account)
  • Top up their wallet (for prepaid recurring users)
  • Add a note (free text — visible to your parent admin too)
  • Delete the user entirely (irreversible — only for cleanup of test accounts)

Filters

By status, profile, hotspot, or date range. Export to CSV for accounting or audit.


9. Sessions

Every successful authentication produces a session record — even a 30-second one.

Columns

  • Username / Hotspot / Started / Stopped / Duration / Bytes in/out
  • Terminate cause — why it ended (idle-timeout, user-logout, NAS-reboot, session-timeout, admin-reset)
  • MAC / IP — for forensics

Use cases

  • Customer dispute — "I only used 1 hour but you charged me 3" → look up their MAC, see actual session times
  • Heavy user — click through to their record, maybe upsell a higher-tier voucher
  • Hotspot complaint — filter to that hotspot, look for unusual termination causes

Distributors do not see the Auth Logs screen (failed authentication attempts). If a customer reports "my code doesn't work" and there's no session, ask your parent admin to check the auth log for the rejection reason.


10. Statistics

Aggregated reporting scoped to your data. Pick a date range (today, week, month, custom) and a grouping (hotspot, profile, day) and the page builds:

  • A line chart of sessions / bandwidth / revenue over time
  • A bar chart of top entities by your chosen metric
  • A pivot table of the raw numbers (downloadable as CSV / Excel)

Send this to your accountant — or to your parent admin during your monthly catch-up.


11. Tips & best practice

  • You're a reseller, not the operator. When in doubt about hardware, billing, or hotspot setup — ask your parent admin. Don't waste hours hunting for a button that isn't there
  • Coordinate profile naming with your admin and other distributors. Three slightly different "1 Hour" profiles is a recipe for sales chaos
  • Use named batches ("March-2026 first run", "Reseller Ahmed Q1") — future you will thank you when you need to know which print run a code came from
  • Walled garden = your menu page. Customers who haven't paid yet should still be able to reach your menu, social pages, and the payment gateway. Add those domains to the walled garden when you build a login page
  • Test in incognito. Saved browser logins mask captive-portal issues. Always test new templates and profiles in a private/incognito window
  • Watch the dashboard after launching a new product. Profile bugs (wrong quota, wrong speed) show up within minutes — usually as an immediate spike or drop in burn rate
  • Customer can't log in? Check (1) is the hotspot online? (2) is the voucher code spelled correctly? (3) is the batch's expiry past? If all three pass, escalate to your admin so they can pull the auth log
  • Lost or damaged card? Look up the batch → find the code → print the customer a slip with the code typed on it (no need to re-issue from a fresh batch)

Stuck on anything beyond your scope? Coordinate with your parent admin — and if both of you need help, email [email protected].