Order Fees

The Order Fees page is where you create, edit, and manage the fees that can be applied to orders. Open Order Fees from the app sidebar.

List view

Fees are shown in a table with:

• Name – The fee name (and optional description if set).
• Code – The fee code used for reference and API calls.
• Amount – The fee amount and type (e.g. $5.00 or 2.5%).
• Status – A switch to enable or disable the fee without deleting it.
• Actions – Edit and Delete.

Use the switch to turn a fee on or off. Use Edit to change its settings and use Delete to remove it (you will be asked to confirm).

If no fees exist, you’ll see an empty state with Create First Fee (or Create New Fee in the header).

Creating a new fee

Click Create New Fee. A modal opens with one form in three sections: basic settings, conditions, and calculation/advanced. Fill in the required fields and click Create Fee.

Basic settings

Fee Status

Switch to enable or disable the fee. Disabled fees are not calculated at checkout. You can leave a new fee disabled until you’re ready to turn it on.

Fee Name *

The label shown next to the fee amount at checkout (e.g. “Processing Fee”). Required.

Fee Code *

A unique code for this fee (e.g. PROCESSING_FEE). Used for internal reference and API calls. Required. It can be auto-generated from the fee name; you can edit it. Allowed characters: letters, numbers, hyphens, underscores. Minimum 2 characters.

Amount *

The numeric value used for the fee. Meaning depends on Calculation Method:

• Fixed Amount – The flat fee per order (e.g. 5.00 = $5).
• Percentage of Cart – The percentage (e.g. 2.5 = 2.5%).
• Per Item – The amount per item (e.g. 1.00 = $1 per item).
• Base Amount + Percentage (Compound) – The fixed base (e.g. 2.00). You also set Additional Percentage in the next field.

Additional Percentage * (Compound only)

Only shown when Calculation Method is Base Amount + Percentage. Enter the percentage added on top of the base (e.g. 1.5 for 1.5%).

Calculation Method *

How the fee is calculated:

• Fixed Amount – A flat fee per order.
• Percentage of Cart – A percentage of the cart (see Percentage Calculation Basis).
• Per Item – Amount × total quantity of items in the cart.
• Base Amount + Percentage – A base amount plus a percentage of the cart.

Priority

Number that controls the order in which fees are applied. Higher priority fees are applied first. Default is 0. Use different priorities when you have multiple fees and care about order (e.g. for rounding or display).

Percentage Calculation Basis

Only shown for Percentage of Cart and Base Amount + Percentage.

• Cart Subtotal (Excluding Tax) – Percentage is calculated on the subtotal before tax.
• Cart Subtotal (Including Tax) – Percentage is calculated on the subtotal including tax.

This determines the base amount used for the percentage part of the fee.

Tax Class

BigCommerce tax class for this fee. Tax classes are loaded from your store. Choose Default Tax Class or a custom class so the fee is taxed correctly.

Description

Optional internal description of the fee. Not shown to customers.

Conditions

Conditions limit when the fee applies. If you add no conditions and no min/max cart value, the fee applies to every order (subject to validity dates and other limits).

Adding a condition

Click Add Condition. For each condition you set:

• Condition Type – What to check (see list below).
• Operator – In, Not In, Equals, or Not Equals (depending on type).
• Value – The value(s) to compare (e.g. selected categories, country codes, time range).

All conditions must be satisfied for the fee to apply. To stop the fee from applying when certain things are true, use Not In or Not Equals where appropriate.

Condition types

• Product Category – Select one or more categories; fee applies when the cart contains products from those categories (or not, with Not In).
• Product SKU – Comma-separated SKUs.
• Product Brand – Select one or more brands.
• Product Tag – Comma-separated tags. Uses the “Tags” custom field in BigCommerce; products must have it set.
• Customer Group – Select one or more customer groups.
• Country – ISO 2-letter country codes, comma-separated (e.g. US, CA, GB). Uses shipping address if available, otherwise billing.
• State/Province – Select state(s). Uses shipping address if available, otherwise billing.
• Postal Code – Comma-separated. Supports exact (90210), ranges (90210-90220), and wildcards (902*). Uses shipping address if available, otherwise billing.
• Shipping Zone – Select one or more shipping zones.
• Channel – Select one or more store channels.
• Time of Day – Time range in 24-hour format, e.g. 09:00-17:00.
• Shipping Method – Select or type shipping method names (creatable).

Minimum / Maximum Cart Value

Optional. Enter a Minimum Cart Value and/or Maximum Cart Value. The fee only applies when the cart total falls within this range. Leave a field empty for no limit.

Cart Value Basis

Chooses which cart total is used for the min/max cart value check:

• Cart Subtotal (Excluding Tax) – Subtotal before tax.
• Cart Subtotal (Including Tax) – Subtotal including tax.

Calculation and advanced options

This section contains fee limits, validity period, and rounding.

Minimum Fee Amount / Maximum Fee Amount

Optional. Clamp the calculated fee to a range. For example, set a minimum of 1.00 so a percentage fee never goes below $1, or a maximum of 50.00 to cap it. Leave empty for no minimum or no maximum. If both are set, maximum must be greater than minimum.

Valid From / Valid To

Optional start and end date and time for when the fee is active. Leave Valid From empty to start immediately; leave Valid To empty for no end date. End date must be after start date.

Rounding Method

How the calculated fee amount is rounded before display and charge:

• Nearest – Round to the nearest unit (e.g. nearest cent).
• Round Up – Always round up.
• Round Down – Always round down.

Saving and updating

• Create Fee – Saves the new fee. The modal closes and the fee appears in the list. If it’s enabled and Enable Fee Calculation on Checkout is on in General Settings, it can apply at checkout when conditions are met.
• Update Fee – When editing, this saves your changes and closes the modal.

Validation runs on save. If something is invalid (e.g. missing required field, end date before start date), errors are shown and the fee is not saved.

Editing a fee

Click Edit (pencil icon) on a fee in the list. The same modal opens with that fee’s data. Change any fields, then click Update Fee.

Deleting a fee

Click Delete (trash icon) on a fee. Confirm in the dialog. The fee is permanently removed and will no longer apply to orders.