> ## Documentation Index
> Fetch the complete documentation index at: https://afrizon-admin.tunzaa.co.tz/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboard and manage vendors in your marketplace

> Learn how to view, filter, and manage vendors in Meneja, including key profile fields, status filters, and how to add new vendors.

Vendors are the businesses and sellers that operate storefronts on your platform. Each vendor has a profile that captures their business identity, contact details, commission agreement, location, and verification status. You manage all vendors from the **Vendors** section of the Meneja dashboard — viewing the full list, filtering by status, drilling into individual profiles, and onboarding new sellers.

## The vendor list

The vendor list gives you a paginated table of every vendor registered on your platform. Each row shows the vendor's business name, contact email, city, verification status, and active status at a glance.

| Column          | Source field                     | Description                                              |
| --------------- | -------------------------------- | -------------------------------------------------------- |
| Business        | `business_name`                  | Legal name of the vendor's business                      |
| Contact         | `contact_email`, `contact_phone` | Primary email and phone number                           |
| City            | `city`                           | City from the vendor's address                           |
| Approval status | `verification_status`            | KYC review outcome: `pending`, `approved`, or `rejected` |
| Status          | `is_active`                      | Whether the vendor is currently active on the platform   |

Click any row to open the vendor's detail page.

## Filtering the vendor list

You can narrow the list using the filter bar above the vendor table.

| Filter          | Field                 | Accepted values                                 |
| --------------- | --------------------- | ----------------------------------------------- |
| Search          | `search`              | Free-text search against vendor name or email   |
| Approval status | `verification_status` | `pending`, `approved`, or `rejected`            |
| Active status   | `is_active`           | `true` (active only) or `false` (inactive only) |
| Pagination      | `skip`, `limit`       | Offset and page size for large result sets      |

<Tip>
  Use `verification_status=pending` to quickly surface vendors that are waiting for KYC review before they can go live.
</Tip>

## Key vendor fields

When you open a vendor's profile, you see the full set of fields in their record.

| Field                                                | Description                                                  |
| ---------------------------------------------------- | ------------------------------------------------------------ |
| `business_name`                                      | Legal business name used in contracts and payouts            |
| `display_name`                                       | Public-facing name shown to shoppers on the storefront       |
| `contact_email`                                      | Primary contact email; also used for login and notifications |
| `contact_phone`                                      | Primary contact phone number                                 |
| `commission_rate`                                    | Percentage of each sale collected as platform commission     |
| `location`                                           | Geographic coordinates (`lat`, `long`) of the business       |
| `address_line1`, `city`, `state_province`, `country` | Full mailing address                                         |
| `tax_id`                                             | Optional tax identification number                           |
| `website`                                            | Optional vendor website URL                                  |
| `verification_status`                                | Current KYC status: `pending`, `approved`, or `rejected`     |
| `is_active`                                          | Controls whether the vendor's store is live on the platform  |

<Note>
  `business_name` and `display_name` can differ. The business name is your internal legal record; the display name is what customers see.
</Note>

## Adding a new vendor

The new vendor form is divided into six tabs. You must complete them in order before you can submit.

<Steps>
  <Step title="Open the new vendor form">
    Navigate to **Vendors** in the sidebar, then click **Add vendor**.
  </Step>

  <Step title="Fill in business information">
    Enter the vendor's `business_name`, `display_name`, owner first and last name, `contact_email`, `contact_phone`, and `commission_rate`. Website and tax ID are optional.
  </Step>

  <Step title="Configure the store">
    Provide a store name, description, and select at least one product category. You can also set store branding and banners here. See [Manage vendor stores](/vendors/stores) for details.
  </Step>

  <Step title="Enter the business address">
    Fill in `address_line1`, `city`, `state_province`, postal code, and country. Use the map picker to pin the exact coordinates.
  </Step>

  <Step title="Add banking information">
    Enter the bank name, account name, and account number for vendor payouts. SWIFT code and branch code are optional.
  </Step>

  <Step title="Upload verification documents">
    Upload KYC documents such as business registration certificates. Each document goes through a separate review. See [Verify vendor identity](/vendors/verification) for details.
  </Step>

  <Step title="Review and save">
    Check all entered information on the **Review** tab, then click **Save vendor**.
  </Step>
</Steps>

<Warning>
  A newly created vendor starts with a `verification_status` of `pending` and `is_active` set to `false`. The vendor's store will not be visible to shoppers until you approve their KYC documents and activate the account.
</Warning>