> For the complete documentation index, see [llms.txt](https://magecomp.gitbook.io/shopify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://magecomp.gitbook.io/shopify/apps/chargify-extra-fee/fees-settings.md).
# Fees Settings
After installing the app to your Shopify store, you must access the app's backend to begin with the configuration settings.
The initial main configuration settings are to **Enable** the app, and **Add the app block** into your theme to start its functionality.
Once you have enabled the app and added the app block in the theme, you can start with the configuration of the **Fees Settings.**
* The **Limit Based Charge** feature allows you to apply a surcharge only when the customer's order subtotal falls within a specified range. By configuring the **Minimum Amount** and **Maximum Amount**, you can control when the surcharge should be applied.
* Once you have created a surcharge, you can configure the **Limit Based Charge** settings.
#### Enable Limit Based Charge
Enable the **Limit Based Charge** option to apply the surcharge only when the customer's order subtotal falls within the specified amount range.
#### Minimum Amount
Enter the minimum order subtotal required for the surcharge to be applied. Orders below this amount will not be charged.
#### Maximum Amount
Enter the maximum order subtotal up to which the surcharge will be applied. Orders exceeding this amount will not be charged.
Once both values are configured, the surcharge will only be applied if the customer's order subtotal falls within the defined range.
### Example 1 - Fixed Surcharge
**Configuration**
* **Type:** Fixed
* **Fee Amount:** $20
* **Minimum Amount:** $100
* **Maximum Amount:** $500
| Customer Subtotal (Before Surcharge) | Customer Subtotal (After Surcharge) | Result |
| ------------------------------------ | ----------------------------------- | ---------------------- |
| $80 | $80 | ❌ No surcharge applied |
| $100 | $120 | ✅ Surcharge applied |
| $250 | $270 | ✅ Surcharge applied |
| $500 | $520 | ✅ Surcharge applied |
| $550 | $550 | ❌ No surcharge applied |
### Example 2 - Percentage Surcharge
**Configuration**
* **Type:** Percentage
* **Fee Amount:** 5%
* **Minimum Amount:** $200
* **Maximum Amount:** $1000
| Customer Subtotal (Before Surcharge) | Customer Subtotal (After Surcharge) | Result |
| ------------------------------------ | ----------------------------------- | ---------------------- |
| $150 | $150 | ❌ No surcharge applied |
| $200 | $210 | ✅ 5% surcharge applied |
| $600 | $630 | ✅ 5% surcharge applied |
| $1000 | $1050 | ✅ 5% surcharge applied |
| $1200 | $1200 | ❌ No surcharge applied |
***
> **Note:** The surcharge is applied only when the customer's order subtotal is **greater than or equal to the Minimum Amount** and **less than or equal to the Maximum Amount**. Orders outside this range will not incur the configured surcharge.
#### For Percentage Type
| Minimum Amount | Maximum Amount | Fee Amount | Customer Subtotal (Before Surcharge) | Customer Subtotal (After Surcharge) |
| -------------- | -------------- | ---------- | ------------------------------------ | ----------------------------------- |
| $100 | $500 | 5% | $100 | $105 |
| $100 | $500 | 10% | $250 | $275 |
| $100 | $500 | 5% | $500 | $525 |
| $100 | $500 | 5% | $80 | $80 *(No surcharge applied)* |
| $100 | $500 | 5% | $600 | $600 *(No surcharge applied)* |
***
#### For Fixed Type
| Minimum Amount | Maximum Amount | Fee Amount | Customer Subtotal (Before Surcharge) | Customer Subtotal (After Surcharge) |
| -------------- | -------------- | ---------- | ------------------------------------ | ----------------------------------- |
| $100 | $500 | $20 | $100 | $120 |
| $100 | $500 | $20 | $250 | $270 |
| $100 | $500 | $20 | $500 | $520 |
| $100 | $500 | $20 | $80 | $80 *(No surcharge applied)* |
| $100 | $500 | $20 | $600 | $600 *(No surcharge applied)* |
#### **Surcharge Display & Customer Consent**
To comply with platform guidelines, any additional charges such as a **10% surcharge** applied to the order amount must be clearly shown to the customer and require their explicit approval before being added to the cart.
To meet this requirement, we have implemented:
**Automatic surcharge calculation**: The cart page displays the **surcharge amount (10% of the order total) in real time**.
**How the 10% Surcharge Is Calculated**
To provide full transparency, here’s how the surcharge is applied to the order total:
* The product price is **$2,629.95**.
* A 1**0% surcharge** is applied based on the order total.
* **10%** of **$2,629.95** = **$262.995**, which rounds to **approximately $263**.
* When this surcharge is added to the product price, the final total becomes:
\
**$2,629.95** + **$262.995** = **$2,892.945**, which rounds to **approximately $2,893**.
**Customer authorization checkbox**: A confirmation checkbox is provided on the cart page. Customers must manually check this box to authorize the surcharge.
The surcharge will only be applied once the customer gives consent by selecting this checkbox.
This ensures full transparency and prevents any unintended charges, helping your store stay compliant while maintaining customer trust.
The checkout button will remain disabled until the customer checks this box and confirms the addition.
**You can now apply additional charges only to selected products or specific collections, instead of applying the fee to the entire cart.**
#### Product-Specific Charges
* You can select **individual products** on which the additional charge should apply.
* Example: If **Arin Socks** is selected, the additional charge will be applied only when this product is added to the cart.
#### Example :
A store owner wants to apply an extra delivery charge only to a specific product.
* **Selected Product:** Arin Socks
* **Cart Subtotal:** $78
* **Additional Fee:** 2% of $78 = **$1.56**
* **Total:** **$79.56**
* **Result:**\
Since the cart subtotal is greater than $7 and the selected product is in the cart, the additional delivery charge is applied.
If the cart does **not** include Arin Socks, no additional charge will be added.
{% hint style="info" %}
**Note:** Customers must manually confirm the charge by selecting the checkbox **“I accept the additional fee charge.”** The additional fee will not be applied without confirmation.
{% endhint %}
#### Collection-Specific Charges
* You can also apply additional charges to **specific collections**.
* Example: If the **Jeans Pants** collection is selected, the additional charge will apply when products from this collection are added to the cart.
#### Example:
A store owner wants to apply an extra charge to all products in a particular collection.
* **Selected Collection:** Jeans Pants
* **Cart Subtotal:** $349
* **Additional Fee:** 2% of $349 = **$6.98**
* **Total:** **$355.98**
* **Result:**\
When any product from the **Jeans Pants** collection is added to the cart, and the subtotal exceeds $7, the delivery charge is applied.
If no product from the selected collection is present in the cart, the fee is not applied.
{% hint style="info" %}
**Note:** Customers must manually confirm the charge by selecting the checkbox **“I accept the additional fee charge.”** The additional fee will not be applied without confirmation.
{% endhint %}
#### **Fee Requirement & Apply Fee by Default**
This feature gives you better control over how additional fees are applied to customer orders.
**Fee Requirement**
You can now decide whether the fee should be mandatory or optional for customers:
* **Required:**\
The fee is automatically applied and cannot be removed by the customer.
* **Optional:**\
Customers will see a checkbox (e.g., *“I accept the additional fee”*) and can choose whether to apply the fee.
**Apply Fee by Default**
* When enabled, the fee checkbox will be **pre-selected** for customers.
* Works best when **Fee Requirement is set to Optional**, ensuring higher acceptance while still giving customers a choice.
### Multi-Language Support
You can now offer your app in multiple languages to provide a better experience for global customers.
**Supported Languages:**
* English
* German
* Italian
* French
* Spanish
* Portuguese (Brazil)
### Cart Weight (Optional)
This feature allows you to apply certain rules or conditions based on the **total weight of products in the cart**.
**How it works:**
* Each product variant has a weight (in grams)
* The app calculates the **total cart weight** based on selected items
* First, any **subtotal-based rules** are applied
* After that, the **weight condition** is checked (if enabled)
**Example:**\
If you want to apply an extra charge for heavy orders, you can set a condition based on cart weight.
### Customer-Based Conditions (Optional)
This option lets you control **who can see or be affected by certain fees or rules**.
**How it works:**
* You can apply rules only to **logged-in customers with specific tags** (e.g., wholesale, VIP)
* Or apply to **all logged-in customers**
* **Guest users will not see these fees or rules**
**Example:**\
You can show special charges or discounts only to wholesale customers while hiding them from regular or guest users.
