# 💡 Add Extra Fees to Customer Orders

Some orders carry additional costs: extra handling, packaging, insurance, special processing, or other overheads. With the **Extra Fee** module, you can **automatically add fees** when certain conditions are met — ensuring your business recovers those costs while maintaining trust and clarity for your B2B clients.

This feature seamlessly integrates into your pricing ecosystem, so your wholesale pricing is complete — discounts, shipping, and extra fees all in one place.

## 🛠 How to Set Up an Extra Fee Rule

### Step 1: Enable Extra Fee & Access Configuration

1. Go to **B2B Pricing** in the app sidebar.
2. Toggle **Extra Fee** ON.
3. Click **Configuration**.
4. Click **Add Rule**.

***

### Step 2: General Information

1. Enter a **Name** for your rule — this name appears as the fee line item at checkout (e.g., "Handling Fee").
2. Assign a **Priority** (`0` = highest) — if multiple rules overlap, the priority determines which applies.
3. Toggle the rule **Enabled / Disabled**.

> **Note:** When two rules share the same priority and apply to the same conditions, the one created earlier takes precedence.

***

### Step 3: Apply to Customers

Select which customers this fee applies to:

* **All customers**
* **Specific emails** — enter individual customer email addresses
* **Customer tags** — e.g., `wholesale`, `bulk-buyer`
* **Logged-in customers only**

***

### Step 4: Apply to Markets (Optional)

Restrict this rule to specific **Shopify Markets** — the geographic selling zones you manage in **Shopify Markets**.

1. Select one or more markets. Each entry shows the market name, number of regions, and a `*` marker for your primary market.
2. Click **Select** to confirm.

Leave this field empty to apply the rule across **all markets**.

> **When to use:** Use this step when different regions require different fee structures (e.g., a handling surcharge for international markets only).

***

### Step 5: Apply to Products

Choose which products or variants trigger this fee:

* **All products**
* **Specific products or variants**
* **Collections**
* **Product tags**

Leave blank to apply to all products.

***

### Step 6: Exclude Customers (Optional)

Prevent certain customers from being charged this fee, even if they match the eligibility criteria in Step 3.

* **None** — no customers are excluded
* **Specific customers** — enter individual customer email addresses to exclude
* **Customer tags** — exclude all customers carrying a specific tag (e.g., `vip`, `staff`)

***

### Step 7: Exclude Products (Optional)

Exclude specific products or variants so they do not trigger this fee, even when other products in the cart do.

* **None** — no products are excluded
* **Specific products or variants** — select individual items to exclude

***

### Step 8: Extra Fee Calculation

Choose how the fee quantity or amount is measured:

| Option                | Description                                                                                                 |
| --------------------- | ----------------------------------------------------------------------------------------------------------- |
| **All applied items** | The fee is calculated based on the combined quantity or total value across all qualifying items in the cart |
| **Per item**          | The fee is calculated individually for each qualifying line item                                            |

***

### Step 9: Rule Settings

Choose what the fee is based on:

| Range Type   | What it measures                       |
| ------------ | -------------------------------------- |
| **Quantity** | Number of qualifying items in the cart |
| **Amount**   | Total value of qualifying items        |

Set **From / To** thresholds for each range, then assign the fee:

| Fee Type               | Description                                                                        |
| ---------------------- | ---------------------------------------------------------------------------------- |
| **Percentage**         | Fee is a percentage of the range value (e.g., 5% of order total)                   |
| **Fixed fee**          | A flat amount applied once when the range is met (e.g., $10.00)                    |
| **Fixed fee per item** | A flat amount charged for each qualifying item individually (e.g., $2.00 per unit) |

You can add multiple ranges to create a tiered fee structure.

**Example:**

* 1–10 items → $2.00 fixed fee per item
* 11–50 items → $15.00 flat fee
* 51+ items → 5% of order total

### **Step 10: Install & Activate the Rule**

* Once the rule is saved, it's automatically installed on your storefront
* If needed, you may go to **Extra Fee → Installation** to customize how the fee appears or behaves
* Your new rule becomes active immediately for eligible orders

## 👀 What Customers Will See

* On **product pages**, applicable fees may be shown if the product meets your rule criteria

<figure><img src="https://lh6.googleusercontent.com/da0ozjX6eMuLH9o1clfvKfGACryNWihsnaaeQEYPQrwVcwOdv0DlXgT6xoeMK4v-acV9Mcs1YwRvtr5B_e5G1CPQvd8W6Gsx6gqq_FkmoIHQFXGaU4sVWA6MVUvLQe85RRAdpauMDfIRFAq_vvITjwU" alt=""><figcaption></figcaption></figure>

* At **checkout**, the extra fee is added transparently to the order, so customers know what they’re paying for
* If the order doesn’t meet the thresholds or applies to excluded customers/products, **no extra fee** will be charged

<figure><img src="https://lh4.googleusercontent.com/v7NtjCmNlLeyFPTbWNiDTtKgqtCeKcw9jnzb_2Yj5ojJerAdTWtGb1lhHZEka28iQkv_6Fw3Y5g7ZwIF8uTW70_ohUkhEQud-GhYVffzQAZeqLGScOs-hYGwlYTCSrFuFNPeV02yCIFdP_FJhOI9eoc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you want further assistance, please reach out to us at [**support-sbc@bsscommerce.com**](mailto:support-sbc@bsscommerce.com) or [**Live Chat**](https://go.crisp.chat/chat/embed/?website_id=9f64b5a9-1a02-4190-93b8-8ef56b19f740).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-shpf.bsscommerce.com/b2b-wholesale-solution/b2b-pricing/more-add-depth-and-flexibility-to-your-b2b-pricing/extra-fee/add-extra-fees-to-customer-orders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
