New and updated values for discount bases in orders and carts

Breaking changes! Сhanges listed below may break some apps' logic.

What's new

The discountInfo -> base field in the Order and Cart API objects now supports a different set of values. The field defines a basis from which a discount (promotion) is calculated.

List of affected endpoints in REST API:

Search ordersGet orderGet last orderUpdate orderSearch abandoned cartsGet abandoned cart

Other affected API calls:

spacespace

Changes in API

The discountInfo -> base field now works with another set of values.

Supported values before the change: ON_TOTAL, ON_MEMBERSHIP , ON_TOTAL_AND_MEMBERSHIP .

Supported values after the change: SUBTOTAL , ITEM , SHIPPING , ON_MEMBERSHIP , ON_TOTAL_AND_MEMBERSHIP , CUSTOM .

Why the changes are breaking

The old value ON_TOTAL was replaced with the new SUBTOTAL . It still means that the discount is only applied to the order subtotal cost (without shipping costs) with no additional conditions like the customer's membership.

How to update the app

1. Check if your app works with one of the listed requests.

2. Check the code that parses order details coming from Ecwid – specifically if it checks for the discountInfo value.

3. Make sure to add SUBTOTAL to the list of expected values. If your app doesn't work with orders older than March 1, 2025, remove the ON_TOTAL from the list of expected values.