Commerce Layer API, explained — Explore our Data Model.

Merchants and Customers

A user can create many markets for categorized geographical regions. The created markets will then be associated with merchants, customers, and customer groups. In this section, you will learn more about a user's responsibilities in the structuring of markets.
Merchant / Customer relationship


A merchant is the seller or owner of each market in an organization. You can associate the same merchant with one or more markets.

An organization may have one or more merchants, each associated with its own billing address. The merchant handles defining the market's business model, inventory model, and price list for customers in the market only.


Customers are individuals who make purchases from an ecommerce sales channel. They are identified by their email addresses.

There are four categories of customers in Commerce Layer:

  • Prospect customers — customers who have not placed an order yet.
  • Acquired customers — customers who have placed only one order.
  • Repeat customers — customers who have placed more than one order.

Commerce Layer's order management system allows users to manage customers in an organization. You can also export customers to any external CRM (customer relationship management) or marketing tool. This allows them to manage campaigns, loyalty programs, and more.

Customer groups

Customer groups are a collection of selected customers. This allows users to organize and associate a customer group with a market. All customers in a particular group get private access to a market, promotions, campaigns, loyalty programs, and more.

You can also use customer groups to manage B2B, B2C, subscription, private sales, and marketplace business models.

Ready to get started?