HandyCafe Docs
owner cashier

Tickets

Tickets give walk-in guests temporary prepaid access without creating a member account. A ticket has a generated username and password, a purchased duration, a price snapshot, a status, sale time, and optional QR data for printing.

Login Rules

Client login checks ticket credentials after admin, cashier, and member credentials. If the username and password match a ticket, HandyCafe applies these rules:

  • If the ticket is already online, login is rejected.
  • If the ticket has not been sold yet, login is rejected.
  • If the ticket is inactive, cancelled, expired, or out of remaining time, login is rejected.
  • If the ticket 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 ticket expires.
  • If the ticket 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.

Creating Tickets

Open Tickets and click Create ticket. Choose a pricing plan or select Custom to enter the duration and price. The optional Valid for (hours) field sets how long the ticket can be used after sale. You enter a duration only. You do not enter a fixed expiration date.

Creating a ticket prepares it in Pending status. A pending ticket is stock. HandyCafe keeps its generated credentials encrypted and does not hand out a usable slip until the cashier sells it.

Use Username prefix when the cafe wants a recognizable username format. For example, prefix TK creates ticket usernames that start with TK. The password is still generated automatically.

Selling Tickets

Sell prepared tickets from the Tickets page:

  • For a single pending ticket, click Sell on that ticket row.
  • For a bulk package, click Sell next ticket on the package row to sell the next pending ticket in that package.

When a ticket is sold, HandyCafe activates the ticket, stores the sale time, records a transaction with transaction type ticket, and prints the ticket slip if a ticket receipt printer is assigned. The validity period starts at sale time, not at creation time.

Ticket sales appear in reports as ticket transactions.

After a sale, the Tickets page shows the last sold ticket with its username, status, sale time, ticket ID, and package ID when applicable. Use Show sold ticket to jump back to that row.

Use the Sold filter in Single Tickets to list sold tickets from both single tickets and bulk packages. On the Bulk Ticket tab, use Show package tickets to open all tickets that belong to a package. This makes it clear which prepared ticket was sold from the package.

Bulk Ticket Packages

Use Bulk Ticket to create a package of many tickets with the same duration, price, validity period, policy, and optional username prefix. Packages are useful when the cashier wants a prepared stack of walk-in tickets.

Deleting a package deletes all tickets inside that package. HandyCafe asks for confirmation before this action.

Managing Existing Tickets

Administrators can activate, deactivate, reprint, or delete tickets from the Tickets page. Use Sold to find sold tickets quickly. Use Show package tickets from a bulk package to manage a specific ticket inside that package. Deactivating a ticket prevents login until it is activated again. Deleting a ticket removes it from the ticket list and cannot be undone.

Ticket duration is fixed after creation. Create a new ticket if the customer needs a different duration.