Skip to content

Evaluate Promotions

POST /promotions/evaluate command bearer

Evaluates all applicable promotions against a basket, applying discounts and coupon codes. Returns the updated basket with applied promotions.


Overview

ID evaluate-promotions-api
Method POST
Path /promotions/evaluate
Classification command
Domain promotion
Capability promotions
Service evaluate-promotions
Application promotion-engine — Promotion Engine
Auth bearer

Request Body

Business Object basket
Description Commerce container holding intended purchases before order creation.
Classification aggregate-root
Lifecycle open → locked → converted → abandoned → merged

Response

Business Object basket
Description Commerce container holding intended purchases before order creation.
Lifecycle open → locked → converted → abandoned → merged

Scenarios using promotions

Scenario Description
Unified Omnichannel Checkout Customer completes a standard commerce checkout journey from basket through pricing, promotions, pay
Promotional Campaign Launch Marketing defines and activates a promotional campaign that must behave consistently across digital
Retail Media Attribution A sponsored offer is activated for an eligible, consent-aware audience and its approved exposure and
Scan and Go Customer scans items using a mobile app while shopping, receives promotions and loyalty benefits in
Self-Checkout Customer scans and bags items at a self-checkout kiosk, receives applicable promotions, settles paym
API Method Path Type
Validate Voucher POST /vouchers/{code}/validate query