Skip to main content
The Promotion Platform decides what a customer is entitled to and, at checkout, what that is worth. It is the largest service group in the reference, and several resources exist in more than one version.
Check the version before you build. Some V1 and V2 endpoints have announced deprecation deadlines — see Breaking Changes. Prefer V3 for new integrations.

Offers

Offer definitions, and the personalized offers assigned to individual customers.

Offers V3

Current offer endpoints.

Personal Offers V3

Assign and import one-to-one personal offers.

Offers V2

Earlier offer endpoints. Prefer V3 for new work.

Coupons

Coupons split by channel: the customer-facing surfaces, and the till.

Coupons (Web & Mobile) V3

Current coupon endpoints for app and web channels.

Coupons (POS)

Retrieve, reserve and redeem coupons at the till.

Coupons (Web & Mobile) V2

Earlier coupon endpoints. Prefer V3 for new work.

Checkout pricing

Discounts

Send a basket, get back applicable offers and calculated discounts.

Engagement mechanics

Challenges

Continuity mechanics — stamp cards, streaks and goals.

Games

Gameplay and rewards.

Bulk operations

Bulk V3

Current bulk endpoints.

Bulk V2

Earlier bulk endpoints. Prefer V3 for new work.
Related integration guides: Direct Coupon Service Integration, Discount Integration and Coupon Redemption at POS.
Last modified on August 13, 2026