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.
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.