Vouchers
Vouchers give walk-in guests temporary prepaid access without creating a member account. A voucher has a generated username and password, a purchased duration or balance, a price snapshot, a status, sale time, and optional QR data for printing. In earlier versions vouchers were called tickets.
Open the page from Vouchers in the left sidebar.
Plan Availability
HandyCafe Genesis Pro includes individual vouchers, bulk package creation, import and bulk printing. Vouchers and members are not limited.
Voucher Types
| Type | What it sells |
|---|---|
| Time-based | A fixed number of minutes at a frozen price. The pricing schedule on each PC is ignored |
| Balance-based | A prepaid balance that runs through the PC pricing engine, exactly like a prepaid member account. The session length depends on the PC's pricing |
Wi-Fi vouchers are a third kind in the same voucher system. They are created and sold on the Wi-Fi page and are not listed on the Vouchers page. A Wi-Fi voucher is sold to a guest for cash or card. It can also be sold straight onto a member account. Its code is 2 to 6 letters followed by six digits and only counts as stock until it is sold. Wi-Fi sales appear under their own Wi-Fi category in reports. A Wi-Fi voucher can never be used to log in to a PC. See Wi-Fi Vouchers.
Login Rules
Client login checks voucher credentials after admin, cashier, and member credentials. If the username and password match a voucher, HandyCafe applies these rules:
- If the voucher is already online, login is rejected.
- If the voucher has not been sold yet, login is rejected.
- If the voucher is inactive, cancelled, expired, or out of remaining time, login is rejected.
- If the voucher is single-use, the first login starts a 24 hour reuse window. The guest can log in again within that window while time remains. After 24 hours the voucher expires.
- If the voucher has a validity period, it must be used before that period ends. The validity period is calculated from sale time.
- A login session is limited to the remaining purchased time or balance.
The Vouchers Page
Summary cards at the top show vouchers Sold today, Revenue (30d), Active (in use right now), In stock (pending vouchers ready to sell), Used and Expired.
The toolbar below holds:
- A status filter: All, Sold, Pending, Active, Inactive, Used, Expired, Cancelled.
- A date range: All time, Today, Last 7 days, Last 30 days.
- A search field that matches username, ID, package and MAC address.
- A Flat or Grouped view. Grouped collapses each bulk package into one expandable row.
- Refresh and the New button, which offers Single voucher and Bulk package.
Each row has a menu with the actions that fit its status. Select several rows with their checkboxes to Reprint selected, Deactivate selected or Delete selected at once.
Creating a Single Voucher
- Click New and choose Single voucher. The Create walk-in voucher dialog opens.
- Choose the Voucher type: Time-based or Balance-based.
- For a time-based voucher, choose a Pricing plan or select Custom to enter the Duration (minutes) and Price. For a balance-based voucher, enter the Balance.
- Optionally set Expires in (hours). This is how long the voucher can be used after sale. Leave it empty for the default. You enter a duration only, not a fixed expiration date.
- Optionally pick a Target PC and a Username prefix. For example, prefix
TKcreates usernames that start withTK. The password is still generated automatically. - Click Create voucher or Create and print to print the slip right away.
Creating a voucher prepares it in Pending status. A pending voucher is stock. The password is shown only once in the dialog. Copy it or hand over the printed slip before closing. Single vouchers print on the thermal printer only.
Bulk Voucher Packages
Click New and choose Bulk package to create many vouchers with the same settings:
| Field | Meaning |
|---|---|
| Voucher type | Time-based or Balance-based |
| Quantity | How many vouchers to create |
| Duration (minutes) and Price, or Balance per voucher | The value of each voucher |
| Valid for (hours) | How long each voucher can be used after sale |
| Single-use voucher | Applies the single-use login rule |
| QR enabled | Prints a QR code on each slip for quick login |
| Username prefix | Optional prefix for the generated usernames |
| Print mode | Thermal printer (one slip per voucher on the assigned receipt printer), A4 sheet (a grid through the system print dialog, with a Sheet layout of Auto, 2 x 5, 2 x 8 or 3 x 8) or Save only (print later) |
Click Create. Thermal mode needs a voucher printer assigned in Settings > Printers.
Deleting a package deletes all vouchers inside that package. HandyCafe asks for confirmation before this action.
Selling Vouchers
Sell prepared vouchers from the Vouchers page:
- For a single pending voucher, choose Sell voucher from the row menu or in the voucher details.
- For a bulk package, choose Sell next voucher from the package row menu to sell the next pending voucher in that package.
A sale dialog opens with the price. Select the Payment Method, such as cash or card, and confirm. A card method connected to a payment terminal takes the payment on the terminal before the sale is recorded.
When a voucher is sold, HandyCafe activates it, stores the sale time, records a voucher transaction with the chosen payment method and prints the slip if a voucher printer is assigned. The validity period starts at sale time, not at creation time.
Voucher sales appear in reports as voucher transactions. Use the Sold filter to list sold vouchers from both single vouchers and bulk packages. From a package row, Show package vouchers lists the vouchers that belong to that package.
Printing and Reprinting
- Reprint (thermal) prints a voucher slip again.
- Reprint package as A4 sheet opens the Print A4 sheet preview with the sheet layout choice. Choose A4 paper in the system dialog and turn off headers and footers for a clean cut.
- Reprint package on thermal printer prints every voucher of a package on the receipt printer.
Managing Existing Vouchers
Choose View voucher from the row menu to open the voucher details. The dialog has the tabs Details, History and Actions. It shows the credentials (with copy buttons), a slip preview, the sale time, the cashier, the use count and the lifecycle history.
Administrators can activate, deactivate, reprint or delete vouchers. Deactivating a voucher prevents login until it is activated again. Deleting a voucher removes it from the list and cannot be undone.
Voucher duration and balance are fixed after creation. Create a new voucher if the customer needs a different value.