> ## 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 每个列表可以筛选和搜索什么、每个列表默认回看多久、哪些日期选择器拒绝超过一个月的范围、如何覆盖整年，以及为什么列表上的某个按钮或文件名点不了。

Portal 的每个列表页面都有自己的筛选条件集、自己的默认日期窗口，有些还对可选范围的宽度有硬性限制。本页是逐页面的参考。关于*为什么某个元素根本不存在*，见 [缺失的列、筛选条件与视图](/docs/zh/support/portal-conditional-screens-faq)。关于按下 Export 之后会发生什么，见 [导出中心](/docs/zh/support/export-center-faq)。

## 支付列表有哪些筛选条件？

| 筛选条件 | 作用 |
| - | - |
| 搜索框 | 一次一个标识——见下一个问题 |
| `Sub Merchant Id` | 仅当你的账户运营子商户时才渲染 |
| `Currency` | 订单币种，来自你账户实际使用过的币种 |
| `Payment Method Country` | 支付方式所属的国家 |
| `Payment Method Type` | **类别**——卡、钱包、银行转账等 |
| `Payment Method` | **具体支付方式**，以其类别下的两级选择器呈现 |
| `Status` | 订单状态 |
| `Card Transaction Type` | `CIT` 或 `MIT`——见下文 |
| `Created Datetime` | 范围选择器，上限一个月（见日期表） |

`Payment Method Type` 和 `Payment Method` 是同一棵树的两个层级，不是两个可替代的选项：类型是父类别，支付方式是叶子。按类型筛选会得到该类别下的所有支付方式；按支付方式筛选则缩小到一个。两者可以同时设置，列表最终按支付方式的选择缩小范围。

## 搜索框里能输入什么？能搜我自己的订单号吗？

搜索框是一个下拉框加一个输入框，所以**一次只搜一个标识**。可以，你自己的订单号是选项之一——即 `Merchant Order Id`。选项集因列表而异：

| 列表 | 可按以下标识搜索 |
| - | - |
| Payments | `Order Id`、`Merchant Order Id`、`Payment Request Id`、`Merchant User Id`、`Card Last 4 Digits`、`Subscription Id` |
| Refunds | `Order Id`（退款单）、`Original Order Id`、`Merchant Order Id`、`Merchant Original Order Id`、`Payment Request Id`、`Card Last 4 Digits`、`Subscription Id` |
| Chargebacks / disputes | `Original Order Id`、`Dispute Id`、`Subscription Id`、`Merchant User Id` |
| Subscription agreements | `Subscription Id`、`User Id`、`User Email`、`Card Last 4 Digits`、`Order Id` |
| Payout（单笔） | `Payout Order Id`、`Payout Request Id` |
| Payout（批量） | `Payout Batch Id`、`Batch Name` |
| Settlement transactions | `Order Id`、`Merchant Order Id`、`Payment Request Id`、`Merchant User Id`、`Sub Mid` |

两个需要知道的行为：

* **切换下拉框会清空已输入的内容。** 各标识的格式不同，所以输入框会被重置而不是沿用。
* **`Card Last 4 Digits` 只接受数字，且必须正好四位。** 少于四位会返回空结果而不是部分匹配，所以不完整的输入看起来像「无数据」而不是报错。

没有能猜测你粘贴的是哪种标识的自由文本搜索，支付列表上也不能按消费者姓名或邮箱搜索——你能搜索的客户侧标识是你传给我们的 `Merchant User Id` 和卡号后四位。

## `Card Transaction Type` 是干什么用的？

它按扣款发起方划分卡交易：

| 值 | 含义 |
| - | - |
| `CIT` | 客户发起——持卡人在流程中在场并操作 |
| `MIT` | 商户发起——你在持卡人未操作的情况下用已存储的凭据扣款，例如订阅续订 |

当你想把收银台流量和周期性扣款分开时使用：续订是 `MIT`，首次支付或一次性支付是 `CIT`。该筛选只对卡支付有意义；非卡支付方式没有该值。同样的区分也作为一列出现——见 [交易与退款字段参考](/docs/zh/support/transaction-field-reference-faq)。

