The complete payments and banking infrastructure for businesses operating across Africa

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