Promotions & Pricing Rules

Promotions change what a customer pays at checkout: automatic discounts that apply when conditions are met, and codes the customer enters. Promotions point at what they discount; products do not own promotions.

How the APIs fit

• Manage promotions with the Management API: promotions.list, promotions.get, promotions.create, promotions.update (PATCH), promotions.archive, promotions.unarchive and promotions.delete. The same rules as the dashboard apply, and promotions.create accepts an Idempotency-Key.
• Target lines with a selector instead of a product list: kinds (PRODUCT, BOOKING, CUSTOM), refs (a product with an optional variant, a booking resource, or your own SKU for custom lines), categoryIds and priceRange. marketIds limits a promotion to some markets. Bookings and custom lines can be in scope, including for minimum-order discounts.
• Kanorio evaluates promotions during hosted checkout, so your front end does not calculate discounts itself. A headless storefront can read promotions to show badges, but the discount is only applied on Kanorio's checkout page.
• Subscribe to promotions.redeemed and promotions.redemption_revoked to learn when a paid order used a promotion and when a full refund gave the usage back; ec.order.paid carries promotionId and promotionCode.

The support table below shows what the APIs expose.