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

# 首页看板

> Portal 首页看板如何统计：Today 面板的三个 TPV 基线、TPV / Txns / ASP 的定义、产品拆分、五种时间粒度、Compare 对比，以及切换展示币种会换算什么、不会换算什么。

首页看板是登录 Merchant Portal 后进入的业务总览页面。它对已开通的账户可用——**如果你在首页能看到它，说明已对你启用**；未开通的账户保留原来的首页布局。结算机制见 [Merchant Settlement](/docs/zh/essentials/merchant-settlement)。

页面分为两个独立区域。**Today** 只覆盖当天，从 `00:00` **UTC+8** 起算，并按短间隔自动刷新（其提示框会说明确切频率）。**Your overview**——Payment 和 Refund 两个标签页——覆盖你选择的任意区间，最晚到昨天，基于 T-1 离线数据。

## Today 面板里的三个 TPV 数字分别是什么？

| 数字（均为所选展示币种） | 范围 |
| - | - |
| **Total TPV**（大数字） | 今天，从 `00:00` UTC+8 到最新可用小时 |
| **/ …（Yesterday TPV）** | 昨天**全天**——一个已完结的日子，用来衡量今天的体量 |
| **vs same time yesterday**（角标） | 昨天**仅累计到当前小时**，因此对比是同口径的 |

当昨天同一时点的数字为零或缺失时，角标会隐藏——而不是显示为零。**TPV Trend** 图绘制今天和昨天两条累计曲线，交易量按**每小时起点**分桶：`00:00–00:59` 显示在 `00:00`。

旁边的两个小卡片同样只统计今天，与页面下方选择的日期区间无关：**Refunded** 是今天*已完成*的退款，**Refunds in Progress** 是*已发起但尚未完成*的退款。注意 **Total TPV 包含已退款的订单**——退款与之并列展示，从不从中扣减。

## 为什么 Today 面板提示数据延迟？

今天的数字来自一条会上报自身新鲜度的实时管道。当它落后时，面板会显示横幅而不是悄悄展示部分数字，并标出它已有的最后一个完整小时：*Data updated to `HH:00`*。屏幕上的数字在该小时之前仍然有效；如果今天还没有任何一个小时的数据落地，横幅会请你稍后刷新，而不是给出时间戳。

有两个细节是刻意设计的：**最后刷新时间**是此视图拉取数据的时间，不是你最后一笔订单的时间；延迟状态**只影响 Today**——Payment 和 Refund 标签页跑在独立的 T-1 管道上。

## TPV、Txns 和 ASP 到底是什么意思？

| 指标 | 定义 | 统计口径 |
| - | - | - |
| **TPV** | 成功支付金额，包含已退款订单 | 订单创建时间 |
| **Txns** | 成功支付笔数 | 订单创建时间 |
| **ASP** | 平均售价 = **TPV ÷ Txns** | 由上述两项推导 |
| **Refund Amount** | 退款总金额 | 退款发起时间 |
| **Refund Count** | 退款笔数 | 退款发起时间 |

由于 TPV 是毛额——包含已退款订单、不扣手续费和税费、按参考汇率换算——它不会等于结算金额。凡需要与实收资金对账的场景，请使用结算批次及其对账报表。

## 为什么在 "Your overview" 里选不了今天？

Payment 和 Refund 标签页读取 T-1 数据，所以日期选择器止于**昨天**。默认打开为**截至昨天的最近 30 天**，超过**一年**的区间会被拒绝并提示 *Date range cannot exceed 1 year*。今天的数据由 Today 面板负责。

## 五种粒度会改变什么？

`Daily`、`Weekly`、`Monthly`、`Quarterly` 和 `Yearly` 改变趋势图中区间的分桶方式。每个桶以**周期首日**标注为 `YYYY-MM-DD`——`Weekly` 为周一，`Monthly` 为 1 日，`Quarterly` 和 `Yearly` 为首月 1 日。在 `Daily` 下，没有交易的日期绘制为零，以保持坐标轴连续。

## Compare 是怎么工作的，为什么 Δ% 是空的？

`Compare to` 提供 **Previous period** 和 **Custom**。Previous period 自动为你推导对比窗口；Custom 需要选第二个日期区间，两个日期都设置之前不会发起查询。开启 Compare 后，每个金额和数量——汇总指标、产品拆分、表现表格的行——都带有 Δ% 角标，悬停趋势点会显示对比窗口中对应的桶。当对比值为零或缺失时，Δ% 刻意**留空（—）**：零基线上不存在增长百分比，因此不会凭空造一个数字。

## 切换展示币种到底会换算什么？

页面上的所有内容都以同一个**展示币种**表示，默认 `USD`（始终提供，即使你从不用它交易），你自己的交易币种也会一并列出。金额按**参考汇率**换算，因此有一条信息横幅提醒你该数字是估算值，最终结算汇率可能不同。这里的换算仅用于展示，**不影响结算**。

有一列是刻意例外的：`By currency` 表格中的 **TPV (local)** / **Refund Amount (local)** 列保存该行自身币种的原始金额——不换算，切换展示币种时不变，也没有 Δ% 角标。

如果你选择的币种没有可用的参考汇率，切换会被拒绝，选择器保持原位，并提示汇率不可用或无效。

## 产品拆分和表现表格怎么看？

**产品拆分**把该周期拆为 **One-time Payment** 和 **Subscription**，各自有金额、笔数以及占总 TPV 的比例。在 Payment 标签页，Subscription 进一步拆为 **New Subscription** 和 **Subscription Renewal**。Refund 标签页只显示两个顶层分组。

**表现表格**在 Payment 标签页有两个视图：

| 视图 | 行 | 额外内容 |
| - | - | - |
| **By currency** | 周期内的每个币种，不截断 | 本币金额列 |
| **By payment method** | 按金额 **Top 10**，其余折叠为一行 **Others**，并显示它覆盖了多少种支付方式 | 每种支付方式的 TPV Trend 迷你图；**Region** 筛选 |

Region 多选只作用于 **By payment method** 视图——不会重新筛选汇总指标、产品拆分或趋势图。Refund 标签页只有一个 `By currency` 视图，没有 Region 筛选。

***

数字仍然对不上？请[联系支持](mailto:support@waffo.com)，并附上你当时查看的日期区间、粒度和展示币种。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.