Installation Guide – Order Fees Pro
This guide walks you through installing and configuring Order Fees Pro on a BigCommerce store.
Prerequisites
Before you begin, make sure you have the following:
- A BigCommerce store with admin (store-owner) access.
- Shipping zones, customer groups, and product categories set up in your BigCommerce store if you plan to use condition-based fees.
Step 1 — Install the App
- Open the BigCommerce App Marketplace and search for Order Fees Pro, or navigate to Apps › Marketplace inside your BigCommerce admin panel.
- Click Install (or "Get This App") on the Order Fees Pro listing.
- Review the requested permissions and click Confirm to authorise the app.
The app will automatically:
| Action | Purpose |
|---|---|
| Connect via OAuth | Securely authenticates with your store's API |
| Register storefront script | Injects the checkout script that detects cart changes and refreshes fee totals |
| Register checkout extension | Enables real-time checkout refresh when fees are updated |
| Register webhooks | Listens for cart-created and cart-updated events so fees are calculated automatically |
| Set default configuration | Applies sensible defaults so you can start creating fees immediately |
| Activate 14-day free trial | Full access to all features during the trial period |
No manual setup is required; the app is fully operational once the install completes!
Step 2 — Open the App
- In your BigCommerce admin, go to Apps › My Apps.
- Click Order Fees Pro to open the app dashboard.
You will see three main sections in the sidebar:
- Order Fees — Create, edit, and manage fees.
- General Settings — Control checkout fee calculation and manual webhook triggers.
- Advanced Settings — Disable/enable the app, manage webhooks, and view technical details.
Step 3 — Verify the Installation
Before creating your first fee, confirm everything is connected:
- Navigate to Advanced Settings.
- Under Webhook Management, click Check Status.
- You should see confirmation that the required webhooks are registered.
- Confirm that the Checkout Extension ID field has a value (it is set automatically during install).
- If the field is empty, click Fetch from BigCommerce to retrieve it, then click Save Changes.
Step 4 — Configure General Settings
Open General Settings and review these options:
Enable Fee Calculation on Checkout
Turn this on (default) so that fees are calculated and displayed at checkout. This is required for fees that depend on checkout data such as shipping zone or address.
Recalculate Fees When Specific Elements Are Clicked (optional)
Turn this on if your fees depend on shipping zone, address, or shipping method. This applies fees when customers click specific checkout buttons (e.g. the "Continue" button after selecting shipping).
When enabled, you can specify:
- Element IDs — HTML
idvalues of checkout buttons that should trigger recalculation (e.g.checkout-shipping-continue). (Do not include the#prefix) - Element Classes — CSS class names of elements that should trigger recalculation (e.g.
checkout-btn).
Click Save Changes when done.
Step 5 — Create Your First Fee
- Navigate to Order Fees in the sidebar.
- Click Create New Fee.
- Fill in the required fields:
| Field | Description |
|---|---|
| Fee Name | The label shown at checkout (e.g. "Processing Fee"). |
| Fee Code | A unique reference code (e.g. PROCESSING_FEE). Auto-generated from the name; editable. |
| Amount | The numeric value — its meaning depends on the calculation method. |
| Calculation Method | How the fee is calculated (see below). |
| Tax Class | The BigCommerce tax class applied to this fee. |
Calculation Methods
| Method | Behaviour |
|---|---|
| Fixed Amount | A flat fee per order. |
| Percentage | A percentage of the cart (or shipping) subtotal (excl. or incl. tax, configurable). |
| Per Item | Amount × total quantity of items in the cart. |
| Per Category | Amount × quantity of items in selected categories. |
| Tiered | Different rates based on cart value tiers. |
| Weight Based | Amount × total product weight. |
| Compound | A base amount plus a percentage of the cart. |
- (Optional) Add Conditions to restrict when the fee applies — e.g. minimum cart value, specific categories, customer group, shipping zone, country, SKU, brand, tag, channel, or time of day.
- (Optional) Set Priority (controls the order fees are applied), Valid From / Valid To dates, Min/Max Fee Amount, and Rounding Method.
- Toggle Fee Status to Enabled.
- Click Create Fee.
The fee will now be calculated and shown at checkout whenever a cart matches its conditions.
Step 6 — Test the Fee
- Open your storefront in a new browser tab (or use a private/incognito window).
- Add products to your cart that match the fee's conditions.
- Proceed to checkout.
- Confirm that the fee appears as a line item with the correct name and amount.
TIP: If the fee does not appear, check:
- The fee is enabled in the Order Fees list.
- Enable Fee Calculation on Checkout is on in General Settings.
- The cart meets all of the fee's conditions (value thresholds, categories, etc.).
- Webhooks are registered — use Check Status in Advanced Settings.
Troubleshooting
Fees are not appearing at checkout
- Verify the fee is enabled and its conditions match the cart.
- Open General Settings and confirm Enable Fee Calculation on Checkout is on.
- Open Advanced Settings and click Check Status to verify webhooks.
- If webhooks are missing, click Reinitialise Webhooks, then Save Changes.
- Confirm the Checkout Extension ID is set. If empty, click Fetch from BigCommerce and save.
Fees are not updating after the customer changes shipping or address
Enable Recalculate Fees When Specific Elements Are Clicked in General Settings and add the IDs or classes of your theme's checkout "Continue" buttons.
Need to temporarily stop all fees
Open Advanced Settings and turn on Disable App Completely.
Uninstalling
To remove the app, go to Apps › My Apps in BigCommerce admin, find Order Fees Pro, and click Uninstall. All registered scripts, webhooks, and checkout extensions will be removed automatically. Fee configurations stored in the app will be deleted.