> ## 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 看板与数据分析

> 如何读懂商户 Portal 的各看板：首页数据的更新时效与结算日历、Payments Analytics 指标定义、Chargeback Analytics 的比率与统计周期，以及交易、退款和结算导出背后的规则。

本页说明商户 Portal 各看板分别统计什么、统计周期是什么，以及这些数字背后的导出是如何生成的。结算机制见[商户结算](/docs/zh/essentials/merchant-settlement)。

## 为什么今天的交易在首页看板上看不到？

首页看板是一个 **T-1 视图**：展示截至昨天的最近两周，今天及之后的日期无法选择。数字**按订单币种**分组——您可以在合同上的各收单币种之间切换（超过九个时变为下拉框）。指标包括成功支付金额与笔数、成功退款金额与笔数（含部分退款和全额退款），各自配有趋势图。如果前一天的数据尚未刷新完成，页面会明确提示，而不是展示不完整的数字。

## 首页的未结算金额包含什么？结算日历怎么看？

未结算金额按币种展示，覆盖您曾签约过的每一个收单币种，等于**所有已打包结算单的结算金额之和，不含费用**。今天的交易尚未打包——打包之前无法计算费用——所以这个数字不是实时的，也无法与今天的交易列表对上。负数原样展示。首页还列出您接下来三次结算的金额和预计结算日期。

日历覆盖接下来三个自然月；今天及之后的日期可选，更早的不可选。选中的某一天要么不是结算日，要么是尚未结算的结算日（带预计金额，或显示"无可结算金额"），要么已成功结算，要么结算失败。预计金额来自计划于当天结算的已打包结算单，并且**如果某天净额为负，差额会向后结转**，在下一个结算日抵扣，该日随即显示净额。

## Payments Analytics 覆盖什么？各比率是怎么定义的？

**Transactions → Payments Analytics** 覆盖一次性支付和直接支付；订阅不在范围内。当您的合同允许多币种下单时，订单币种为必选；时间粒度（半小时、一小时、天、周）默认不切分；支付方式类型为单选，支付方式为多选，仅限 Active 状态的方式，且由您选择的币种和类型决定。整体视图、单一类型或单一支付方式下您看到的是**漏斗图**，选中多个支付方式后则显示**表格**——当一个币种加一个支付方式对应多个配置时按国家拆分。

漏斗有三个计数——创建的订单总数、在收银台成功创建的支付订单数、成功订单数——各比率完全按指标提示所述基于这三个数计算：

| 指标 | 定义 |
| - | - |
| Checkout Conversion Rate（CCR） | 收银台成功订单 ÷ 订单总数 |
| Payment Conversion Rate（PCR） | 成功订单 ÷ 收银台成功订单 |
| Success Rate | 成功订单 ÷ 订单总数 |

因此 CCR 衡量有多少已创建订单进入了支付尝试，PCR 衡量有多少尝试完成了支付，Success Rate 是二者的乘积。订阅产品可按首期和续订分别查看。

## Chargeback Analytics 里的比率卡片衡量什么？

**Analytics → Chargeback Analytics** 展示四个比率卡片，每个卡片的提示中都写明了分子和分母：

| 卡片 | 分子 | 分母 |
| - | - | - |
| Visa Chargeback Rate | 欺诈报告（TC40）+ 首次拒付（TC15） | 已结算的成功卡交易 |
| Visa Fraud Rate | 欺诈报告（TC40）+ 欺诈原因码的首次拒付（Visa 原因码 10.4） | 已结算的成功卡交易 |
| Mastercard Chargeback Rate | 首次拒付，任意原因码 | 已结算的成功卡交易 |
| Mastercard Fraud Rate | 标记为欺诈的首次拒付（仅原因码 4837） | 已结算的成功卡交易 |

每个卡片都带有卡组织的预警阈值；超过阈值后数值变红，并显示超出多少。页面标注了两点提醒。这些是**运营预警数字，不是卡组织的合规计算**——那些计划使用错位的月度窗口，而且欺诈报告覆盖并不完整，所以您真实的合规比率可能高于所显示的数值。另外，拒付数据会随案件裁决而修正，因此请以最新值为准，而不是您早先记下的数值。

## Chargeback Analytics 统计的是哪个周期？

日期筛选默认是本月 1 日到今天，所以卡片是**月初至今**。自定义范围会把所有关联卡片、趋势图和原因码图切换为该范围的累计值，这不是月度合规视图；开始和结束为同一天时，按该月 1 日到该日处理。此时 Chargeback Count 覆盖该周期内创建的所有案件，已取消的除外。

* **Chargeback Amount** 是争议金额加拒付费用，展示时换算为 USD（悬停可看两部分），且不区分胜诉与败诉。
* **Expiring Soon** 是实时的，并且**忽略所有筛选**，包括卡品牌：它始终显示所有仍待您回复且截止日期临近的争议，点击会打开已应用该筛选的 Disputes 列表。
* **Reason Code distribution** 展示前 10 个原因码加"Others"，图内有全部品牌、Visa 或 Mastercard 的页签，可独立于页面筛选切换。

## 交易、退款和结算导出有什么规则？

导出是所见即所得：根据列表当前应用的筛选生成。它们与[对账报表](/docs/zh/developer-docs/tools-and-references/references/reconciliation-reports)中描述的定时结算报表文件是分开的。

* **日期跨度上限为 31 天**；更宽的范围会在生成文件前被拦截。
* 文件名为 `payments_{mid}_{from}_{to}.csv` 和 `refunds_{mid}_{from}_{to}.csv`，两个日期均为 UTC+8 的 `YYYYMMDD`；结算历史导出为 `Settlements_{MID}_{download time}.csv`。
* **空结果仍会生成文件**，仅含表头行，因此"没有匹配的交易"与"导出失败"可以区分。
* 文件包含的列比列表多——包括 `Original Order Id`、`Merchant Id`、`Transaction Type`、`Order Description`、`Product Name`、`Merchant User Id` 和 `Settlement Status`——并把列表中单一的 `Order Amount` 单元格拆成 `Order Amount` 加 `Order Currency`。
* 时区在列名中明确标注：`Created Datetime(UTC+8)`、`Payment Request Datetime(UTC+8)`、`Payment Datetime(UTC+8)`，格式为 `YYYY-MM-DD hh:mm:ss`。在 Portal 中，所有结算相关标签都标注了 UTC+8，其他时间戳均按您的本地时区。
* `Settlement Status` 为 `-` 表示该交易尚未结算（字段为 null），不表示结算失败；结算执行后会变为 `SETTLE_SUCCESS`、`SETTLE_FAIL` 或 `SETTLE_FAIL_NEED_RETRY`。


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