> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant accounts

> Manage multiple accounts in one instance

<img src="https://mintcdn.com/gr4vy/jCFeFdffXM43huI0/assets/images/merchant-accounts/hero.png?fit=max&auto=format&n=jCFeFdffXM43huI0&q=85&s=493d339ba55a089b9803b9b3a9d24028" alt="Merchant accounts" width="1544" height="639" data-path="assets/images/merchant-accounts/hero.png" />

Multiple merchant accounts can be supported in one instance. Each merchant account represents a
single merchant with its connections to payment and anti-fraud services, users, API keys,
Flow rules, transactions, and more.

By default each instance only has one "default" merchant account, creating a uniquely contained,
single-tenant infrastructure, yet for those who need to support it, additional merchant accounts
can be enabled to allow for easy separation of data between each of the different accounts.

<Note>
  **Enabling multi-merchant**

  Support for multiple merchant accounts in one instance is a
  premium feature. Please contact the account manager for pricing.
</Note>

## The basics

* Each **environment** has **one default merchant account** that all data is associated with
* Transactions, payment methods, buyers, flow rules, connections,
  and all other **transaction data** are associated with **one (and only one) merchant account**
* New merchants accounts can be created by administrators
* **Administrators** always have access to **all merchant accounts**
* Other **users** can be assigned to have access to **one or more merchant accounts**
* **API keys** can be created that act can access **either one, or all merchant accounts**

## Learn more

<CardGroup>
  <Card title="Managing multiple merchant accounts" icon="buildings" href="./accounts">
    Learn how to set up merchant accounts including custom webhook configuration.
  </Card>

  <Card title="Users & merchant accounts" icon="users" href="./users">
    Learn how to set up new users and associate them with merchant accounts.
  </Card>

  <Card title="API access & merchant accounts" icon="key-skeleton-left-right" href="./api">
    Learn how to set up new API keys and restrict them to one or many merchant accounts.
  </Card>

  <Card title="Embed & merchant accounts" icon="web" href="./embed">
    Learn how to configure Embed to handle different merchant accounts.
  </Card>
</CardGroup>
