HandyCafe Docs
owner

Pricing Settings

The Pricing Settings category defines all monetary parameters: rates, minimums, taxes, rounding and session presets. These values determine how sessions are charged and how amounts are displayed.

The page has three tabs. Pricing holds the rates and rules described below. Pricing Plans holds the fixed-duration packages sold to customers, documented in Pricing Plans. Equipment holds the rentable kit handed out with a seat, described in Equipment below.

Currency

The currency is not set on this page. Local Currency Symbol and Currency Code are on General Settings, filled in from the selected country and editable there. HandyCafe uses a single currency. There is no base currency or exchange rate.

Pricing Groups

Pricing groups let different seats bill at different rates, for example Standard and VIP. A PC is assigned to a group on the Registered Clients tab of Settings > Clients. A console is assigned to a group in its add or edit dialog on the Consoles page.

The Standard group always exists and cannot be deleted. Deleting any other group moves the PCs and consoles assigned to it back to Standard. Adding and deleting groups is covered in Pricing Plans.

The Pricing Group combo at the top of the tab scopes the first card: the Computer and Console Hourly rate and Startup Fee, Rounding and Member hourly rate. Bill by started minute, the member minimum options, presets and print and USB pricing are global. VAT and fraction digits sit in the Shared by all groups card.

PC Pricing

  • Computer hourly rate -- The hourly rate for the pricing group currently selected in the group combo.
  • Computer startup fee -- The minimum a PC session can cost, not an extra charge added to the bill. A session that would come to less than this amount is billed this amount instead; a session that costs more is unaffected. Set to 0 to disable.

The minimum applies once per session, when the session is opened. Extending an open session with Add Time is priced on the extension alone. Buying twenty minutes in four five-minute steps therefore costs the same as buying it in one.

Console Pricing

  • Console hourly rate -- The hourly rate for every console in the selected group whose pricing type is Default. A console set to a custom price keeps its own rate but still takes the group's startup fee and rounding.
  • Console startup fee -- The minimum a console session can cost, on the same per-session rule as PCs.

Member Pricing

  • Member hourly rate -- The hourly rate members pay on seats in the selected group. 0 keeps members on the guest rate. A member who carries a session discount stays on the general rate. That way the discount is never taken off an already reduced price.
  • Apply the minimum charge to members -- Off by default, which means member sessions are billed for what they use with no floor. Turn it on to hold a member session to the same startup fee a guest session pays. Sessions running on package time are never held to it.
  • Charge it again after (minutes) -- Shown when the option above is on. The minimum is charged once per member per this window. A station that reboots mid-visit therefore does not charge it twice. 0 charges it on every session.

Time-of-day multipliers for members are set on the Pricing Schedule page with Apply to member sessions.

VAT

Set the VAT percentage applied to charges. The allowed range is 0% to 250%.

VAT is included in the amount, not added to it. The price the customer sees is the gross amount; HandyCafe splits it into a net amount and a VAT amount for reporting. A 100.00 charge at 20% VAT is recorded as 83.33 net plus 16.67 VAT, not 120.00.

Set to 0 to disable VAT.

Rounding

Rounding is a money step, not a number of decimal places. The charged total is rounded up to the next whole multiple of this amount.

  • Rounding 1 -- No effective rounding; every amount is billed as calculated.
  • Rounding 2 -- 15.30 is billed as 16.00, 16.10 as 18.00.
  • Rounding 5 -- 12.40 is billed as 15.00.

Rounding is applied after the session minimum. The charged total therefore always lands on the step even when the minimum does not.

Rounding is always upward (ceiling) to prevent revenue loss from fractional amounts.

Fraction Digits

The number of decimal places used for currency values. The allowed range is 0 to 8.

  • 0 -- Currencies with no subunit in daily use.
  • 2 -- Standard for most currencies (e.g. $1.50).
  • 3 -- Some Middle Eastern currencies (e.g. KWD).

This is not only a display preference. Every amount in HandyCafe is stored as a whole number of minor units. The fraction digits decide what those numbers mean. Changing the setting therefore rescales every stored amount: configured prices, product prices, member balances and past transactions all move together so that nothing changes value. HandyCafe asks for confirmation before doing this.

The rescale is exact or it does not happen. Lowering the digit count divides every stored amount. If any of them would not divide evenly the change is refused and nothing is touched.

Bill by Started Minute

  • Off (default) -- Sessions are billed at second resolution. A 45-minute 12-second session is charged for exactly that time.
  • On -- Every started minute is charged in full. The same session is charged for 46 minutes.

Presets

Presets are the five quick-start buttons a cashier sees when opening a session. Each preset is a single number, not a named package.

  • The switch on the card header turns the preset buttons on or off. The header reads Time Presets or Amount Presets depending on the type.
  • Type -- Duration makes the five Values minutes. Amount makes them amounts of money.

The price of a duration preset is calculated from the hourly rate of the client's pricing group and any applicable pricing-schedule multiplier.

Extra Services Pricing

The Print & USB pricing card holds two options:

  • Charge for printing -- When enabled, sets a Colour page price and a Black & white page price.
  • Charge for USB copying -- When enabled, sets a Price per MB copied to a USB device, plus Round up to (MB) (0 or 1 means charge per megabyte with no extra rounding).

Customer AI Chatbox Pricing

When Offer AI chat to customers is enabled, the operator sets only a Profit margin percent. The customer price is derived at answer time from the real wholesale token cost. The chatbox can therefore never be sold below cost and no currency-specific price has to be maintained.

Equipment

The Equipment tab lists kit handed out with a seat, such as controllers, headsets or racing wheels. Each item says where it may be used, how many the seat price already covers and what an extra one costs. With no items, seats are billed for time alone and the cashier is never asked what went out with them.

Select Add to open the Add equipment dialog:

  • Equipment -- Pick a kind from the list or type your own.
  • Name -- Optional. Two headset models are two items. Leave it empty to go by the kind alone.
  • Where it can be used -- Consoles (all or specific console categories) and Computers (all or specific pricing groups). An item with nowhere to go is never offered on a seat.
  • Free units and Maximum -- How many are included in the seat price and how many a seat can take at most.
  • Charged -- Per hour adds each extra unit to the hourly rate. One-off charges each extra unit once, whatever the session length.
  • Price per hour or Price -- What each extra unit costs.

A Preview line shows the rule in plain words before you save. Deleting an item that seats are holding stops new sessions from renting it out. Sessions already running keep what they were handed.