> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 报告
> 对账余额，查看每项费用，并将任意日期范围内的付款、调整、付款出账和余额账本导出为 CSV 或 XLSX。
## 简介
**报告**用于跟踪资金流动并生成导出文件。前往
**设置 → 报告**。
该页面包含三个部分：
两个实时视图，用于在页面上说明您的余额和费用。
四种导出文件，可针对日期范围生成 CSV 或 XLSX。
您之前生成的每份报告都可以再次下载。
报告同时适用于**测试模式**和**生产模式**，每种模式只读取该模式的数据。生成报告前，请在侧边栏中切换模式。
***
## 跟踪资金流动
两个视图可以直接在页面上回答问题，无需下载。每个视图都需要选择日期范围，并提供一个**导出**按钮，可将相同视图保存为文件。
### 余额和付款出账摘要
此视图用于对账期间内的余额，包含三个区块。
**余额摘要**显示该期间从开始到结束的完整情况。
| 行 | 含义 |
| ---------- | ------------------- |
| 期初余额 | 期间开始时的余额。 |
| 活动导致的净余额变动 | 期间内发生的所有变动，不包括付款出账。 |
| 付款出账总额 | 通过付款出账转出的资金。 |
| 期末余额 | 期初余额 + 活动变动 − 付款出账。 |
**活动导致的余额变动**将中间一行拆分为各个组成部分。
| 行 | 包含内容 |
| ------ | --------------------------------------------------------- |
| 收到的付款 | 成功的付款。 |
| 已发起的退款 | 退款和退款费用，减去其中任一项的冲销。 |
| 失败的争议 | 争议和争议费用，减去任何争议冲销。 |
| 扣除的费用 | 付款费用、付款出账费用、催收费用、付款重试费用、BYOP 费用、弃购恢复费用和 Ethoca 费用，减去任何冲销。 |
| 扣除的税费 | 税费，减去任何税费冲销。 |
| 其他变动 | Dodo Credits、手动调整和货币转换。 |
| 净余额变动 | 上述各行的总和。 |
**其他变动**包含不属于上述任何命名行的条目：**Dodo Credits**（Dodo Payments 应用到您余额中的额度）、**手动调整**（由我们的团队发布的更正）以及**货币转换**（余额在不同货币之间转换时记录的差额）。
**付款出账对账**会将该期间内的每笔付款出账单独列出，并显示总额、每项扣除额和实际支付的净额。
一笔付款出账会认领截至其截止日期之前的所有未认领账本条目，而不仅仅是该期间内的付款。因此，Dodo Credits 和调整可能会为付款出账提供部分资金，并显示在**其他**下。
### 全部费用
显示该期间从余额中扣除的每项费用，包括总额和按交易划分的明细。
***
## 下载报告
四种报告可针对任意日期范围生成文件。每种报告都会打开一个面板，供您选择期间、格式以及该报告的筛选条件。
每种报告都可以导出为 **CSV** 或 **XLSX**。
| 报告 | 包含内容 |
| ---------- | -------------------------- |
| **交易报告** | 处理的每笔付款，以及每笔交易的状态。 |
| **调整报告** | 将退款和争议合并在一个文件中，包含所有余额扣除。 |
| **付款出账报告** | 付款出账摘要，以及每个付款出账期间的完整费用明细。 |
| **账本对账报告** | 余额账本，每个变动占一行，用于与银行对账单进行核对。 |
### 交易报告
* **付款方式** — Card、UPI、Wallet、Bank Transfer、Bank Redirect、Pay Later、Crypto 或 Bank Debit。选择**全部**以包含所有方式。
* **付款状态** — Succeeded、Failed 或 Pending。
### 调整报告
* **调整类型** — All、Refunds 或 Disputes。
* **付款方式** — 与上方相同的八种方式。
* **退款状态** — Succeeded、Failed 或 Pending。
* **争议状态** — Opened、Challenged、Accepted、Lost、Won、Cancelled 或 Expired。
### 付款出账报告
选择期间和格式。此报告不需要其他筛选条件。
### 账本对账报告
此报告有两种模式。使用**对账方式**选择其中一种。
**期间**导出日期范围内的每笔账本变动。
**付款出账 ID**导出一笔付款出账的变动。输入付款出账引用
（例如 `pyt_kxncrebha`），即可获取该付款出账结算的确切行。
不存在的付款出账 ID 会返回错误，而不会返回空文件。
**事件类型**按余额变动的类型筛选行。选择**全部**以保留所有类型，或从以下选项中选择：
| 分组 | 选项 |
| ---- | -------------------------------------------------------------------------------- |
| 资金流入 | Payment、Dodo Credits、Adjustment、Currency Conversion |
| 付款出账 | Payout、Payout Reversal、Payout Fees、Payout Fees Reversal |
| 退款 | Refund、Refund Reversal、Refund Fees、Refund Fees Reversal |
| 争议 | Dispute、Dispute Fees、Dispute Reversal |
| 费用 | Payment Fees、Payment Retry Fee、Dunning Fees、Abandoned Cart Recovery Fee、BYOP Fee |
| 税费 | Tax、Tax Reversal |
并非每种类型都有冲销。只有 Payout、Payout Fees、Refund、Refund Fees、Dispute 和 Tax 具有冲销。
使用**付款出账 ID**模式回答“这笔付款出账包含什么？”。使用包含**全部**事件类型的**期间**模式，逐行核对银行对账单。
***
## 生成和下载报告
前往**设置 → 报告**，选择所需的报告。
选择日期范围。只有该范围内的数据会进入文件。
选择 **CSV** 或 **XLSX**，然后设置该报告的筛选条件。
选择**下载报告**。文件会开始下载，并且该报告会添加到**已生成报告**中。
文件名包含报告类型和日期范围，因此无需打开文件即可识别下载内容，例如
`dodo_ledger_2026-06-01_to_2026-06-30.csv`。
CSV 导出文件以 UTF-8 字节顺序标记开头，因此 Excel 可以正确打开带重音符号的字符和非拉丁文字。
### 行数限制
单次导出有行数上限，因此较大的期间可能需要拆分。
| 报告 | CSV | XLSX |
| ------ | --------- | --------- |
| 账本对账 | 500,000 行 | 100,000 行 |
| 其他所有报告 | 100,000 行 | 50,000 行 |
如果日期范围超过限制，导出会因提示信息而被拒绝。缩小范围或添加筛选条件，然后重新生成。
较大的期间请选择 CSV，其行数上限更高。
***
## 已生成报告
您生成的每份报告都会被记录，因此无需重新生成即可再次下载。
| 列 | 含义 |
| ---- | --------------- |
| 报告 | 报告类型。 |
| 日期范围 | 报告覆盖的期间。 |
| 格式 | CSV 或 XLSX。 |
| 行数 | 文件包含的行数。 |
| 生成者 | 生成报告的团队成员。 |
| 创建时间 | 报告生成的时间。 |
| 状态 | **已完成**或**失败**。 |
下载链接仅在短时间内有效。如果存储的文件已过期，Dodo Payments 会使用相同参数重新生成文件，并将该行标记为已重新生成。
重新生成的报告可能与原始报告不同。日期范围背后的数据会持续变化：首次生成后记录的退款或争议会出现在重新生成的报告中。如果需要完全保留当时的数值，请保存下载的文件。
***
## 我需要哪种报告？
| 问题 | 报告 |
| ----------------- | ----------------- |
| 为什么我的余额是这个数？ | 余额和付款出账摘要 |
| 这笔付款出账包含什么？ | 账本对账，按**付款出账 ID** |
| 我支付了哪些费用？ | 全部费用 |
| 我需要提供给会计师每笔付款的记录。 | 交易报告 |
| 退款和争议让我损失了多少？ | 调整报告 |
| 我需要与银行对账单核对。 | 账本对账，按**期间** |
***
## 最佳实践
* 首先使用**余额和付款出账摘要**进行对账。只有在需要解释某个数值时，才下载详细报告。
* 长期间导出 **CSV**，只有在需要手动处理文件时才使用 **XLSX**。
* 保存下载的文件。重新生成的报告不一定与原文件一致。
* 在扩大日期范围前先添加筛选条件。筛选条件可以使导出文件保持在行数限制内。
如果某个数值看起来不正确，请先检查日期范围和筛选条件。如果仍然不正确，请将报告类型和期间发送至 [support@dodopayments.com](mailto:support@dodopayments.com) 联系我们。
## 后续步骤
跟踪收入、客户、留存率和交易健康状况。
了解您的收入、扣除项和付款出账周期。
查看付款出账何时以及如何到达您的银行账户。
发起并监控退款。