Find the insights and best practices about our product.
Configure Tax & Service Charge


Overview

The Taxes and Additional Fees configuration allows you to define how taxes and extra charges (e.g., service charge, packaging fee) are applied to customer orders.


Proper setup ensures:


  • Accurate billing calculations
  • Compliance with local tax regulations
  • Transparent pricing for customers
  • Consistent fee application across branches



This configuration is managed at the store level and affects order totals on POS and customer-facing channels.


When to Use



Configure taxes and fees when:


  • Setting up your system for the first time
  • Operating in regions with mandatory tax requirements
  • Applying service charges (e.g., 10% service fee)
  • Charging handling or packaging fees for takeout orders
  • Managing different tax rates across outlets



You can set up Tax and Service Charge by navigate to Settings -> Additional Fee on Portal and the option is also available on POS by selecting Additional Fee after expanding the menu icon.



Adding Taxes or Fees to Your Stores

When accessing the Additional Fee list for the first time, it will be empty.


To add a new tax or fee on Portal:

  1. Click Add Fee in the top-right corner.
  2. You will be redirected to the Add Additional Fee configuration page.
  3. Select the Additional Type:
    • Tax
    • Other Fee




Adding a Tax

Portal

Step 1: Select Tax Type


Under Additional Type, select Tax.


You must then choose the Tax Type:



Exclusive Tax

  • The item price configured in the Menu is before tax.
  • The system calculates tax separately based on the configured rate.
  • Tax is added during checkout.


Example:

Item price: $10

Tax rate: 10%

Final price: $11



Inclusive Tax

  • The item price configured in the Menu already includes tax.
  • The system calculates the tax portion internally.


Example:

Displayed price: $11

Tax rate: 10%

Pre-tax price: $10



Recommendation

For clearer pricing transparency, Exclusive is generally recommended, especially where tax breakdown must be shown separately.




Step 2: Name Your Tax

Enter a descriptive name for the tax.


This is especially useful if:

  • Different stores use different tax rates
  • You operate in multiple regions
  • You apply different tax rules (e.g., Dine-in vs Takeaway)



Recommended naming format:


  • Store name + Tax rate + Scenario
    Example: SG_7%_GST_DineIn



Clear naming improves long-term manageability.




Step 3: Set the Tax Rate



Currently, tax is configured as a percentage.


Enter the numeric value in the Rate field.


Example:


  • Entering 10 = 10% tax rate





Step 4: Assign Stores (Portal Only)

You will see a list of all configured stores.


By default:

  • All stores are enabled.



If different stores require different tax rates:

  1. Deselect the stores that should not use this rate.
  2. Create a separate tax configuration for those stores.



NOTE If you configure this setting from the POS, you will not see the Store option. The configuration will only apply to the store associated with that POS.


Adding Other Fees

If you select Other Fee under Additional Type, you can configure service charges or additional fees.


Naming the Fee

Enter a clear name (e.g., Service Charge, Packaging Fee).


Use descriptive naming to differentiate fee types across branches.


Service Type

Select which fulfillment methods trigger this fee. You can select one or multiple:

  • Dine-in
  • Takeaway
  • Manual Delivery

Fee Rate Configuration

You can choose between:

Percentage

  • Applied as a percentage of the order total.
  • Example: 10% service charge.



Fixed Amount

  • Applied as a fixed monetary amount per order.
  • The currency is based on your systemโ€™s configured currency during onboarding.
  • Example: SGD 2.00 packaging fee.



Enter the corresponding numeric value in the Rate field.




Assigning Stores (Portal only)

As with tax:

  • All stores are selected by default.
  • You may deselect stores if the fee does not apply to them.
  • If different branches use different fee rules, create separate fee configurations.


NOTE If you configure this setting from the POS, you will not see the Store option. The configuration will only apply to the store associated with that POS.



How Tax and Fees Affect Orders



Taxes and fees are applied during checkout and will:


  • Appear on order details
  • Be included in final payment calculations
  • Be reflected in Analytics



Behavior may vary depending on Exclusive vs Inclusive configuration.




Limitations & Considerations

  • Tax configuration is percentage-based only.
  • Fixed fee currency follows system-level configuration.
  • Multiple taxes or fees may stack if applied simultaneously.
  • Changing tax rules will affect future transactions only.
  • Ensure compliance with local tax regulations before configuration.
  • Store-level assignment must be carefully reviewed in multi-branch setups.
  • POS Version: 2.49.0 or above
  • KSK (Kiosk) Version: 1.28.0 or above
  • Legacy Support: Versions older than those listed above only support service fees for Dine-in.





Best Practices

  • Use clear naming conventions for multi-store environments.
  • Standardize tax structure across branches when possible.
  • Test Exclusive vs Inclusive behavior before going live.
  • Separate service charge and government tax clearly.
  • Review tax settings during onboarding and regulatory updates.
  • Double-check store selection when managing regional differences.




Did this answer your question?