How to Add and Manage Sub-Merchants in Niobi
Learn how to add and manage sub-merchants in Niobi, review their statuses, view details, and delete sub-merchant records from your workspace.
By Niobi Team · Published 2026-08-18
Introduction
Sub-merchants let you register and track businesses operating under your Niobi workspace. Each sub-merchant record includes key details such as the legal name, licensing information, and the countries where the business is incorporated and transacts. Sub-merchants are reviewed against Niobi's compliance policies before going live.
In this guide, you'll learn how to:
- Find the Sub-Merchants page in your workspace
- Add a new sub-merchant
- Understand sub-merchant statuses
- View details or delete an existing sub-merchant
Time to complete: 4 minutes\
Difficulty: Intermediate
Before You Start
To add and manage sub-merchants in Niobi, you'll need:
- A Niobi account with access to Workspace settings
- Permission to manage Sub-Merchants (this may be restricted to workspace admins)
- The following details for the business you're adding:
- Legal name
- License type
- License jurisdiction
- Website
- Business activity
- Incorporation country
- Transaction country
Step-by-Step Instructions
Step 1: Open Sub-Merchants
1. Log in to your Niobi account.
2. In the left sidebar, expand the Workspace section.
3. Click Sub-Merchants.
You'll see a table listing all sub-merchants added to your workspace, including their:
- ID
- Name
- Status
- Website
- Business Activity
- Incorporation Country
- Transaction Country
- Date Created
Step 2: Add a New Sub-Merchant
1. From the Sub-Merchants page, click Add Sub-Merchant in the top-right corner.
2. A note will remind you: "Please contact our Compliance Team to confirm that this sub-merchant aligns with our compliance policies." If you're unsure whether a business qualifies, reach out to your Compliance Team before or during submission.
3. Enter the sub-merchant's details:
- Legal Name\* — The business's registered legal name, such as "ABC Corporation Ltd."
- Brand Name — The business's public-facing name, if different from the legal name. This field is optional.
- License Type\* — The type of license the business holds, such as "Money Transfer License."
- License Jurisdiction\* — The regulator or jurisdiction that issued the license, such as "Central Bank of Kenya."
- Website\* — The business's website URL.
- Business Activity\* — A short description of what the business does, such as "E-commerce, SaaS, Retail."
- Incorporation Country\* — Select the country where the business is legally incorporated.
- Transaction Country\* — Select the country where the business will be transacting.
4. Click Create Sub-Merchant to submit the information, or Cancel to discard your entry.
Note: Fields marked with an asterisk (\*) are required.
Step 3: Understand Sub-Merchant Statuses
Once submitted, a sub-merchant is assigned a status. You can view the status in the table and see a summary at the bottom of the page.
The available statuses are:
- In Review — The submission is being checked against compliance policies.
- Active — The sub-merchant has been approved and is