## 同事有一个我没有的筛选条件，我能打开它吗？

不能。有些筛选条件按账户发布，只有为你的账户开通后才出现；有些只在底层数据存在时才存在，比如没有子商户的账户上的子商户筛选。这两种都不是你或你的管理员能在 Portal 中开启的——请询问你的 Waffo 对接人该筛选条件是否适用于你的账户。元素缺失的四个通用原因列在 [缺失的列、筛选条件与视图](/docs/zh/support/portal-conditional-screens-faq)。

文档和演示中的截图取自功能集不同的账户，所以截图中出现的筛选条件不能证明你的账户也应该有。

## 每个列表默认回看多久？我最多能选多宽的范围？

这是两件事：页面打开时的**默认窗口**，以及选择器是否**拒绝**更宽的选择。

| 页面 | 打开时显示 | 选择器限制 |
| - | - | - |
| Payments | 最近 7 天 | 一个月——选定一端后，相距 31 天及以上的日期会变灰 |
| Refunds | 最近 90 天 | 选择器无限制；导出有限制（见下文） |
| Chargebacks | 最近 30 天 | 选择器无限制 |
| Customer disputes | 最近 90 天 | 选择器无限制 |
| Chargeback alerts | 最近 30 天 | 选择器无限制 |
| Subscription agreements | 最近 60 天（`Created Datetime`） | 两个月，且未来日期不可选 |
| Payout——单笔 | 最近 30 天 | 一个月 |
| Payout——批量 | 最近 30 天 | 一个月 |
| Payout reports | 最近 30 天 | 未来日期不可选 |
| Settlement transactions、batches、estimation、report downloads | 最近 30 天 | 见 [结算报表范围](/docs/zh/support/settlement-reports-export-faq) |
| Balance history、payout wallet history、reserve history | 最近 30 天 | 见 [余额历史](/docs/zh/support/settlement-batch-and-calendar-faq) |
| Webhook records | 最近 7 天 | — |
| Login history | 固定为最近 90 天，无选择器 | — |

一个月的选择器限制从你先点的那一端起算：选定第一个日期后，与之相距 31 天及以上的日期都不可选。所以它限制的是窗口的**宽度**，而不是你能回看多远——你可以查看过去任何一个月，只是一次只能看一个月。

## 我需要六个月的交易记录，该怎么办？

不能通过列表筛选——支付列表的窗口上限是一个月，而交易和退款**导出在所选范围超过 31 天时会在创建任务前被拒绝**（Portal 会提示时间范围不应超过一个月）。你的选择：

| 你需要 | 使用 |
| - | - |
| 长时间段的交易级明细 | 每月跑一次导出再合并——一年十二个任务 |
| 无需每次点击的周期性交付 | 定时报表订阅——见 [报表交付与订阅](/docs/zh/support/report-delivery-and-subscription-faq) |
| 结算级而非交易级的历史 | 结算报表导出，它们有自己的范围——见 [结算报表导出](/docs/zh/support/settlement-reports-export-faq) |

每次导出都会成为一个有自己状态和下载链接的任务；这些机制，包括 `Retry Needed` 和非零失败计数的含义，见 [导出中心](/docs/zh/support/export-center-faq)。

## 我怎么找到所有仍然有效的订阅协议？

按 `Status` 筛选。协议列表提供完整的状态集，而「仍然有效」不是单一的值：

| 状态 | 读法 |
| - | - |
| `IN_PROGRESS` | 正在建立 |
| `AUTHORIZATION_REQUIRED` | 等待客户授权 |
| `ACTIVE` | 有效且在扣款中 |
| `EXPIRED` | 已到期结束 |
| `CLOSE` | 已关闭 |
| `MERCHANT_CANCELLED` | 由你取消 |
| `USER_CANCELLED` | 由客户取消 |
| `PLATFORM_CANCELLED` | 在 Waffo 侧取消 |
| `CHANNEL_CANCELLED` | 在支付方式一侧取消 |

