HandyCafe Docs
owner

How to Configure Pricing

This guide covers every pricing feature in HandyCafe. You will learn how to set base rates, configure tax, create quick-select presets, and build a time-based pricing schedule with multipliers for peak and off-peak hours.

What You Will Need

  • Admin access to the HandyCafe Server.
  • Your desired hourly rate, currency, and applicable tax rate decided in advance.
  • A plan for peak and off-peak hours if you want variable pricing (optional).

How to Set Your Base Hourly Rate

The base hourly rate is the default price per hour applied to all postpaid sessions and used as the foundation for prepaid calculations. Rates are set per pricing group. Every PC and console without a group uses the Standard group.

  1. Open the HandyCafe Server application.
  2. Open Settings, then Pricing. The Pricing tab opens first.
  3. Leave Standard selected in the Pricing Group combo. To price another group, pick it instead.
  4. In the Computer row, enter your price per hour under Hourly rate. For example, enter 10.00 for ten units per hour.
  5. Set the Console row the same way if you rent out consoles.
  6. Click Save at the bottom of the page.

Expected result: All new sessions in that group use this rate. Sessions already in progress pick it up only for new pricing segments.

Tip: The currency symbol is not set here. It lives on General Settings as Local Currency Symbol.

To charge VIP seats more, add a group with the + button next to the combo and give it its own rates. See Pricing Plans for adding groups and Registered Clients for assigning PCs to them.


How to Configure VAT

VAT (Value Added Tax) is included in the price, not added on top of it. The price the customer sees is the gross amount. HandyCafe splits it into a net amount and a VAT amount for reporting.

  1. Navigate to Settings > Pricing.
  2. In the Shared by all groups card, locate the Vat % field.
  3. Enter the percentage as a whole number between 0 and 250. For example, enter 18 for 18% VAT.
  4. Click Save.

Expected result: Charges are not raised. A 100.00 charge at 20% VAT is recorded as 83.33 net plus 16.67 VAT. The rate applies to every pricing group.

Note: Setting VAT to 0 disables VAT completely.


How to Set a Startup Fee

The startup fee is a minimum charge applied to every guest session regardless of duration. If a session's computed cost is less than the startup fee, the customer is charged the startup fee instead.

  1. Navigate to Settings > Pricing.
  2. Pick the pricing group in the Pricing Group combo.
  3. Enter the minimum charge under Startup Fee in the Computer row (and the Console row if needed). For example, enter 2.00 to ensure every session costs at least 2.00.
  4. Click Save.

Expected result: When a session is stopped, the system compares the computed cost against the startup fee. If the computed cost is lower, the startup fee is charged. The fee applies once per session and is not charged again when time is added.

Tip: Set the startup fee to 0 if you do not want a minimum charge. Very short sessions (e.g., 1-2 minutes) will then be billed at the prorated hourly rate.

Member sessions are not held to the startup fee by default. Turn on Apply the minimum charge to members on the same card if members should pay it too.


How to Create Pricing Presets

Pricing presets are the five quick-select buttons that appear when starting a session. Each preset is a single number, not a named package.

  1. Navigate to Settings > Pricing.
  2. Find the presets card. Its header reads Time Presets or Amount Presets.
  3. Turn on the switch in the card header.
  4. Under Type, choose Duration to make the presets minutes. Choose Amount to make them amounts of money.
  5. Fill the five Values. Common duration values are 30, 60, 120, 180 and 300.
  6. Click Save.

Expected result: The session start dialog shows the five values as buttons. A duration preset is priced from the hourly rate of the PC's pricing group and any active schedule multiplier.

Tip: For named, flat-price packages such as "Night Rate", use the Pricing Plans tab instead. See Pricing Plans.


How to Set Up Peak and Off-Peak Pricing

The pricing schedule lets you define time-based multipliers. A multiplier of 1.5x during peak hours means customers pay 50% more per hour. A multiplier of 0.7x during off-peak hours means they pay 30% less.

HandyCafe has 8 fixed color slots (blue, orange, red, green, teal, gray, cyan and emerald). You do not add slots. You give a slot a name and a multiplier, then paint its hours on a weekly grid.

Step-by-Step: Configure a Peak Hours Slot

  1. Open Settings, then Pricing Schedule.
  2. Turn on Enable pricing schedule if it is not already on.
  3. In the Pricing Schedule Settings box below the grid, find the red slot's row.
  4. Type "Peak" in its name field.
  5. Set Multiplier to 1.5. The Net Price next to it shows the hourly rate this produces.

Step-by-Step: Configure an Off-Peak Slot

  1. In the green slot's row, type "Off-Peak" as the name.
  2. Set Multiplier to 0.7.

Step-by-Step: Paint the Weekly Grid

  1. The grid has a column for each day of the week, starting on Monday, and a row for each hour (00 to 23).
  2. Click the red color in the color selector above the grid to make it the active brush.
  3. Click and drag down the evening hours (18:00 to 23:00) in the Monday through Friday columns. The painted cells turn red.
  4. Click the green color in the selector.
  5. Click and drag down the morning hours (06:00 to 12:00) in the weekday columns.
  6. Leave unpainted hours at the default rate (1.0x multiplier).
  7. Click Save to apply the schedule.

Expected result: The weekly grid shows colored blocks for peak and off-peak hours. Default hours remain uncolored. The schedule takes effect immediately for new sessions and for new pricing segments of sessions already in progress.

By default the schedule prices guest PC sessions only. To include members, turn on Apply to member sessions and, if members should get a different rate, fill in the Member multiplier column. See Pricing Schedule Settings.

Pricing Calculation Example

Suppose your base hourly rate is $10.00 and a customer plays from 5:00 PM to 7:00 PM on a Wednesday.

  • 5:00 PM to 6:00 PM (1 hour): Default slot at 1.0x multiplier. Cost = $10.00 x 1.0 = $10.00.
  • 6:00 PM to 7:00 PM (1 hour): Peak slot at 1.5x multiplier. Cost = $10.00 x 1.5 = $15.00.
  • Total charged: $25.00.
  • If VAT is 18%, the $25.00 already includes it: $21.19 net plus $3.81 VAT.

The cost breakdown dialog will show both pricing segments separately so the cashier and customer can see exactly how the charge was calculated.

Note: HandyCafe creates a new pricing segment every time the active slot changes. Sessions that span midnight will also create a new segment at the day boundary if the schedule differs between days.


Common Mistakes to Avoid

  • Forgetting to enable the pricing schedule. Creating slots and painting the grid does nothing if the schedule toggle is off. Always verify the toggle is enabled.
  • Setting a multiplier of 0. A zero multiplier means that time slot is free. This is almost never intentional. The minimum practical multiplier is 0.1.
  • Overlapping the same hour with two slots. Each hour cell can only belong to one slot. Painting over a cell replaces the previous slot assignment.
  • Not saving after changes. Changes to slots, rates or the grid do not take effect until you click Save. If you navigate away without saving, all changes are lost.
  • Confusing the startup fee with a fixed session price. The startup fee is a minimum threshold. If the computed session cost exceeds the startup fee, the customer pays the higher computed cost.
  • Changing the hourly rate mid-day without understanding the impact. Active sessions will pick up the new rate only for new pricing segments. Already-calculated segments retain the rate that was active when they were created.