Hotel360 Hotel360User Guide

Guest Wi-Fi (Hotspot)

Introduction

Guest Wi-Fi lets you give paying customers a time-limited Wi-Fi code. The cashier issues the code from a bill and it prints on the bill printer. How long the code lasts depends on how much the customer spent. Owners and managers set up the router and the prices. Cashiers only issue codes.

Open Office > Hotspot. You need the Open Guest Wi-Fi permission and a plan that includes the hotspot. The menu item appears only after Wi-Fi vouchers have been switched on (see below). Changing settings and issuing codes on other people's bills needs Manage Wi-Fi settings and vouchers. Revoking a code needs Revoke a Wi-Fi voucher.

The page has three tabs: Configuration, Pricing and Voucher History.

Note

The system is built for a MikroTik router. Router setup is done once, usually with help from the Hotel360 team.

Switching Guest Wi-Fi On

  1. Open Office > Administration and the Settings tab.
  2. In the Guest Wi-Fi Hotspot card, turn on Enable Wi-Fi Vouchers. This switch is disabled unless you have the Manage Wi-Fi settings and vouchers permission.
  3. The Hotspot link now appears in the side menu. You may need to refresh the page. A Configure router & pricing button opens it.

Vouchers can be issued only when the switch is on and the router host, username and password are saved.

Setting Up the Router

All of this is on the Configuration tab. The fields are greyed out for users without the manage permission.

Auto-configure the Router

The Router Setup card configures a MikroTik router for guest Wi-Fi for you.

  1. Enter the Router IP (it starts as 192.168.88.1).
  2. Enter the Router admin password.
  3. Check the Guest Wi-Fi name (SSID). A name is suggested for you.
  4. Click Auto-configure router.

The card shows "Setting up router..." for about 10 to 15 seconds. The router must be on the same network as the Hotel360 print agent, because the agent does the work. When it ends you see Router configured, with the guest Wi-Fi name and, if one was created, an Admin Wi-Fi name and password for POS machines and the print agent. If it fails you see Setup failed with the reason. Open Setup log to see each step. Use Cancel to stop a setup that is stuck, or Reconfigure router to run it again.

Router Credentials

These are used to create the guest users on the router.

  • Host / IP and API Port (8728 is the usual one)
  • API Username and API Password
  • Default Hotspot Profile (starts as "default")

A saved password shows as dots. Click Replace password to type a new one. Click Save configuration when you are done. You see "Hotspot configuration updated."

Remote Access

The Remote access card connects the router to the Hotel360 server over a secure tunnel. With it, the server can create codes even when the on-site print agent is off.

  1. Save the router credentials first. Otherwise you see "Router not configured".
  2. Click Enable remote access. You see "Remote access requested" and the badge reads Configuring….
  3. After a short while the badge changes to Connected. Click Refresh status to check. If it says Failed, the reason is shown. Click Retry or Remove.

Disable removes the tunnel from the server.

Testing with a Test Voucher

Click Issue test voucher to create a 1-minute code without a bill. With remote access on, you see "Test voucher created" with the username and password. Connect a phone to the guest Wi-Fi and try it. Without remote access, you see "Test voucher queued" and the code appears in Voucher History after the print agent picks it up. If the router refuses it you see "Test voucher failed" with the reason.

Pricing Tiers

Tiers decide how long a code lasts, based on the bill total. Open the Pricing tab.

  1. Click Add tier.
  2. Fill in Name (for example "1 Hour"), Amount (Ksh), Minutes (1 to 43,200) and Router profile.
  3. Leave Active on and click Save tier. You see "Pricing tier saved."

The table shows Name, Amount, Duration (as minutes, hours or days), Profile and Status. Use ⋯ > Edit, Deactivate or Activate, or Delete ("Delete this pricing tier?").

How a bill's tier is chosen:

  • The bill total must reach the tier's Amount. The highest tier the bill qualifies for wins. A bill of Ksh 800 with tiers at 100, 500 and 1,000 gets the 500 tier.
  • If you have active tiers and the bill is below the lowest one, no code can be issued.
  • If you have no active tiers, built-in defaults apply: Ksh 100 to 500 gives 2 hours, Ksh 501 to 1,000 gives 6 hours, and Ksh 1,001 or more gives 24 hours.

Issuing a Wi-Fi Code from a Bill

Codes are issued on request. They are never created automatically.

  1. Open POS > Bills and find the bill.
  2. Click ⋯ > Issue Wi-Fi voucher on the bill's row.
  3. The code prints on your bill printer. You see "Wi-Fi voucher issued for Bill #1234".

The action only shows when all of these are true:

  • You have the Issue a Wi-Fi voucher on a bill permission.
  • The bill was made in the last 12 hours.
  • The bill total reaches a pricing tier.
  • No working code has been issued on this bill yet. A bill can have only one code at a time.
  • It is your own bill. Issuing on other people's bills needs the Manage Wi-Fi settings and vouchers permission.

If the action is missing, one of these is not met. If you click it and see "Wi-Fi voucher unavailable for this bill — already issued, too old, or the amount is below the minimum.", the same applies. If you see "No bill printer for computer '...'. Configure in Print Management.", the computer you are using has no bill printer set up; see Printers and Print Management.

The code is also the password, so the guest types the same word twice. The guest connects to the guest Wi-Fi and enters the code on the sign-in (captive portal) page.

Note

The time on the code runs on the router, from when the guest uses it. The guest can use the minutes whenever they connect, until the code is removed.

Voucher History

Open the Voucher History tab to see every code. It shows the last 30 days at first. Change From and To to look further back, and use Status to filter.

Columns: Issued, Username, Password, Duration, Status and Bill (the bill number, or a dash for a test code).

Status Meaning
Pending Created and waiting to be set up on the router.
Ready Working on the router.
Failed The router rejected it. See below.
Revoked Cancelled by staff.
Expired Its time window has passed.

Use ⋯ > Copy credentials to copy "username / password", for example to send it to a guest. Use ⋯ > Revoke to cancel a code: "Revoke this voucher? The guest will lose Wi-Fi access." You see "Voucher revoked. The hotspot user is removed from the router (over the tunnel, or by the agent)." Revoke needs its own permission.

When a Code Does Not Work

Go through these in order.

  1. Check the status in Voucher History. Find the bill number.
    • Ready: the code should work. Check the guest is on the guest Wi-Fi, not the staff network, and typed the code exactly as printed.
    • Pending: the router has not set it up yet. Wait about 10 seconds and refresh. If it stays Pending, the print agent or the tunnel is not working. Ask the person who manages the router to check.
    • Failed: the router refused it. Issue it again from the bill (see below).
    • Revoked or Expired: the code was cancelled or its window closed. Issue a new one if the bill is still eligible.
  2. Issue it again for a Failed code. A failed code does not block you. Issue Wi-Fi voucher shows again on the bill. The old code is replaced by a new one, so the guest must use the new printout.
  3. "Wi-Fi voucher could not be activated on the router". Nothing was printed. The message gives the reason, such as "Router unreachable over the tunnel and no on-site agent is online." Check that the router and the print agent computer are on, and that Remote access shows Connected. Then try again.
  4. Bill too old. After 12 hours Issue Wi-Fi voucher disappears from the bill, for everyone. If the bill is older, ask your manager what to do. Hotel360 has no way to issue a code on it.
  5. Router settings. If nothing works for anyone, a manager should check the Configuration tab, click Issue test voucher, and read the result.