Order Fees

Published by Miranda Danielson on June 9, 2025

Overview

Order Fees give businesses the flexibility to cover operational costs and maintain profitability in a competitive market. They allow sellers to account for expenses that aren't easily absorbed into product pricing. The transparency that comes with fees helps manage customer expectations while ensuring the business can operate sustainably.

Fee Types

The following are just a few examples of the types of fees that may be associated with an order.

Minimum order fees can be applied when the total value of the order doesn't meet a predefined minimum amount, to make low-volume sales viable
Environmental or sustainability fees are used to offset eco-friendly packaging, carbon offsets, or recycling programs
Facility fees are common in ticket sales for concerts, sports, or theater events. These fees help cover the costs of maintaining the venue—things like security, cleaning, utilities, and upkeep
Tariffs can be displayed as a separate fee to consumers in order to maintain transparent pricing and clearly communicate the source of increased costs

Adding & Displaying Fees

The response body to the Order Calculate event has a property to provide the FeeTotal to be applied to the Order. In order to add the Fee(s) into your Order Total, it needs to be provided through that response, which you can read more about here.

For display purposes during the shopping experience, we recommend storing relevant fee information on PriceSchedule xp, which can easily be accessed on products returned from GET v1/me/products or GET v1/me/products/{productID}. Here's an example of how you could store fee information to later render the data when needed in the UI:

1{
2    "xp": {
3        "AdditionalFees": [
4                {
5                    "Name": "Facility Fee",
6                    "PerQuantity": false,
7                    "Amount": 3.00
8                },
9                {
10                    "Name": "Tariff",
11                    "PerQuantity": true,
12                    "Amount": 5.00
13                }
14          ]
15    }
16}

For displaying fees during checkout, we recommend using the values stored on the order worksheet calculate response.

Still have questions?
Ask in our Community Channel