Total Merchants
Total number of merchants registered under your partner account. Includes a trend percentage showing growth compared to the previous period.
Dashboard and Analytics
The Dashboard is the landing page of the Partner Portal. It provides a real-time overview of your merchant network’s performance and health.
Welcome Section
Section titled “Welcome Section”At the top of the dashboard, a personalized greeting includes your first name (e.g., “Welcome back, John”) and a brief description of the page purpose. When data is refreshing in the background, an “Updating…” indicator appears next to the greeting.
Metrics Cards
Section titled “Metrics Cards”Four key performance indicator (KPI) cards are displayed in a row at the top of the dashboard:
Active Merchants
Merchants who have been active recently. Displays the active rate as a percentage (e.g., “82.5% active”).
GMV (30 days)
Gross Merchandise Value — total sales volume across your merchants in the last 30 days. Displayed in Nigerian Naira (₦) with a trend percentage.
Transactions
Total number of sales transactions across your merchants. Includes a trend percentage showing growth.
Understanding trend indicators: Each metric card can display a trend percentage. A positive percentage (shown in green) indicates growth compared to the previous period. A negative percentage (shown in red) indicates decline. Use these trends to quickly assess whether your merchant network is growing or contracting.
Activity Chart
Section titled “Activity Chart”Below the metrics cards, the left two-thirds of the screen displays an Activity Chart — a bar chart showing daily Gross Merchandise Value (GMV) over the last 7 days. This chart helps you identify:
- Peak days — Which days of the week see the most merchant activity.
- Trends — Whether overall activity is increasing or decreasing.
- Anomalies — Sudden drops that might indicate issues affecting merchants.
At-Risk Alert
Section titled “At-Risk Alert”On the right side of the dashboard (below the Activity Chart on mobile), an At-Risk Alert panel appears when one or more merchants have been inactive for 14 or more days.
The alert:
- Shows the exact count of at-risk merchants (e.g., “5 merchants at risk”).
- Describes the inactivity threshold (“inactive for 14+ days”).
- Provides a direct link to view the filtered at-risk merchants list.
If no merchants are at risk, this panel does not appear — a clean dashboard is a positive signal.
Quick Actions
Section titled “Quick Actions”Below the at-risk alert (or in its place when no alert is shown), a Quick Actions panel provides shortcuts to common tasks:
| Action | Description | Navigates To |
|---|---|---|
| View Merchants | Open the full merchant list | /merchants |
| Generate Report | Create an analytics report | /reports/generate |
| API Keys | Manage your API integration keys | /settings/api-keys |
| Add Merchant | Onboard a new merchant to your network | /merchants/new |
Top Merchants Leaderboard
Section titled “Top Merchants Leaderboard”At the bottom of the dashboard, the Top Merchants section ranks your highest-performing merchants by GMV. Each entry shows:
| Column | Description |
|---|---|
| Rank | Position in the leaderboard. Top 3 display a trophy icon (gold, silver, bronze). Ranks 4+ show a numeric position. |
| Business Name | The merchant’s registered business name |
| Tier Badge | Colored badge indicating performance tier: Gold, Silver, Bronze, or Standard |
| Transaction Count | Number of transactions in the current period |
| GMV | Total Gross Merchandise Value in compact Naira format (e.g., “1.2M”) |
| Growth | Percentage growth compared to the previous period (green for positive, red for negative) |
Click any merchant in the leaderboard to navigate directly to their detail page. A “View all” link in the header takes you to the full merchants list sorted by GMV.
Auto-Refresh
Section titled “Auto-Refresh”The dashboard data refreshes automatically every 5 minutes. You do not need to manually reload the page. When a refresh is in progress, a subtle “Updating…” indicator with a spinner appears in the welcome section.
The Analytics Page
Section titled “The Analytics Page”Beyond the dashboard summary, the Analytics page (in the sidebar) gives a deeper, filterable view of your merchant network’s performance.
Time Period
Section titled “Time Period”A period selector at the top lets you switch the whole page between 7 Days, 30 Days, 90 Days, or a Custom date range. Every chart and table below updates to match.
Overview Metrics
Section titled “Overview Metrics”Four headline cards summarise the selected period:
| Metric | What It Shows |
|---|---|
| GMV | Gross Merchandise Value — total sales across your merchants |
| Active Merchants | Merchants with activity in the period |
| Transactions | Total number of sales |
| Avg GMV / Merchant | Average sales volume per merchant |
Revenue and Transaction Trends
Section titled “Revenue and Transaction Trends”Two charts show how your network is trending over the period:
- Revenue Trend — GMV over time, to spot growth or decline.
- Transaction Volume — number of sales over time, to see how activity moves.
Merchant Performance
Section titled “Merchant Performance”A sortable table ranks your merchants so you can compare them directly. Click a column header to sort by that measure (for example, by GMV or transaction count).
Industry Breakdown
Section titled “Industry Breakdown”A donut chart breaks your merchants down by industry / business type, so you can see which kinds of business make up your network. Smaller categories are grouped into an “Other” slice.
Geographic Distribution
Section titled “Geographic Distribution”A by-state breakdown shows where your merchants are concentrated across Nigeria, ranked by merchant count. States are shown by their full names (e.g., “Lagos”, “Federal Capital Territory”), so you can read the distribution at a glance.
Loading and Error States
Section titled “Loading and Error States”- Loading: When the dashboard is first loading, skeleton placeholder elements are displayed in place of each section, giving a visual indication that data is being fetched.
- Error: If the dashboard fails to load (e.g., due to a network issue), an error message is displayed with a “Retry” button. Click Retry to attempt loading the data again.
Monitoring Best Practices
Section titled “Monitoring Best Practices”- Check the dashboard daily to stay on top of merchant network health.
- Act on at-risk alerts promptly. A merchant inactive for 14 days is unlikely to return without intervention.
- Track GMV trends weekly. A sustained decline in GMV may signal broader issues affecting your merchant base.
- Compare peak days to identify which days of the week are most active and schedule outreach accordingly.
- Monitor the leaderboard for changes in your top merchants’ performance. A top merchant suddenly declining may need priority support.
Dashboard Troubleshooting
Section titled “Dashboard Troubleshooting”| Problem | Possible Cause | Solution |
|---|---|---|
| Dashboard shows error state | Network connectivity issue or server downtime | Click the Retry button. If the problem persists, check your network connection. |
| Metrics show zero | New partner account with no merchants | Expected for new accounts. Metrics populate as merchants are onboarded. |
| Data appears stale | Auto-refresh may have failed | Manually reload the page (Ctrl/Cmd + R). |
| Page not loading | Network or server issue | Check that you are connected to the internet and that SabiBooks services are running. |
Related Pages
Section titled “Related Pages” Merchant Management Search, filter, and monitor individual merchants in detail.
Partner Portal Overview Portal introduction, login, navigation, and roles.