> For the complete documentation index, see [llms.txt](https://docs.optty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optty.com/partner-onboarding-docs/onboarding-via-portal/onboarding-a-merchant.md).

# Onboarding a Merchant

This page explains how a Parent (Partner) account holder adds a new Merchant beneath them in the Optty dashboard.

Before you begin, ensure you are operating in the Parent account context. The header displays **Partner Name: \[name]** and a yellow banner at the bottom of the screen reads "Your original account is \[name] — Exit this view." If you are not yet in the Parent context, follow the [User Impersonation (Login As)](/partner-onboarding-docs/onboarding-via-portal/user-impersonation-login-as.md) guide first.

***

### 1. Navigate to Merchants Management

Select **Merchants Management** in the left sidebar. The **Your Merchants** page opens, listing any Merchants already associated with this Partner account.

![Merchants Management page with + Add New highlighted and Exit this view banner visible](/files/q0NmF98Koj8J88ZAvc7Z)

***

### 2. Add a New Merchant

Click **+ Add New** in the top-right corner of the page.

![Merchants list with + Add New button highlighted](/files/vvxfCPqoWw7bGamaxsrM)

***

### 3. Enter the Merchant's Name and Save Changes

Enter the **Merchant's Name** in the required field (marked with `*`).

![Add Merchant Details modal with name field and Save Changes button highlighted](/files/91EuAxotKQSbXDnrB693)

> 📋 **Note:** **Advance Settings** is available within the modal for additional configuration. This is not required to complete basic onboarding and can be revisited later.

***

***

### 4. Reload the Page to Confirm

The new Merchant will not appear in the list immediately after saving. **Reload the page** to see the updated Merchant list.

![Merchant list after reload with the new merchant entry highlighted](/files/RmvBSTzIRgAEtiWe79JL)

> 📋 **Note:** After saving, you must reload the page before the new Merchant appears in the list.

***

### 5. Next Steps

The Merchant is now created and active. From the Merchant row you can:

* Click **Manage Merchant** to configure payment methods and settings.
* Click **Manage Users** to add users to this Merchant account.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.optty.com/partner-onboarding-docs/onboarding-via-portal/onboarding-a-merchant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.