1. Ordering

Order fees

Overview

Order fees help businesses manage operational costs and maintain profitability. They provide transparency for expenses that aren't easily included in product pricing, helping manage customer expectations while ensuring sustainable operations.

Fee types

Common order fee examples include:

  • Minimum order fees: Applied when orders don't meet minimum value requirements
  • Environmental fees: Cover eco-friendly packaging, carbon offsets, or recycling programs
  • Facility fees: Support venue maintenance, security, cleaning, and utilities
  • Tariff fees: Display import costs separately for pricing transparency

Adding and displaying fees

Order calculation

The Order Calculate event response includes a FeeTotal property for order totals. Learn more about order calculation.

Shopping experience

Store fee information in PriceSchedule extended properties (xp) for display during shopping. Access this data through:

  • GET v1/me/products
  • GET v1/me/products/{productID}

Example fee configuration:

json
{
  "xp": {
    "AdditionalFees": [
      {
        "Name": "Facility Fee",
        "PerQuantity": false,
        "Amount": 3.0
      },
      {
        "Name": "Tariff",
        "PerQuantity": true,
        "Amount": 5.0
      }
    ]
  }
}

Checkout display

Use fee values from the order worksheet calculate response during checkout.


If you have suggestions for improving this article, let us know!