> For the complete documentation index, see [llms.txt](https://docs.omypayments.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omypayments.com/white-label/partner-dashboard/merchants.md).

# Merchants

### Finding a merchant

**Merchants → List** shows all merchants that signed up on your domain. Search by the **owner email** — the email of the merchant's owner account; the emails of other team members are not searched. Open a merchant to see its card.

The card has tabs. The open tab is kept in the page address, so you can share a link straight to, say, a merchant's **Fees**.

### Information

Business details the merchant entered: ID, website, contacts, legal type, country, city. The **Setup** block shows the merchant's payment flow, whether mass payouts are on, and its verification tariff.

#### Verification tariff

The verification tariff sets the merchant's withdrawal caps and whether the merchant is marked as verified. A new merchant starts on the default tariff.

To change it, choose a tariff from the list. With 2FA on, confirm with a code. The new caps apply to the merchant's very next withdrawal.

Choosing the right tariff for each merchant is your responsibility under your White Label agreement.

### Assets

The merchant's balance in each cryptocurrency:

* **Available** — can be withdrawn, swapped or paid out;
* **Pending** — received, still being processed;
* **Frozen** — held by a compliance check.

The deposit address of each asset is shown only while deposits are switched on for that asset.

### Addresses

Every address of the merchant, newest first, filterable by network, cryptocurrency and type.

| Type        | What it is                                                |
| ----------- | --------------------------------------------------------- |
| **Cold**    | The merchant's main wallet, where its funds are collected |
| **Deposit** | The address the merchant's customers deposit to           |
| **Hot**     | An address issued for a single invoice                    |

| Status       | Meaning                                            |
| ------------ | -------------------------------------------------- |
| **Active**   | In use                                             |
| **Inactive** | No longer in use                                   |
| **Rotated**  | Replaced by a new address — never send funds to it |

A **Frozen** mark means the address is held by a compliance check. The copy button is hidden for inactive and rotated addresses.

**Issue missing addresses** asks the platform to issue any base addresses the merchant is missing. They appear shortly; reload the tab to see them. The request is refused when the merchant settles by amount rather than by address, has not confirmed its email yet, or is blocked.

### Fees

Two sets of rates side by side, per operation type and cryptocurrency:

* the **base fee** set by OmyPayments — read-only;
* **your markup** for this merchant — editable.

The merchant pays the two together. To set a markup, choose the operation type, then one cryptocurrency or all of them at once, and enter a percentage and/or a fixed amount in USD. See [Fees and partner revenue](https://docs.omypayments.com/white-label/fees-and-partner-revenue.md).

### Limits

Per-merchant limits in USD, per cryptocurrency or for all at once:

| Limit                   | What it controls                                                               |
| ----------------------- | ------------------------------------------------------------------------------ |
| **Withdrawal min**      | Smallest withdrawal the merchant can make                                      |
| **Clean min**           | Smallest balance on an address worth collecting into the merchant's wallet     |
| **Clean remainder min** | Native-coin balance that collection leaves on an address                       |
| **Swap min**            | Smallest swap; replaces the platform's default minimum for that cryptocurrency |
| **Swap max**            | Largest swap; without it, swaps have no maximum                                |

A merchant limit takes priority over the default limit OmyPayments set for you, including when it is set to zero.

### Deposits

Switch deposits on or off for each of the merchant's assets. Deposits on the native coin of a network cannot be switched on. If one is already on, you can switch it off.

**Switching deposits off does not close the address.** The deposit address stays live, and anything sent to it afterwards is **not credited** to the merchant. Before switching an asset off, make sure the merchant has told its customers to stop sending to that address.

Below the switches is the list of the merchant's deposits.

### Withdrawals

**Auto-approval thresholds** decide which of the merchant's withdrawals go out on their own and which wait for you:

* **Amount** — the total in USD that may go out on its own within a rolling time window you choose;
* **How many** — the number of withdrawals that may go out on their own within a rolling time window you choose.

Each threshold has its own window. The windows count every withdrawal the merchant made, not only the automatic ones.

A withdrawal that would exceed either threshold waits in **Approve withdrawals**. Set both to zero to approve every withdrawal yourself. With 2FA on, changing the thresholds asks for a code.

Below the settings is the list of the merchant's withdrawals.

### Mass payouts

* **Mass payouts enabled** — whether the merchant can create mass payouts at all. Switching it off stops new batches; batches already waiting are not affected.
* **Approve mass payouts automatically** — on: new batches go out without waiting; off: they wait in **Approve mass payouts**. Batches already waiting are not affected either way.

Below the settings is the list of the merchant's mass payouts.

### Invoices

The list of the merchant's invoices. The **Fee** column shows the fee charged on each invoice, in the invoice's cryptocurrency and in USD.

### Swaps

* **Auto-approve swaps** — on: new swaps of the merchant are accepted at once, including swaps to an external address where those are allowed; off: they wait in **Approve swaps**. Swaps already waiting are not affected — approve or decline them in the queue. A new merchant starts with it off.
* **Allow swaps to an external address** — on: the merchant can swap to its own addresses and to any address outside the platform; off: only to its own addresses. Swaps already running are not affected.

Below the settings is the list of the merchant's swaps, with the **Fee** of each in USD. Open a swap to see its details.
