Commerce Layer API, explained — Explore our Data Model.

Price Lists and Currencies

SKUs will have prices assigned to them within a market. In this section, you will learn about price lists, currencies, and how to assign a particular SKU to one or more prices in different markets.
Price list / currencies relationship

Price lists

Price lists are collections of SKU prices, defined by currency and market. When a list of SKUs is fetched, only SKUs with a price defined in the market's price list and at least a stock item in one of the market stock locations will be returned. A user can create price lists to manage international business or B2B/B2C models.

Prices and currencies

Prices are the defined cost price of an SKU associated with a currency and price list. When a customer purchases a SKU, it gets the price associated with the order's price list for that market. An SKU can cost $50 in List A for the US market and €45 in List B for the EUR market. SKUs without a price in a given price list are not sellable for the market or customer group associated with that price list.

External prices

You might need more dynamic pricing options or desire to define a custom price calculation logic that Commerce Layer doesn't support. To do this, you can manage your prices using an external service.

You will set your external service API endpoint at a market level. This will calculate the unit price of each SKU and will be fetched upon request.

Ready to get started?