Added controls for how Direct Discounts interact with Cart Discounts and best deal selection

17 September 2026

API

Enhancement

Pricing and DiscountsCartsOrdersQuotesGraphQL

You now have finer control over how a Direct Discount interacts with existing promotions on the Cart. Direct Discounts can now apply alongside Cart Discounts and Discount Codes on a Cart or Order, and can participate in best deal selection alongside Product Discounts and Cart Discounts. For more information, see the Pricing and Discounts overview.

Previously, either Direct Discounts or Discount Codes could apply to a Cart, but not both. Direct Discounts were also not part of the best deal selection.

Changes:

[API] Added the directDiscountsIgnoreCartDiscounts field to Cart, CartDraft, Order, Quote, and QuoteRequest.
[API] Added the participateInBestDealSelection field to DirectDiscount and DirectDiscountDraft.
[API] Added the Set DirectDiscountsIgnoreCartDiscounts update action to the Carts API.
[API] Added the Set DirectDiscountsIgnoreCartDiscounts update action to the Order Edits API.
[GraphQL API] Added the directDiscountsIgnoreCartDiscounts field to the Cart, Order, Quote, and QuoteRequest types, and to the CartDraft input type.
[GraphQL API] Added the setDirectDiscountsIgnoreCartDiscounts input field to the CartUpdateAction and StagedOrderUpdateAction types.
[GraphQL API] Added the SetCartDirectDiscountsIgnoreCartDiscounts and SetStagedOrderDirectDiscountsIgnoreCartDiscounts input types.
[GraphQL API] Added the participateInBestDealSelection field to the DirectDiscount, DirectDiscountDraft, and DirectDiscountDraftOutput types.