注意日期筛选针对的是**创建**时间，默认为最近两个月，所以去年创建的协议虽然是 `ACTIVE` 但在默认窗口之外——在断定它消失之前先放宽日期范围。你能在 Portal 中对协议做什么，见 [Portal 中的订阅](/docs/zh/support/subscription-cross-currency-and-portal-faq)。

## 我在批量里提交的一笔 Payout 会显示在哪里？

Payout 历史页面有两个标签页，它们的键不同：

| 标签页 | 键 | 筛选条件 |
| - | - | - |
| Single | 单笔 Payout 订单 | `Payout Order Id` 或 `Payout Request Id`、支付方式类型、支付方式、状态、创建日期 |
| Batch | 批次 | `Payout Batch Id` 或 `Batch Name`、状态、创建日期 |

所以如果你有 Payout 订单 ID 或自己的 Payout 请求 ID，在 Single 标签页搜索。如果你只知道提交的是哪个批次，打开 Batch 标签页，找到该批次并打开——批次详情列出其成员 Payout，可在该批次内按 Payout 订单 ID 或收款账户搜索；收款账户在那里是一列，而不是 Single 标签页上的搜索字段。Payout 状态本身见 [Payouts](/docs/zh/support/payout-faq)。

## 为什么 Payout 报表列表上的文件名点不了？

因为该页面上的下载操作与查看列表是两个独立的权限。当你的用户能看到报表列表但不能从中下载时，`Report` 单元格会渲染为**纯文本而不是按钮**——没有任何东西坏了，文件也没有丢失。需要你账户上的管理员授予下载能力，或由拥有该能力的同事替你下载。角色以及谁能修改角色见 [商户 Portal 操作](/docs/zh/support/portal-operations-faq)。

列表本身显示所覆盖的时间段、其中的订单数以及生成时间，所以你可以在追问下载之前先确认报表存在。

## 我应该对着哪个结算页面对账？

它们回答不同的问题，只有其中一个是已结算的记录：

| 页面 | 是什么 |
| - | - |
| Settlement transactions | 等待结算的交易——前瞻视图，不是已结算的数字 |
| Settlement history / records | 结算记录本身——这是你要对账的对象 |
| Settlement batches | 按打款方式分组的记录 |
| Settlement estimation | 预测值，已被报表导出取代 |
| Settlement calendar | 哪些日期是结算日 |

结算记录的标识、状态、时间线和金额定义见 [结算批次与日历](/docs/zh/support/settlement-batch-and-calendar-faq)，导出选项见 [结算报表导出](/docs/zh/support/settlement-reports-export-faq)——包括哪个页面取代了估算视图。

## 这个按钮是灰的，是我的权限问题还是记录状态的问题？

两种机制都存在，你可以通过按钮是**不存在**还是**存在但禁用**来区分：

| 现象 | 原因 | 怎么做 |
| - | - | - |
| 页面上根本没有该操作 | 你的角色没有该权限——受权限控制的控件不会被渲染 | 询问你账户上的管理员 |
| 操作可见但禁用 | 记录自身的状态不允许该操作 | 检查记录状态；已完成或已操作过的记录不能再次操作 |
| 你预期是链接的地方显示为文本文件名 | 下载与查看是两个独立权限 | 见上文 Payout 报表的回答 |

状态驱动类型的具体例子：对不在可退款状态的支付执行退款操作（见 [交易与退款字段参考](/docs/zh/support/transaction-field-reference-faq)）、对不符合条件的回调记录执行重发（见 [Webhook 通知记录](/docs/zh/support/portal-webhook-log-faq)），以及余额条件不满足时的提现（见 [提现异常与状态](/docs/zh/support/withdrawal-exceptions-and-status-faq)）。自动提现协议上的暂停、恢复和终止同样是状态驱动的——见 [自动提现](/docs/zh/support/auto-withdrawal-and-withdrawal-integration-faq)。

## Portal 里的 API 文档链接在哪？

右上角，FAQ 入口旁边，当它为你的账户开通时。它会在新标签页打开公开的开发者文档，并跟随你的 Portal 界面语言。如果那里没有，文档本身也是公开的——从 [快速开始](/docs/zh/developer-docs/getting-started/overview) 进入。阅读文档不需要 Portal 中的任何东西。


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