search
Contact API support

New and updated values for discount bases in orders and carts

triangle-exclamation

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

hashtag
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 orderschevron-rightGet orderchevron-rightGet last orderchevron-rightUpdate orderchevron-rightSearch abandoned cartschevron-rightGet abandoned cartchevron-right

Other affected API calls:

spacechevron-rightspacechevron-right

hashtag
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 .

hashtag
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.

hashtag
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.

Last updated

Was this helpful?