> For the complete documentation index, see [llms.txt](https://docs.commercelayer.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.commercelayer.io/data-model/foundation-and-setup/merchants-and-customers.md).

# Merchants and customers

Market ownership, customer segmentation by purchase history, and group-based access control

<figure><img src="https://3374657681-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlDfS8CZ2kCfiwsAPFyWM%2Fuploads%2F4dj4Xvcqvd5tn5BkzsXB%2Fmerchant-customer.jpg?alt=media&amp;token=6a351047-d504-46a7-8175-e9ca3003e6d4" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="lightbulb" %}
Each market belongs to one merchant, who defines its business model and price list. Customers are categorized by purchase history. Customer groups give selected customers private access to markets, promotions, and more.
{% endhint %}

## Merchants

A [merchant](/core-api-reference/merchants.md) 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 with its own billing address. The merchant defines the market's business model, inventory model, and price list for customers in that market.

## Customers

[Customers](/core-api-reference/customers.md) are individuals who make purchases from an ecommerce sales channel. They are identified by their email addresses.

There are three 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](https://commercelayer.io/distributed-oms) lets you manage customers in an organization. You can also export customers to any external CRM (customer relationship management) or marketing tool to manage campaigns, loyalty programs, and more.

## Customer groups

[Customer groups](/core-api-reference/customer_groups.md) are a collection of selected customers. You can 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.commercelayer.io/data-model/foundation-and-setup/merchants-and-customers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
