Overview

Promotions apply automatic checkout discounts without a coupon code. Each promotion has ordered phases; the first eligible phase controls the active discount. Priority determines evaluation across promotions, while stackability controls whether a coupon can also apply.

Replacing phases is a complete replacement. Preserve any phase that should remain and send decimal monetary or percentage values as documented strings, not JSON floats. The operation schemas are authoritative for phase conditions, discount units, schedules, and redemption caps.

Endpoints

• List promotions
• Search promotions
• Create a promotion
• Retrieve a promotion
• Update a promotion
• Replace phases
• Delete a promotion
• Restore a promotion