Black Friday
Skip to documentation content

Pricing, Payments & Tax

Understand tax concepts and the booking total

Core owns the final calculation and saved financial snapshot. Free supplies one room percentage rule; entitled Pro can add advanced prices, room coupons, services and multiple tax rules without making browser-supplied totals authoritative.

Core owns the final calculation and saved financial snapshot. Free supplies one room percentage rule; entitled Pro can add advanced prices, room coupons, services and multiple tax rules without making browser-supplied totals authoritative.

Calculation order

  1. Calculate the room subtotal from the applicable nightly prices and room quantity.
  2. Deduct the eligible coupon discount from room charges only.
  3. Add selected service charges using their defined units.
  4. Evaluate eligible taxes on discounted room charges, services or both.
  5. Add exclusive tax lines to obtain the grand total; disclose included tax without adding it again.
Example with exclusive 10% room tax Amount
Room subtotal 300.00
Room coupon -30.00
Services 120.00
Tax on discounted room basis of 270.00 27.00
Grand total 417.00

If that 10% rule instead covers room plus services, its basis is 390.00, tax is 39.00 and total is 429.00. The example assumes no other rules. Service scope requires Pro.

Inclusive, fixed and multiple rules

Exclusive percentage tax is basis × rate / 100. Included percentage tax is basis × rate / (100 + rate): 110.00 including 10% contains 10.00 tax and stays 110.00. Fixed booking/night/guest-night taxes are exclusive only.

Rules are non-compound: one tax is not added to another’s basis. Each tax line rounds to two decimals before aggregation. Fixed guest/night units use guests × occupied nights; room quantity is not an extra fixed-tax multiplier. Priority orders rules rather than enabling tax-on-tax behavior.

Display preference, entered-price mode and saved financial history are separate concepts. A different catalogue label does not authorize recalculating an existing reservation.

Quote and snapshot boundaries

Book Now checks a server quote before the native POST. Changed selections or totals require explicit review. Final submission rechecks availability, pricing and the quote; it can still reject later changes safely.

Successful creation saves room, discount, service, tax and nightly financial records. Receipts and collection read those amounts rather than live rules. Room photos/names may use current presentation and are not the same snapshot guarantee.

An active required provider that is unavailable causes calculation to fail closed; a partial tax total is not accepted as a safe fallback. See tax mismatch diagnosis.

Was this article helpful?

Your feedback helps us improve the documentation.