Merchant Management

The Merchants page (/merchants) displays all merchants registered under your partner account in a searchable, filterable table.

Merchant List

Searching for Merchants

At the top of the page, a search bar lets you find merchants by name, phone number, or email address. The search is debounced — it waits briefly after you stop typing before executing the query.

Tip

Search tips:

• By business name: Type part of the name (e.g., “Mama” finds “Mama Chidi Provisions”).
• By phone: Enter a phone number in any format.
• By email: Enter part of an email address.

Filtering Merchants

Below the search bar, filter controls let you narrow down the merchant list:

Filter	Options	Purpose
Status	Active, Suspended, Trial, Expired	Show only merchants in a specific account state
Date Range	Start date, End date	Filter by merchant registration date
At-Risk	Toggle	Show only merchants who have been inactive for 30+ days

When filters are active, filter chips appear below the controls showing each active filter. You can:

• Click the X on individual chips to remove specific filters.
• Click Clear all to reset all filters at once.

The result count is displayed above the table (e.g., “150 merchants found” or “No merchants found”).

Tip

Bookmark your filters. All filter and sort parameters sync to the browser URL, so you can bookmark a filtered view and return to it later, or share it with a colleague.

Merchant Table

The table displays the following columns for each merchant:

Column	Description	Sortable
Business Name	Registered business name	Yes
Owner	Name of the business owner	No
Phone	Contact phone number	No
Status	Current account status (colored badge)	Yes
Plan	Subscription plan (Free, Starter, Professional, Enterprise)	No
Created	Registration date	Yes
Last Active	Date of most recent activity	Yes
GMV	Gross Merchandise Value	Yes

Sorting: Click any sortable column header to sort the table. Click again to toggle ascending/descending order. The current sort is reflected in the URL, so sorted views can be bookmarked and shared.

Pagination: The table shows 20 merchants per page. Navigation controls at the bottom let you move between pages. The total count and current range are displayed (e.g., “Showing 1-20 of 150 merchants”).

Row click: Click any merchant row to navigate to their detail page.

URL Bookmark Sync

All filter and sort parameters are synchronized with the browser URL query string:

• Bookmark a filtered/sorted view and return to it later.
• Share a URL with a colleague for the same filtered view.
• Browser back/forward navigation works correctly with filter states.

Merchant Detail View

Clicking a merchant from the list opens their detail page (/merchants/:id).

A Back to Merchants link at the top left returns you to the merchant list. The merchant’s business name and status badge are displayed as the page title.

Business Information Card

Field	Description
Business Name	Registered name of the business
Business Type	Category of business (e.g., retail, restaurant, wholesale)
Address	Physical business location
Phone	Business contact number
Email	Business email (if provided)
Registration Date	When the business was created on the platform

Owner Information Card

Field	Description
Owner Name	Full name of the business owner
Phone	Owner’s personal phone number
Email	Owner’s email address (if different from business)

Subscription Card

Field	Description
Plan	Current subscription tier: FREE, STARTER, PROFESSIONAL, or ENTERPRISE
Status	Whether the subscription is active, expired, or in trial
Features	Key features available under their plan

30-Day Performance Metrics

A metrics card shows the merchant’s activity over the last 30 days:

Sales Amount

Total sales value in Naira over the last 30 days.

Sales Count

Number of individual sale transactions.

Average Transaction

Mean transaction value (Sales Amount / Sales Count).

Product Count

Number of products currently in their inventory.

Active Days

Days with at least one recorded activity in the last 30 days.

These metrics help you assess merchant health at a glance. A merchant with declining sales or few active days may need outreach.

Activity Timeline

At the bottom of the detail page, a timeline shows the merchant’s last 10 events in chronological order. Events include:

• Sales completed
• Products added or updated
• Stock adjustments
• Login activity
• Subscription changes

Each event entry includes a timestamp and description.

Understanding Merchant Health

Use these indicators to assess whether a merchant needs attention:

Signal	Healthy	Needs Attention	At Risk
Active Days (30d)	20+ days	10-19 days	Under 10 days
Sales Trend	Growing or stable	Declining slightly	Significant decline
Last Active	Within 3 days	4-13 days ago	14+ days ago (triggers alert)
Transaction Volume	Consistent with history	Below average	Near zero

Recommended Actions for At-Risk Merchants

1. Contact the merchant to understand if they are experiencing issues.
2. Check if there are technical problems (e.g., POS connectivity).
3. Offer training or support on features they may not be using.
4. Review their subscription plan — they may need features from a higher tier.

Best Practices

• Use filters to create focused views. For example, filter by “Trial” status to see merchants who haven’t committed to a paid plan.
• Bookmark commonly used filter combinations using the URL sync feature.
• Review merchant detail pages before making outreach calls. Understanding a merchant’s recent activity makes conversations more productive.

Merchant List Troubleshooting

Problem	Possible Cause	Solution
Search returns no results	Search term does not match any merchant	Try searching by a different field (name, phone, or email). Check for typos.
Filters show no merchants	Filters are too restrictive	Use the “Clear all” button on the filter chips to reset.
Page not loading	Network connectivity issue or server downtime	Check your network connection and try again.

Related Pages

Dashboard and Analytics Monitor merchant network performance with key metrics and trends.

Partner Portal Overview Portal introduction, login, navigation, and roles.