> ## Documentation Index
> Fetch the complete documentation index at: https://ownpay.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> OwnPay is licensed under AGPL-3.0 and is completely free - no licensing fees.
> Production docs URL: https://ownpay.org/docs - append .md to any page URL for clean markdown.
> OwnPay requires PHP 8.3+, MySQL/MariaDB, and Redis.
> MCP server available at https://ownpay.org/docs/mcp for programmatic documentation queries.
> Use root-relative links (e.g. /quickstart) for internal navigation - do NOT include /docs prefix.
> Plugin development: consult /developer/plugin-types/ pages for correct interfaces and manifests.

# Admin Dashboard - Transaction Volume, Revenue, and KPIs

> Real-time overview of transaction volume, revenue, gateway status, and brand-wide statistics shown on the OwnPay admin dashboard home screen.

The Admin Dashboard gives you a central workspace for monitoring your payment platform. You can view business metrics, transaction trends, and quick-access navigation. View all brands globally or filter by a specific brand.

## Getting here

1. Log in to your OwnPay account
2. Click **Dashboard** at the top of the left sidebar

## Page sections

### 1. Header navigation bar

* **Sidebar Toggle:** Hides or expands the main navigation sidebar
* **Brand Context Dropdown:** Switch between **Global View** (super-administrator aggregate) and individual **Brand/Store** views
* **Global Search:** Search transactions, customers, or invoices
* **Theme Toggle:** Switch between Dark and Light mode themes
* **User Menu:** Access your account settings or log out

### 2. Key performance indicators (KPIs)

A row of cards displaying quick stats for the selected time range:

* **Total Revenue:** Total value of all completed transactions (converted to your base currency)
* **Completed:** Count of transactions successfully paid
* **Pending:** Count of transactions waiting for customer payment or SMS verification
* **Customers:** Total number of unique customers registered

### 3. Recent transactions list

Shows the most recent payment attempts, allowing quick verification of incoming transactions. Each entry lists:

* **TRX ID:** The system-generated unique transaction identifier
* **Customer:** The customer name or email
* **Amount:** The transaction amount and currency
* **Gateway:** The gateway through which the payment was routed
* **Status:** Current status of the transaction (e.g., `completed`, `pending`, `cancelled`)
* **Date:** Timestamp of the transaction

## Fields and options reference

| Field / Option          | Type     | Required | Default     | Description                                                                          |
| ----------------------- | -------- | -------- | ----------- | ------------------------------------------------------------------------------------ |
| **Brand Selector**      | Dropdown | Yes      | Global View | Filter all dashboard cards and transaction lists to a specific brand context         |
| **Time Range Selector** | Dropdown | Yes      | Today       | Filter the metric cards. Options: `Today`, `Last 7 Days`, `Last 30 Days`, `All Time` |
| **View All**            | Link     | No       | -           | Redirects to the complete Transactions List page                                     |

## Step-by-step: how to use this page

### Filtering metrics by brand and time

1. Go to the header bar and click the **Brand Selector** dropdown
2. Select the specific brand you wish to inspect (e.g., `My Custom Brand`)
3. Locate the **Time Range Selector** in the main content header
4. Select a range (e.g., **Last 30 Days**) to see performance over the past month

### Inspecting a recent transaction

1. Find the transaction in the **Recent Transactions** table
2. Click the row of the transaction
3. The system will load the transaction details panel, where you can inspect customer payment proofs, fee breakdowns, and raw ledger entries

## Best practices

* Check the **Ledger** page to verify the double-entry bookkeeping balance matches the total revenue shown on the dashboard
* Use the **Global View** to compare overall performance across your different white-label store domains
* Investigate a high number of **Pending** transactions; check if the SMS Parser device is online and receiving notification templates

<Warning>
  When reviewing statistics, always double-check the selected **Brand Context** in the top header. Confusing a single brand's metrics with global aggregated metrics can lead to reporting errors.
</Warning>

## Common mistakes and troubleshooting

| Symptom                                             | Likely Cause                                                                                      | Fix                                                                                                      |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Dashboard metrics show `0.00` and no transactions   | The selected Brand has no transactions yet, or the Time Range is set to a period with no activity | Switch the Time Range selector to **All Time** or check that you have selected the correct Brand Context |
| Cannot see the "Global View" option in the dropdown | Your user account is a Staff account and does not have super-admin privileges                     | Log in with a super-administrator account to view global aggregations                                    |

## Related pages

* [Transactions](/user-guide/payments/transactions) - View and manage the complete list of transactions
* [Ledger](/user-guide/payments/ledger) - Detailed double-entry financial accounts
* [Brands](/user-guide/people/brands) - Set up and configure brand settings


## Related topics

- [Retrieve Dashboard Summary](/docs/api-reference/retrieve-dashboard-summary.md)
- [Reports - Transaction Volume, Fees, and CSV Export](/docs/user-guide/reports-finance/reports.md)
- [Transactions - View Payments, Refunds, and Gateway Status](/docs/user-guide/payments/transactions.md)
- [Customers - Profiles, Transaction History, and Methods](/docs/user-guide/people/customers.md)
- [Payment Flow - End-to-End Transaction Lifecycle](/docs/concepts/payment-flow.md)
