This guide is an overview of the resources related to pricing and promotions and describes how you can use these resources to implement common e-commerce features in a client application.

Promotions are incentives offered to shoppers to promote the purchase of items in a store. A store’s marketer creates promotions and defines a set of conditions that must be met by the shopper before the promotion is applied. When promotions are applied, discounts for the following can be generated:

When a promotion is applied, the corresponding price or totals resource updates to reflect the discount. You don't need to compute the changes yourself as Cortex handles this for you.

An item resource is a purchasable good or service. An item has a price and a list of applied promotions. The pricing and promotion resources are linked to an item as follows:

The following is an example of a product page that demonstrates how these resources can be used in a client application:

A cart is a basket of items that the shopper is interested in purchasing. Items added to the cart are called cart line items and each cart line item has a corresponding quantity that represents the number of units of the item being purchased. Additionally, every cart has an associated order that tracks and communicates the information required to complete a purchase.

Promotions can be automatically applied to the cart using rules defined by the store marketer. When promotions are applied to the cart, they can generate discounts for the following resources:

The shopper can also trigger promotions manually by applying coupons to their order. Applying a coupon may trigger a promotion depending on the content's of the shopper's cart and the rules defined by the store marketer.

The pricing and promotion resources are linked to a cart and order as follows:

The following is an example of a product page that demonstrates how these resources can be used in a client application:

A purchase is a receipt of a submitted order. This means prices and promotions shown in a purchase are not affected by changes made by the store marketer. For example, if a store marketer changes the price of an item, the purchase prices will show the price and totals the shopper actually paid for the item and not the updated price.

The pricing and promotion resources are linked to a purchase as follows:

The following is an example of a purchase receipt page that demonstrates how these resources could be used in a client application: