The future is agentic.

Tutorials

Close the promotion gap with intelligent upselling.

Implement proactive upselling by simulating promotions with the Rules Engine, injecting candidate SKUs into the cart payload, and surfacing contextual offers in real time.

SU
Sebastián
· March 3, 2026
The problem

Understanding the promotion matching gap

Imagine you have products included in a promotion, but they're not performing as expected. Is the product itself not appealing? Is the pricing wrong? Or are customers simply unable to identify the right product combinations needed to trigger the promotion?

If the first two aren't the issue, this article is for you.

Flex promotions are automatically applied when a specific set of conditions is met — either within a cart or through a coupon. But there's a gap: a customer may be just one product away from qualifying for a promotion, with no way for them to know it.

The /api/rules/check endpoint closes that gap. It lets you simulate whether a set of rules would match a given cart — without actually applying any discounts. Think of it as a dry-run evaluator: you inject hypothetical products into the cart payload, run it against your promotion rules, and if there's a match, you surface a targeted suggestion in the UI.

The plan

The upsell evaluation flow

The overall flow looks like this:

ID

Resource

mJPnBfEezQ

Tag "on-sale"

BbpjSNNkAZ

SKU list "summer collection"

DGjtgmdLjW

Candidate SKU A

WaDeSyykMZ

Candidate SKU B

oKkhYLlzgE

Customer's current order

gnYtPpKLeG

Existing line item in the order