# 商户后台产品需求文档

> 2026-09-07 · 业务阅读版。与原型的页面说明共用作者源；原型中的演示结果不表示正式能力已经实现。

## 文档定位

本文主要定义做什么、为什么做、使用者能看到什么以及业务结果如何判断。接口路径、数据表、技术框架、服务拆分、内部算法和实现步骤由技术团队设计。已确认的金额口径、权限范围、审批责任、隐私要求及外部对接约定仍需满足；这些是业务或协作约束，不指定实现方式。

## 产品目标与范围

- 商户后台：帮助商户经营人员处理收款、出款、钱包、报表和团队事务，只访问获授权的商户业务。

本文涵盖 53 个页面。每页先说明完整流程，再逐区块定义功能、字段、可选值、操作及异常结果。

## 核心业务流程

### 商户开通

注册账号 → 验证邮箱 → 填写企业认证 → 提交审核或补件 → 查看认证结果及已开通业务。

这样安排的原因：账号建立、企业认证与业务能力分别展示，商户才能知道为什么现在能用或不能用某项功能。

### 收款与对账

创建收款工具或接入收款 → 客户付款 → 查看订单 → 核对费用及结算 → 查看钱包和报表。

这样安排的原因：付款、结算、通知和入账分别可核对，减少到账争议。

### 出款与资金

确认收款方及可用资金 → 复核本金和费用 → 提交 → 跟进审批或处理 → 核对实际资金记录。

这样安排的原因：提交不等于完成；金额和收款对象在确认前必须清楚。

## 页面目录

| 页面 | 用途 |
| --- | --- |
| [经营报表总览](#product-merchant-analytics) | 汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 |
| [接口接入凭据](#product-merchant-api-credentials) | 为负责系统对接的商户成员提供商户编号、接入参数和密钥管理入口。 |
| [接口接入文档](#product-merchant-api-documentation) | 帮助对接人员了解如何发起收款、出款，以及接收交易结果通知。 |
| [接口请求详情](#product-merchant-api-log-details) | 排查一次接口调用为什么成功或失败，并与相关业务订单对应。 |
| [接口调用日志](#product-merchant-api-logs) | 查找商户系统发起的接口请求，定位接入故障和异常响应。 |
| [商户经营资料](#product-merchant-business-profile) | 维护日常经营信息，并对照已经提交的企业认证资料。 |
| [收款报表](#product-merchant-collection-report) | 分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 |
| [收款工具总览](#product-merchant-commerce) | 为商户集中提供收款链接、支付页面和门店二维码的管理入口。 |
| [向 iPay 商户转账](#product-merchant-create-disbursement) | 核实收款商户后，从当前商户钱包发起一笔内部出款。 |
| [商户首页](#product-merchant-dashboard) | 让商户快速了解账户是否可用、今天的交易情况和需要处理的事项。 |
| [内部转账详情](#product-merchant-disbursement-detail) | 核对一笔商户间转账的收付款对象、结果和钱包变化。 |
| [出款订单详情](#product-merchant-disbursement-details) | 查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 |
| [出款报表](#product-merchant-disbursement-report) | 分析指定期间出款的金额、成功情况和费用，支持付款核对。 |
| [出款订单列表](#product-merchant-disbursements) | 查询出款订单，了解款项是否已转给收款人，并找到需要跟进的处理中或失败订单。 |
| [导出文件详情](#product-merchant-export-detail) | 确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 |
| [导出历史](#product-merchant-export-history) | 集中查找已申请生成的报表文件，跟进生成状态并下载。 |
| [费用明细](#product-merchant-fee-detail) | 解释一笔费用因哪项业务产生，以及金额如何计算。 |
| [费用报表](#product-merchant-fee-report) | 了解一段时间商户承担了多少费用，并找到具体费用来源。 |
| [重置登录密码](#product-merchant-forgot-password) | 帮助无法登录的商户成员找回账号信息或重新设置登录密码。 |
| [门店收款码](#product-merchant-in-store-qr) | 管理门店和柜台使用的收款二维码，确认哪些码可以继续使用。 |
| [接受商户邀请](#product-merchant-invitation-acceptance) | 根据邀请链接确认加入指定商户，先同意法律条款，再按邮箱是否已有账号完成新账号创建或直接绑定。 |
| [提交企业认证](#product-merchant-kyb-onboarding) | 引导商户填写企业资料并上传证明文件，以申请开通相应业务能力。 |
| [商户登录](#product-merchant-login) | 验证商户成员身份，进入自己有权限使用的商户工作区。 |
| [商户钱包](#product-merchant-money) | 查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 |
| [商户消息](#product-merchant-notifications) | 集中查看与商户业务相关的通知，找到需要关注的事件。 |
| [收款订单详情](#product-merchant-payment-details) | 核对客户付款结果、商户费用、结算情况和商户系统通知情况。 |
| [收款链接](#product-merchant-payment-links) | 创建可发送给客户的付款链接，并管理其状态。 |
| [可用支付方式](#product-merchant-payment-methods) | 让商户了解已经配置的收款方式及其可用情况。 |
| [编辑支付页面](#product-merchant-payment-page-editor) | 配置一个客户可访问的付款页面，并在保存前预览。 |
| [支付页面列表](#product-merchant-payment-pages) | 查找和管理商户创建的支付页面，进入创建或编辑。 |
| [收款订单列表](#product-merchant-payments) | 查找客户付款记录，确认是否收到款项并跟进异常。 |
| [隐私政策](#product-merchant-privacy) | 向使用者说明个人与企业信息如何被收集和使用。 |
| [创建门店收款码](#product-merchant-qr-create) | 为指定门店或柜台建立可识别的收款码。 |
| [门店收款码详情](#product-merchant-qr-details) | 查看某个收款码的归属、状态和展示海报。 |
| [商户注册](#product-merchant-register) | 建立商户所有者账号，验证邮箱后进入企业认证流程。 |
| [账号安全](#product-merchant-security) | 管理登录密码和两步验证，并检查近期登录活动。 |
| [结算详情](#product-merchant-settlement-detail) | 解释一笔收款怎样扣除费用并进入商户钱包。 |
| [结算报表](#product-merchant-settlement-report) | 核对指定期间结算的进度、金额和对应收款。 |
| [帮助与支持](#product-merchant-support) | 帮助商户找到与账号、认证或其他问题对应的处理入口。 |
| [团队成员](#product-merchant-team-management) | 管理谁可以访问当前商户以及各成员能做哪些事。 |
| [服务条款](#product-merchant-terms) | 说明使用 iPay 服务的约定，供注册或使用前阅读。 |
| [充值申请详情](#product-merchant-top-up-details) | 核对一笔充值申请的转账指引、提交资料和最终处理结果。 |
| [充值申请记录](#product-merchant-top-up-requests) | 查找历史及待处理充值，判断哪笔还需要继续操作。 |
| [发起充值](#product-merchant-top-up) | 填写充值金额并获取转账指引，完成后按流程提交转账资料。 |
| [企业认证状态](#product-merchant-verification) | 让商户知道认证进度，以及已经提交了哪些企业信息。 |
| [每日余额详情](#product-merchant-wallet-balance-detail) | 解释某一天钱包余额如何从期初变为期末，并定位对账差异。 |
| [钱包余额报表](#product-merchant-wallet-report) | 按天查看钱包余额变化，支持商户对账。 |
| [钱包流水详情](#product-merchant-wallet-transaction-details) | 说明一笔已记录的资金变动因何发生，以及各类余额怎样变化。 |
| [钱包流水](#product-merchant-wallet-transactions) | 逐笔查询钱包收入、支出和其他余额变化，用于核账。 |
| [交易结果通知设置](#product-merchant-webhooks) | 设置商户系统接收收款和出款结果的地址。 |
| [提现](#product-merchant-withdrawal) | 将商户可用资金提现到指定收款账户，提交前核对收款方、到账金额和总扣款。 |
| [商户操作记录](#product-merchant-audit-logs) | 追溯当前商户成员对账户和业务所做的操作，了解谁在何时修改了什么。 |
| [登录身份验证](#product-merchant-auth-verification) | 在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 |

<a id="product-merchant-analytics"></a>
## 经营报表总览

### 要解决什么问题

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 日期范围：选择要分析的期间
- 经营指标：收款、出款和费用汇总
- 趋势与分类：查看随时间的变化及状态分布
- 待关注交易：从汇总找到需要进一步查看的记录
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 主要经营指标：从金额、笔数和结果三个角度了解当前范围的业务表现。
- 收款与出款趋势：汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示收款与出款趋势，用于确认当前业务内容及下一步。
- 经营报表总览 · 业务信息：汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示经营报表总览 · 业务信息，用于确认当前业务内容及下一步。
- 收款状态：汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示收款状态，用于确认当前业务内容及下一步。
- 结算状态：汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示结算状态，用于确认当前业务内容及下一步。
- 结算金额拆分：汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示结算金额拆分，用于确认当前业务内容及下一步。
- 费用拆分：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 待关注交易：说明「经营报表总览」中Object Type、业务参考号、说明、金额、状态的用途，便于填写、查找或核对当前记录。
- 统计期间与时区：汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示统计期间与时区，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 调整日期范围后查看同一期间的指标
- 从相关明细入口继续核对交易

### 业务规则与结果

- 金额和时间范围必须同时说明
- 成功收款不等于已经结算到可用余额
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「经营报表总览」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「经营报表总览」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「经营报表总览」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「经营报表总览」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：主要经营指标

从金额、笔数和结果三个角度了解当前范围的业务表现。

背景与用途：从金额、笔数和结果三个角度了解当前范围的业务表现。

业务规则：

- 金额与笔数分别命名；成功率分母和排除项在指标旁说明。
- 收款、出款和结算分别统计，不用一个成功状态代替所有业务结果。
- 内部成本和毛利仅管理后台获授权人员可见，缺失成本不按零计算。

操作与交互结果：

- 修改统计期间后所有指标同步刷新；点击指标进入有相同筛选范围的业务明细。

异常处理：

- 范围内无记录时显示暂无记录；无法形成比例时显示不适用，不显示误导性的百分比。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款与出款趋势

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示收款与出款趋势，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示收款与出款趋势，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营报表总览 · 业务信息

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示经营报表总览 · 业务信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示经营报表总览 · 业务信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款状态

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示收款状态，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示收款状态，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算状态

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示结算状态，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示结算状态，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

状态含义：

- 待结算（Pending）：成功收款对应资金尚未释放。
- 结算中（Processing）：正在办理结算，尚未完成。
- 已结算（Settled）：本笔结算已完成，可核对实际钱包变化。
- 失败（Failed）：本次结算未成功，需要继续处理。
- 暂缓（On Hold）：结算被暂时保留，显示可公开的处理原因。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算金额拆分

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示结算金额拆分，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示结算金额拆分，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营报表总览 · 业务信息

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示经营报表总览 · 业务信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示经营报表总览 · 业务信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：费用拆分

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：待关注交易

说明「经营报表总览」中Object Type、业务参考号、说明、金额、状态的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在经营报表总览中能够说明「经营报表总览」中Object Type、业务参考号、说明、金额、状态的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Object Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Object Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 业务参考号：追踪当前交易或申请的编号；点击时必须进入同一条业务记录。
- 说明：帮助识别该业务的文字内容，不代替订单状态或金额。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务参考号明细表

说明「经营报表总览」中Object Type、业务参考号、说明、金额、状态的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在经营报表总览中能够说明「经营报表总览」中Object Type、业务参考号、说明、金额、状态的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Object Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Object Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 业务参考号：追踪当前交易或申请的编号；点击时必须进入同一条业务记录。
- 说明：帮助识别该业务的文字内容，不代替订单状态或金额。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计期间与时区

汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示统计期间与时区，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在经营报表总览中能够汇总一段时间的收款、出款、结算和费用，帮助商户了解经营情况并发现需要跟进的交易。 本区域展示统计期间与时区，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 金额和时间范围必须同时说明
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-api-credentials"></a>
## 接口接入凭据

### 要解决什么问题

为负责系统对接的商户成员提供商户编号、接入参数和密钥管理入口。

### 为什么这样设计

商户的对接人员需要自主找到接入参数和调用结果，减少接入排障时反复向运营查询；这里的专业内容服务于接入任务。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 接入参数：商户身份和接口环境
- 密钥：用于证明调用者身份的保密信息
- 接入参数：帮助商户完成系统接入并管理凭据使用。

### 用户如何完成业务

- 按页面入口查看或复制接入参数
- 执行密钥操作前确认对现有接入的影响

### 业务规则与结果

- 密钥只向有权限的人展示
- 密钥不是商户的登录密码，不应发给付款客户
- 完整密钥仅生成时展示一次；日常显示标识、状态、创建时间。遗失使用更换流程，明确旧密钥失效影响，完成身份验证并确认后执行。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：接入参数

帮助商户完成系统接入并管理凭据使用。

背景与用途：帮助商户完成系统接入并管理凭据使用。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 环境（Environment） | 参数或调用所属环境，帮助使用者区分测试和正式业务。 | 只读展示；无值时显示无记录或不适用。 |
| Server Endpoint | 与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。 | 只读展示；无值时显示无记录或不适用。 |
| App Key | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| App Secret | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| Password Key | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 日常显示商户标识、密钥标识、状态及创建时间。
- 完整密钥仅生成时展示一次；更换前说明旧凭据失效范围。
- 完整密钥仅生成时展示一次；日常显示标识、状态、创建时间。遗失使用更换流程，明确旧密钥失效影响，完成身份验证并确认后执行。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 有权限的人员完成身份验证，确认更换后复制并妥善保存新密钥。

异常处理：

- 验证失败不能显示或更换密钥；更换结果未知先查询状态，不连续生成多套凭据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Verification code

帮助商户完成系统接入并管理凭据使用。

背景与用途：帮助商户完成系统接入并管理凭据使用。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Verification code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 日常显示商户标识、密钥标识、状态及创建时间。
- 完整密钥仅生成时展示一次；更换前说明旧凭据失效范围。

操作与交互结果：

- 有权限的人员完成身份验证，确认更换后复制并妥善保存新密钥。

异常处理：

- 验证失败不能显示或更换密钥；更换结果未知先查询状态，不连续生成多套凭据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Verification code

在「接口接入凭据」中，Verification code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

背景与用途：在「接口接入凭据」中，Verification code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Verification code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入凭据 · 办理流程

帮助商户完成系统接入并管理凭据使用。

背景与用途：帮助商户完成系统接入并管理凭据使用。

业务规则：

- 日常显示商户标识、密钥标识、状态及创建时间。
- 完整密钥仅生成时展示一次；更换前说明旧凭据失效范围。

操作与交互结果：

- 有权限的人员完成身份验证，确认更换后复制并妥善保存新密钥。

异常处理：

- 验证失败不能显示或更换密钥；更换结果未知先查询状态，不连续生成多套凭据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-api-documentation"></a>
## 接口接入文档

### 要解决什么问题

帮助对接人员了解如何发起收款、出款，以及接收交易结果通知。

### 为什么这样设计

商户的对接人员需要自主找到接入参数和调用结果，减少接入排障时反复向运营查询；这里的专业内容服务于接入任务。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 开始接入：基本接入步骤
- 身份认证：调用接口时的身份要求
- 收款与出款：请求和返回示例
- 结果通知与错误说明：了解异常如何处理
- 接口接入文档 · 业务内容：帮助对接人员了解如何发起收款、出款，以及接收交易结果通知。 本区域展示Getting Started，用于确认当前业务内容及下一步。
- Parameter：说明「接口接入文档」中Parameter、类型、Required、说明、orderStatus的用途，便于填写、查找或核对当前记录。
- Parameter：说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录。
- Field：说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。

### 用户如何完成业务

- 通过文档导航找到对应业务
- 对照示例核对接入参数

### 业务规则与结果

- 此页的接口术语服务于对接人员
- 示例参数不能作为真实订单结果
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 内容无法打开时提示返回或重试；不能用其他页面的内容代替当前说明。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：接口接入文档 · 业务内容

帮助对接人员了解如何发起收款、出款，以及接收交易结果通知。 本区域展示Getting Started，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在接口接入文档中能够帮助对接人员了解如何发起收款、出款，以及接收交易结果通知。 本区域展示Getting Started，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 此页的接口术语服务于对接人员

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Parameter

说明「接口接入文档」中Parameter、类型、Required、说明、orderStatus的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Parameter、类型、Required、说明、orderStatus的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Parameter | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| orderStatus | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 只读展示；无值时显示无记录或不适用。 |
| Meaning | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Parameter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Parameter | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Parameter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中orderStatus、Meaning、type的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中orderStatus、Meaning、type的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| orderStatus | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 只读展示；无值时显示无记录或不适用。 |
| Meaning | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- orderStatus：当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。
- Meaning：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Parameter

说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Parameter | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Parameter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Parameter | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Parameter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Parameter

说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Parameter | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Parameter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Parameter、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Parameter | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Parameter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Field

说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Field | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Field：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Field | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Field：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Field、类型、Required、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Field | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Required | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Field：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- Required：本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| iPay Code | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| Message | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| Code | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| Label | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| Meaning | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中iPay Code、Message、说明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中iPay Code、Message、说明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| iPay Code | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| Message | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- iPay Code：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- Message：解释本条业务的补充文字；内部备注与客户可见说明分别处理。
- 说明：帮助识别该业务的文字内容，不代替订单状态或金额。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口接入文档明细表

说明「接口接入文档」中Code、Label、Meaning的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口接入文档中能够说明「接口接入文档」中Code、Label、Meaning的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Code | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| Label | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| Meaning | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Code：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- Label：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- Meaning：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文档导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-api-log-details"></a>
## 接口请求详情

### 要解决什么问题

排查一次接口调用为什么成功或失败，并与相关业务订单对应。

### 为什么这样设计

商户的对接人员需要自主找到接入参数和调用结果，减少接入排障时反复向运营查询；这里的专业内容服务于接入任务。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 请求内容：调用时间和提交参数
- 响应内容：处理结果和错误信息
- 请求头与时间线：辅助追踪这次调用
- 记录不存在或不可访问：帮助定位一次调用请求、响应与实际业务结果。
- 接口请求详情 · 业务信息：排查一次接口调用为什么成功或失败，并与相关业务订单对应。 本区域展示接口请求详情 · 业务信息，用于确认当前业务内容及下一步。
- 接口请求：帮助定位一次调用请求、响应与实际业务结果。
- 接口响应：帮助定位一次调用请求、响应与实际业务结果。
- 请求头：帮助定位一次调用请求、响应与实际业务结果。
- 处理时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 从接口日志进入单条记录
- 对照请求与响应检查异常

### 业务规则与结果

- 调用成功和资金业务完成是不同结果
- 敏感凭据应隐藏
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

帮助定位一次调用请求、响应与实际业务结果。

背景与用途：帮助定位一次调用请求、响应与实际业务结果。

业务规则：

- 展示请求时间、接口用途、请求标识、响应结果及关联业务编号。
- 密码、密钥、令牌和个人敏感资料在请求、响应及请求头中脱敏。
- 调用返回成功不自动表示资金业务已完成，需核对业务订单。

操作与交互结果：

- 按时间、结果或编号查询，打开单次调用详情，再进入关联订单核对。

异常处理：

- 请求记录缺失时显示无法找到，不使用其他调用填充；无权限时不暴露请求内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口请求详情 · 业务信息

排查一次接口调用为什么成功或失败，并与相关业务订单对应。 本区域展示接口请求详情 · 业务信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在接口请求详情中能够排查一次接口调用为什么成功或失败，并与相关业务订单对应。 本区域展示接口请求详情 · 业务信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 调用成功和资金业务完成是不同结果

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口请求

帮助定位一次调用请求、响应与实际业务结果。

背景与用途：帮助定位一次调用请求、响应与实际业务结果。

业务规则：

- 展示请求时间、接口用途、请求标识、响应结果及关联业务编号。
- 密码、密钥、令牌和个人敏感资料在请求、响应及请求头中脱敏。
- 调用返回成功不自动表示资金业务已完成，需核对业务订单。

操作与交互结果：

- 按时间、结果或编号查询，打开单次调用详情，再进入关联订单核对。

异常处理：

- 请求记录缺失时显示无法找到，不使用其他调用填充；无权限时不暴露请求内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口响应

帮助定位一次调用请求、响应与实际业务结果。

背景与用途：帮助定位一次调用请求、响应与实际业务结果。

业务规则：

- 展示请求时间、接口用途、请求标识、响应结果及关联业务编号。
- 密码、密钥、令牌和个人敏感资料在请求、响应及请求头中脱敏。
- 调用返回成功不自动表示资金业务已完成，需核对业务订单。

操作与交互结果：

- 按时间、结果或编号查询，打开单次调用详情，再进入关联订单核对。

异常处理：

- 请求记录缺失时显示无法找到，不使用其他调用填充；无权限时不暴露请求内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：请求头

帮助定位一次调用请求、响应与实际业务结果。

背景与用途：帮助定位一次调用请求、响应与实际业务结果。

业务规则：

- 展示请求时间、接口用途、请求标识、响应结果及关联业务编号。
- 密码、密钥、令牌和个人敏感资料在请求、响应及请求头中脱敏。
- 调用返回成功不自动表示资金业务已完成，需核对业务订单。

操作与交互结果：

- 按时间、结果或编号查询，打开单次调用详情，再进入关联订单核对。

异常处理：

- 请求记录缺失时显示无法找到，不使用其他调用填充；无权限时不暴露请求内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-api-logs"></a>
## 接口调用日志

### 要解决什么问题

查找商户系统发起的接口请求，定位接入故障和异常响应。

### 为什么这样设计

商户的对接人员需要自主找到接入参数和调用结果，减少接入排障时反复向运营查询；这里的专业内容服务于接入任务。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 查询条件：限定需要排查的调用
- 请求列表：展示调用时间、业务接口和处理结果
- 查询条件：帮助定位一次调用请求、响应与实际业务结果。
- 接口请求记录：帮助定位一次调用请求、响应与实际业务结果。

### 用户如何完成业务

- 按查询条件缩小范围
- 打开单次调用查看请求及响应

### 业务规则与结果

- 仅展示当前商户可查看的日志
- 没有匹配记录和查询失败应分别提示
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：查询条件

帮助定位一次调用请求、响应与实际业务结果。

背景与用途：帮助定位一次调用请求、响应与实际业务结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 可选；不适用时允许留空。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 可选值：All statuses；2xx Success；4xx Client error；5xx Server error。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 展示请求时间、接口用途、请求标识、响应结果及关联业务编号。
- 密码、密钥、令牌和个人敏感资料在请求、响应及请求头中脱敏。
- 调用返回成功不自动表示资金业务已完成，需核对业务订单。

操作与交互结果：

- 按时间、结果或编号查询，打开单次调用详情，再进入关联订单核对。

异常处理：

- 请求记录缺失时显示无法找到，不使用其他调用填充；无权限时不暴露请求内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期

在「接口调用日志」中，日期用于当前业务使用的日期范围；统一使用 Asia/Manila。

背景与用途：这一部分让使用者在接口调用日志中能够在「接口调用日志」中，日期用于当前业务使用的日期范围；统一使用 Asia/Manila，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 可选；不适用时允许留空。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：状态

在「接口调用日志」中，状态用于当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

背景与用途：这一部分让使用者在接口调用日志中能够在「接口调用日志」中，状态用于当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 可选值：All statuses；2xx Success；4xx Client error；5xx Server error。 |

业务规则：

- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口请求记录

帮助定位一次调用请求、响应与实际业务结果。

背景与用途：帮助定位一次调用请求、响应与实际业务结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 接口用途与路径（Endpoint） | 本次调用的业务接口，帮助接入人员定位调用；不展示敏感认证参数。 | 只读展示；无值时显示无记录或不适用。 |
| 支付方式（Method） | 客户选择或本笔业务实际使用的方式；不等同内部提供服务的通道。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 响应耗时（Response Time） | 一次接口返回的等待时长，不等于到账或结算耗时。 | 只读展示；无值时显示无记录或不适用。 |
| Request ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示请求时间、接口用途、请求标识、响应结果及关联业务编号。
- 密码、密钥、令牌和个人敏感资料在请求、响应及请求头中脱敏。
- 调用返回成功不自动表示资金业务已完成，需核对业务订单。

操作与交互结果：

- 按时间、结果或编号查询，打开单次调用详情，再进入关联订单核对。

异常处理：

- 请求记录缺失时显示无法找到，不使用其他调用填充；无权限时不暴露请求内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接口调用日志明细表

说明「接口调用日志」中时间、接口用途与路径、支付方式、状态、响应耗时的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在接口调用日志中能够说明「接口调用日志」中时间、接口用途与路径、支付方式、状态、响应耗时的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 接口用途与路径（Endpoint） | 本次调用的业务接口，帮助接入人员定位调用；不展示敏感认证参数。 | 只读展示；无值时显示无记录或不适用。 |
| 支付方式（Method） | 客户选择或本笔业务实际使用的方式；不等同内部提供服务的通道。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 响应耗时（Response Time） | 一次接口返回的等待时长，不等于到账或结算耗时。 | 只读展示；无值时显示无记录或不适用。 |
| Request ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 时间：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 接口用途与路径：本次调用的业务接口，帮助接入人员定位调用；不展示敏感认证参数。
- 支付方式：客户选择或本笔业务实际使用的方式；不等同内部提供服务的通道。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-business-profile"></a>
## 商户经营资料

### 要解决什么问题

维护日常经营信息，并对照已经提交的企业认证资料。

### 为什么这样设计

商户需要知道谁能访问自己的业务、资料是否准确以及谁做过修改；日常资料和认证资料分清，才能避免误改。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 经营信息：商户日常展示和联络资料
- 经营地址与联系人：实际经营地点和联系途径
- 认证资料：已提交的企业、代表人、受益人及文件
- 经营信息：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 当前经营地址：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 联系人：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 已提交认证资料：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。
- 已提交企业资料：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 已提交注册地址：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 已提交授权代表：说明由谁代表企业，以及谁实际拥有或控制企业。
- 已提交受益所有人：说明由谁代表企业，以及谁实际拥有或控制企业。
- 已提交认证文件：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

### 用户如何完成业务

- 修改可编辑的经营字段并保存
- 查看已提交的认证信息

### 业务规则与结果

- 经营资料与已提交认证资料分开
- 认证信息不能通过普通资料保存悄悄改写

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：经营信息

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营名称（Store / Trading Name） | 对外经营使用的名称，与认证企业法定名称区分。 | 可选；不适用时允许留空。 |
| Business Contact Number | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Main Business | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Not specified；Catering；Service；Supermarket；Other。 |
| Store Short Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| 经营行业（Business Industry） | 描述商户经营类别，使用适用行业列表选择。 | 可选；不适用时允许留空。 |
| 营业时间（Opening Hours） | 商户对外营业的时间信息，不等于平台资金服务时效。 | 可选；不适用时允许留空。 |
| Website / Social Links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；Social Links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Detailed Operating Address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 可选；不适用时允许留空。 |
| 省或地区（Province） | 地址所属行政区域，与城市和街区保持一致。 | 可选；不适用时允许留空。 |
| 城市（City / Municipality） | 地址所在城市或市镇，与选定省份匹配。 | 可选；不适用时允许留空。 |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 可选；不适用时允许留空。 |
| 邮政编码（Postal Code） | 对应地址的邮政编码，按当地有效格式填写。 | 可选；不适用时允许留空。 |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |
| 经纬度（Longitude / Latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 可选；不适用时允许留空。 |
| Primary Contact Name | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Contact Email Address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 持股比例（Ownership） | 该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。 | 只读展示；无值时显示无记录或不适用。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 只读展示；无值时显示无记录或不适用。 |
| 出生日期（Date of Birth） | 认证人员真实出生日期，不接受未来日期。 | 只读展示；无值时显示无记录或不适用。 |
| 身份证明（Identification） | 人员身份文件类型及号码；只向授权审核人员展示。 | 只读展示；无值时显示无记录或不适用。 |
| 文件类型（Document Type） | 说明上传材料证明的事项，必须与当前企业或人员对应。 | 只读展示；无值时显示无记录或不适用。 |
| File | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Uploaded Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营信息

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营名称（Store / Trading Name） | 对外经营使用的名称，与认证企业法定名称区分。 | 可选；不适用时允许留空。 |
| Business Contact Number | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Main Business | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Not specified；Catering；Service；Supermarket；Other。 |
| Store Short Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| 经营行业（Business Industry） | 描述商户经营类别，使用适用行业列表选择。 | 可选；不适用时允许留空。 |
| 营业时间（Opening Hours） | 商户对外营业的时间信息，不等于平台资金服务时效。 | 可选；不适用时允许留空。 |
| Website / Social Links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；Social Links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营名称

在「商户经营资料」中，经营名称用于对外经营使用的名称，与认证企业法定名称区分。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，经营名称用于对外经营使用的名称，与认证企业法定名称区分，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营名称（Store / Trading Name） | 对外经营使用的名称，与认证企业法定名称区分。 | 可选；不适用时允许留空。 |

业务规则：

- 经营名称：对外经营使用的名称，与认证企业法定名称区分。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Business Contact Number

在「商户经营资料」中，Business Contact Number用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，Business Contact Number用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Business Contact Number | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- Business Contact Number：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Main Business

在「商户经营资料」中，Main Business用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，Main Business用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Main Business | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Not specified；Catering；Service；Supermarket；Other。 |

业务规则：

- Main Business：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Store Short Name

在「商户经营资料」中，Store Short Name用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，Store Short Name用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store Short Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |

业务规则：

- Store Short Name：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营行业

在「商户经营资料」中，经营行业用于描述商户经营类别，使用适用行业列表选择。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，经营行业用于描述商户经营类别，使用适用行业列表选择，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营行业（Business Industry） | 描述商户经营类别，使用适用行业列表选择。 | 可选；不适用时允许留空。 |

业务规则：

- 经营行业：描述商户经营类别，使用适用行业列表选择。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：营业时间

在「商户经营资料」中，营业时间用于商户对外营业的时间信息，不等于平台资金服务时效。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，营业时间用于商户对外营业的时间信息，不等于平台资金服务时效，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 营业时间（Opening Hours） | 商户对外营业的时间信息，不等于平台资金服务时效。 | 可选；不适用时允许留空。 |

业务规则：

- 营业时间：商户对外营业的时间信息，不等于平台资金服务时效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前经营地址

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Detailed Operating Address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 可选；不适用时允许留空。 |
| 省或地区（Province） | 地址所属行政区域，与城市和街区保持一致。 | 可选；不适用时允许留空。 |
| 城市（City / Municipality） | 地址所在城市或市镇，与选定省份匹配。 | 可选；不适用时允许留空。 |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 可选；不适用时允许留空。 |
| 邮政编码（Postal Code） | 对应地址的邮政编码，按当地有效格式填写。 | 可选；不适用时允许留空。 |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |
| 经纬度（Longitude / Latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 可选；不适用时允许留空。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：省或地区

在「商户经营资料」中，省或地区用于地址所属行政区域，与城市和街区保持一致。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，省或地区用于地址所属行政区域，与城市和街区保持一致，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 省或地区（Province） | 地址所属行政区域，与城市和街区保持一致。 | 可选；不适用时允许留空。 |

业务规则：

- 省或地区：地址所属行政区域，与城市和街区保持一致。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：城市

在「商户经营资料」中，城市用于地址所在城市或市镇，与选定省份匹配。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，城市用于地址所在城市或市镇，与选定省份匹配，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 城市（City / Municipality） | 地址所在城市或市镇，与选定省份匹配。 | 可选；不适用时允许留空。 |

业务规则：

- 城市：地址所在城市或市镇，与选定省份匹配。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：街区

在「商户经营资料」中，街区用于菲律宾地址中的街区信息，与城市保持一致。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，街区用于菲律宾地址中的街区信息，与城市保持一致，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 可选；不适用时允许留空。 |

业务规则：

- 街区：菲律宾地址中的街区信息，与城市保持一致。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：邮政编码

在「商户经营资料」中，邮政编码用于对应地址的邮政编码，按当地有效格式填写。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，邮政编码用于对应地址的邮政编码，按当地有效格式填写，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 邮政编码（Postal Code） | 对应地址的邮政编码，按当地有效格式填写。 | 可选；不适用时允许留空。 |

业务规则：

- 邮政编码：对应地址的邮政编码，按当地有效格式填写。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：国家

在「商户经营资料」中，国家用于当前地址或主体所属国家，用于解释地址格式及适用范围。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，国家用于当前地址或主体所属国家，用于解释地址格式及适用范围，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |

业务规则：

- 国家：当前地址或主体所属国家，用于解释地址格式及适用范围。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经纬度

在「商户经营资料」中，经纬度用于经营位置的经度和纬度，分别校验合法数值范围。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，经纬度用于经营位置的经度和纬度，分别校验合法数值范围，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经纬度（Longitude / Latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 可选；不适用时允许留空。 |

业务规则：

- 经纬度：经营位置的经度和纬度，分别校验合法数值范围。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：联系人

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Primary Contact Name | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Contact Email Address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Primary Contact Name

在「商户经营资料」中，Primary Contact Name用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，Primary Contact Name用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Primary Contact Name | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- Primary Contact Name：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Contact Email Address

在「商户经营资料」中，Contact Email Address用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：这一部分让使用者在商户经营资料中能够在「商户经营资料」中，Contact Email Address用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Contact Email Address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- Contact Email Address：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交认证资料

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

业务规则：

- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交企业资料

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交注册地址

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交授权代表

说明由谁代表企业，以及谁实际拥有或控制企业。

背景与用途：说明由谁代表企业，以及谁实际拥有或控制企业。

业务规则：

- 展示姓名、身份信息、国籍、出生日期、持股或控制关系；多位所有人分别记录。
- 持股比例是企业归属信息，不是费率；身份证明仅授权人员查看。

操作与交互结果：

- 逐人填写或核对资料；更换代表人或所有人时保留相应审核依据。

异常处理：

- 必要资料缺失或比例格式不正确时提示对应人员，不能用其他人的资料补位。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交受益所有人

说明由谁代表企业，以及谁实际拥有或控制企业。

背景与用途：说明由谁代表企业，以及谁实际拥有或控制企业。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 持股比例（Ownership） | 该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。 | 只读展示；无值时显示无记录或不适用。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 只读展示；无值时显示无记录或不适用。 |
| 出生日期（Date of Birth） | 认证人员真实出生日期，不接受未来日期。 | 只读展示；无值时显示无记录或不适用。 |
| 身份证明（Identification） | 人员身份文件类型及号码；只向授权审核人员展示。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示姓名、身份信息、国籍、出生日期、持股或控制关系；多位所有人分别记录。
- 持股比例是企业归属信息，不是费率；身份证明仅授权人员查看。

操作与交互结果：

- 逐人填写或核对资料；更换代表人或所有人时保留相应审核依据。

异常处理：

- 必要资料缺失或比例格式不正确时提示对应人员，不能用其他人的资料补位。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户经营资料明细表

说明「商户经营资料」中名称、持股比例、国籍、出生日期、身份证明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在商户经营资料中能够说明「商户经营资料」中名称、持股比例、国籍、出生日期、身份证明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 持股比例（Ownership） | 该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。 | 只读展示；无值时显示无记录或不适用。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 只读展示；无值时显示无记录或不适用。 |
| 出生日期（Date of Birth） | 认证人员真实出生日期，不接受未来日期。 | 只读展示；无值时显示无记录或不适用。 |
| 身份证明（Identification） | 人员身份文件类型及号码；只向授权审核人员展示。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 名称：当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。
- 持股比例：该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。
- 国籍：认证人员身份证明对应的国籍信息。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交认证文件

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件类型（Document Type） | 说明上传材料证明的事项，必须与当前企业或人员对应。 | 只读展示；无值时显示无记录或不适用。 |
| File | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Uploaded Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件类型明细表

向审核人员提供与当前企业或人员对应的证明材料。

背景与用途：向审核人员提供与当前企业或人员对应的证明材料。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件类型（Document Type） | 说明上传材料证明的事项，必须与当前企业或人员对应。 | 只读展示；无值时显示无记录或不适用。 |
| File | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Uploaded Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 每份文件列出类型、文件名、上传时间和审核状态，明确属于哪个对象。
- 敏感文件仅授权人员可查看或下载，不通过猜测网址访问。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 上传失败保留其他已填资料；文件不可读或类型不符时明确提示，不显示上传成功。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-collection-report"></a>
## 收款报表

### 要解决什么问题

分析指定期间的收款金额、笔数、方式和结果，支持日常核对。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 日期和筛选：限定统计范围
- 收款指标与趋势：了解收款变化
- 支付方式和状态分布：比较不同类型
- 交易明细：核对组成汇总的订单
- 报表筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 统计说明：观察指定期间的成功收款规模，并能核对组成这些数字的交易。
- 期间趋势：分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示Collection Trend，用于确认当前业务内容及下一步。
- 收款报表 · 统计指标：让用户选择当前商户已开通且适用本次交易的支付方式。
- 业务状态：分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示Payment Status Breakdown，用于确认当前业务内容及下一步。
- 收款报表 · 业务信息：分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示收款报表 · 业务信息，用于确认当前业务内容及下一步。
- 操作与下一步：说明「收款报表」中Date & Time、收款订单号、处理通道、收款入口、所属门店的用途，便于填写、查找或核对当前记录。
- 收款报表 · 记录明细：在保持查询条件的前提下浏览更多记录。

### 用户如何完成业务

- 选择统计期间
- 查看分类和订单明细
- 使用页面提供的导出入口

### 业务规则与结果

- 统计口径随筛选一致变化
- 付款状态、手续费和净额不能混用
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：报表筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Payment method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All payment methods；QRPH；GCash；Credit & Debit Cards；OTC。 |
| 付款状态（Payment status） | 客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。 | 可选值：All statuses；已付款：客户付款成功，不等于已结算；待处理：尚未得到最终业务结果；失败：本次业务未成功，查看原因。 |
| 收款入口（Entry point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 可选值：All entry points；Merchant App；Merchant API；Merchant Portal；Static QR；Payment Link；Payment Page。 |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 可选值：All stores。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Payment method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All payment methods；QRPH；GCash；Credit & Debit Cards；OTC。 |
| 付款状态（Payment status） | 客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。 | 可选值：All statuses；已付款：客户付款成功，不等于已结算；待处理：尚未得到最终业务结果；失败：本次业务未成功，查看原因。 |
| 收款入口（Entry point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 可选值：All entry points；Merchant App；Merchant API；Merchant Portal；Static QR；Payment Link；Payment Page。 |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 可选值：All stores。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「收款报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「收款报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Payment method

在「收款报表」中，Payment method用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：在「收款报表」中，Payment method用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Payment method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All payment methods；QRPH；GCash；Credit & Debit Cards；OTC。 |

业务规则：

- 仅显示适用方式，停用方式不可选；未选择前不显示确定的最终手续费。
- 金额或方式改变后重新展示报价，总额清楚标明本金及费用。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 无可用方式时解释原因并保留返回；报价失效后须刷新并再次确认。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款状态

在「收款报表」中，付款状态用于客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。

背景与用途：这一部分让使用者在收款报表中能够在「收款报表」中，付款状态用于客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 付款状态（Payment status） | 客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。 | 可选值：All statuses；已付款：客户付款成功，不等于已结算；待处理：尚未得到最终业务结果；失败：本次业务未成功，查看原因。 |

业务规则：

- 付款状态：客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款入口

在「收款报表」中，收款入口用于产生该笔付款的工具或入口，用于追溯业务来源。

背景与用途：这一部分让使用者在收款报表中能够在「收款报表」中，收款入口用于产生该笔付款的工具或入口，用于追溯业务来源，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收款入口（Entry point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 可选值：All entry points；Merchant App；Merchant API；Merchant Portal；Static QR；Payment Link；Payment Page。 |

业务规则：

- 收款入口：产生该笔付款的工具或入口，用于追溯业务来源。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：所属门店

在「收款报表」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属。

背景与用途：这一部分让使用者在收款报表中能够在「收款报表」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 可选值：All stores。 |

业务规则：

- 所属门店：本次收款所属营业场所；无门店时不能虚构归属。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

在「收款报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

背景与用途：在「收款报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：最低金额

在「收款报表」中，最低金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在收款报表中能够在「收款报表」中，最低金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 最低金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：最高金额

在「收款报表」中，最高金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在收款报表中能够在「收款报表」中，最高金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 最高金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「收款报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「收款报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「收款报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「收款报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

观察指定期间的成功收款规模，并能核对组成这些数字的交易。

背景与用途：观察指定期间的成功收款规模，并能核对组成这些数字的交易。

业务规则：

- 收款总额采用成功付款本金，手续费和退款单独展示。
- 统计显示起止日期、币种和数据更新时间；不把待结算释放再次记成销售收入。

操作与交互结果：

- 选择期间后同步刷新汇总与图表；点击明细沿用同一期间与商户范围。

异常处理：

- 无数据说明暂无成功收款；不完整或读取失败时不将缺失值当作零。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：期间趋势

分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示Collection Trend，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在收款报表中能够分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示Collection Trend，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 统计口径随筛选一致变化

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款报表 · 统计指标

让用户选择当前商户已开通且适用本次交易的支付方式。

背景与用途：让用户选择当前商户已开通且适用本次交易的支付方式。

业务规则：

- 仅显示适用方式，停用方式不可选；未选择前不显示确定的最终手续费。
- 金额或方式改变后重新展示报价，总额清楚标明本金及费用。

操作与交互结果：

- 选择方式，核对最终费用和总额后确认支付。

异常处理：

- 无可用方式时解释原因并保留返回；报价失效后须刷新并再次确认。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务状态

分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示Payment Status Breakdown，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在收款报表中能够分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示Payment Status Breakdown，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 统计口径随筛选一致变化

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款报表 · 业务信息

分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示收款报表 · 业务信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在收款报表中能够分析指定期间的收款金额、笔数、方式和结果，支持日常核对。 本区域展示收款报表 · 业务信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 统计口径随筛选一致变化
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

说明「收款报表」中Date & Time、收款订单号、处理通道、收款入口、所属门店的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款报表中能够说明「收款报表」中Date & Time、收款订单号、处理通道、收款入口、所属门店的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Date & Time | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收款订单号（Payment ID） | iPay 的付款记录编号，用于查找这笔客户付款。 | 只读展示；无值时显示无记录或不适用。 |
| 处理通道（Channel） | 本笔业务实际经过的处理机构；商户只能查看获授权的信息。 | 只读展示；无值时显示无记录或不适用。 |
| 收款入口（Entry Point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 只读展示；无值时显示无记录或不适用。 |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Date & Time：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收款订单号：iPay 的付款记录编号，用于查找这笔客户付款。
- 处理通道：本笔业务实际经过的处理机构；商户只能查看获授权的信息。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款订单号明细表

说明「收款报表」中Date & Time、收款订单号、处理通道、收款入口、所属门店的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款报表中能够说明「收款报表」中Date & Time、收款订单号、处理通道、收款入口、所属门店的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Date & Time | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收款订单号（Payment ID） | iPay 的付款记录编号，用于查找这笔客户付款。 | 只读展示；无值时显示无记录或不适用。 |
| 处理通道（Channel） | 本笔业务实际经过的处理机构；商户只能查看获授权的信息。 | 只读展示；无值时显示无记录或不适用。 |
| 收款入口（Entry Point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 只读展示；无值时显示无记录或不适用。 |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Date & Time：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收款订单号：iPay 的付款记录编号，用于查找这笔客户付款。
- 处理通道：本笔业务实际经过的处理机构；商户只能查看获授权的信息。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款报表 · 记录明细

在保持查询条件的前提下浏览更多记录。

背景与用途：在保持查询条件的前提下浏览更多记录。

业务规则：

- 展示结果总数、当前页和每页数量；总数仅属于本次获授权筛选范围。
- 筛选变化后回到第一页，翻页不更改业务数据。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 最后一页不能继续下一页；新查询无记录时显示空结果，不显示旧页数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-commerce"></a>
## 收款工具总览

### 要解决什么问题

为商户集中提供收款链接、支付页面和门店二维码的管理入口。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 收款工具：选择适合线上或门店的收款方式
- 渠道表现：了解不同工具的使用表现
- 收款工具：让商户知道哪些收款或出款方式现在可以使用。
- 工具表现：让商户知道哪些收款或出款方式现在可以使用。
- 金额与费用明细：使用户在提交或对账时能清楚解释本金、费用和最终金额。

### 用户如何完成业务

- 进入对应工具列表进行创建或管理
- 查看工具表现

### 业务规则与结果

- 工具是否可以收款取决于商户已开通能力及工具状态

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：收款工具

让商户知道哪些收款或出款方式现在可以使用。

背景与用途：让商户知道哪些收款或出款方式现在可以使用。

业务规则：

- 能力状态与企业认证分别展示；未开通、可用、停用分别解释。
- 商户只能看到自己的适用方式和收费，平台内部通道成本不公开。

操作与交互结果：

- 查看方式和费用，从开通指引或对应工具入口继续；停用前说明影响。

异常处理：

- 未开通时不给出可成功操作的假入口；能力读取失败时停止依赖其授权的交易提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：工具表现

让商户知道哪些收款或出款方式现在可以使用。

背景与用途：让商户知道哪些收款或出款方式现在可以使用。

业务规则：

- 能力状态与企业认证分别展示；未开通、可用、停用分别解释。
- 商户只能看到自己的适用方式和收费，平台内部通道成本不公开。

操作与交互结果：

- 查看方式和费用，从开通指引或对应工具入口继续；停用前说明影响。

异常处理：

- 未开通时不给出可成功操作的假入口；能力读取失败时停止依赖其授权的交易提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额与费用明细

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额与费用明细

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额与费用明细

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-create-disbursement"></a>
## 向 iPay 商户转账

### 要解决什么问题

核实收款商户后，从当前商户钱包发起一笔内部出款。

### 为什么这样设计

付款人员需要确认收款方及总扣款，并知道钱是否已经付出；明确处理中和通知状态，可以避免误判及重复转账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 余额与权限提示：判断能否发起
- 收款商户核验：确认钱转给谁
- 转账资料：金额、商户订单号和备注；金额摘要：本金、费用、总扣款和收款方到账金额
- 确认与结果：核对金额和处理状态
- 无访问权限：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- Receiving Merchant ID：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 收款对象与转账信息：在「向 iPay 商户转账」中，Receiving Merchant ID用于用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- 向 iPay 商户转账 · 业务信息：说明「向 iPay 商户转账」中Merchant Name、Merchant ID、状态的用途，便于填写、查找或核对当前记录。
- Disbursement Amount：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 收款对象与转账信息：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 向 iPay 商户转账 · 业务内容：核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Review disbursement，用于确认当前业务内容及下一步。
- 处理结果：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 向 iPay 商户转账 · 业务内容：核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Prototype demo controls，用于确认当前业务内容及下一步。
- 统计说明：让发起方和查询人员确认钱将交给谁、按什么方式办理。

### 用户如何完成业务

- 先核验收款商户，再填写金额
- 复核收款方和扣款信息后，通过账号密码及邮箱验证码确认提交
- 查看处理结果

### 业务规则与结果

- 收款方未核验不能继续
- 余额不足或金额不合规应阻止提交
- 结果暂不明确时先查原申请，避免重复转账
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 支持选择最近收款商户，提交前再次显示接收商户名称和账户标识。网页不增加独立支付密码，沿用既有资金操作身份验证；App 已有支付密码用于其资金确认流程。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：无访问权限

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Receiving Merchant ID

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Receiving Merchant ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 可选；不适用时允许留空。 |
| Merchant Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| Merchant ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款对象与转账信息

在「向 iPay 商户转账」中，Receiving Merchant ID用于用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。

背景与用途：在「向 iPay 商户转账」中，Receiving Merchant ID用于用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Receiving Merchant ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 支持选择最近收款商户，提交前再次显示接收商户名称和账户标识。网页不增加独立支付密码，沿用既有资金操作身份验证；App 已有支付密码用于其资金确认流程。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Receiving Merchant ID

在「向 iPay 商户转账」中，Receiving Merchant ID用于用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。

背景与用途：在「向 iPay 商户转账」中，Receiving Merchant ID用于用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Receiving Merchant ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：向 iPay 商户转账 · 业务信息

说明「向 iPay 商户转账」中Merchant Name、Merchant ID、状态的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够说明「向 iPay 商户转账」中Merchant Name、Merchant ID、状态的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Merchant Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| Merchant ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Merchant Name：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。
- Merchant ID：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 支持选择最近收款商户，提交前再次显示接收商户名称和账户标识。网页不增加独立支付密码，沿用既有资金操作身份验证；App 已有支付密码用于其资金确认流程。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Disbursement Amount

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Disbursement Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |
| Merchant Order ID (optional) | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| Remark (optional) | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款对象与转账信息

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Disbursement Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |
| Merchant Order ID (optional) | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| Remark (optional) | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 支持选择最近收款商户，提交前再次显示接收商户名称和账户标识。网页不增加独立支付密码，沿用既有资金操作身份验证；App 已有支付密码用于其资金确认流程。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Disbursement Amount

在「向 iPay 商户转账」中，Disbursement Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够在「向 iPay 商户转账」中，Disbursement Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Disbursement Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |

业务规则：

- Disbursement Amount：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Merchant Order ID (optional)

在「向 iPay 商户转账」中，Merchant Order ID (optional)用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够在「向 iPay 商户转账」中，Merchant Order ID (optional)用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Merchant Order ID (optional) | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |

业务规则：

- Merchant Order ID (optional)：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Remark (optional)

在「向 iPay 商户转账」中，Remark (optional)用于解释本条业务的补充文字；内部备注与客户可见说明分别处理。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够在「向 iPay 商户转账」中，Remark (optional)用于解释本条业务的补充文字；内部备注与客户可见说明分别处理，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Remark (optional) | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |

业务规则：

- Remark (optional)：解释本条业务的补充文字；内部备注与客户可见说明分别处理。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：向 iPay 商户转账 · 业务内容

核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Review disbursement，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Review disbursement，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收款方未核验不能继续

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理结果

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：向 iPay 商户转账 · 业务内容

核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Prototype demo controls，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Prototype demo controls，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收款方未核验不能继续

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款人

帮助商户完成系统接入并管理凭据使用。

背景与用途：帮助商户完成系统接入并管理凭据使用。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收款人（Recipient） | 实际接收出款的人或商户；账户号码应脱敏展示。 | 只读展示；无值时显示无记录或不适用。 |
| Total Debit | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| Account password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |
| Verification code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 日常显示商户标识、密钥标识、状态及创建时间。
- 完整密钥仅生成时展示一次；更换前说明旧凭据失效范围。

操作与交互结果：

- 有权限的人员完成身份验证，确认更换后复制并妥善保存新密钥。

异常处理：

- 验证失败不能显示或更换密钥；更换结果未知先查询状态，不连续生成多套凭据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号密码

在「向 iPay 商户转账」中，Account password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「向 iPay 商户转账」中，Account password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Account password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Verification code

在「向 iPay 商户转账」中，Verification code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

背景与用途：在「向 iPay 商户转账」中，Verification code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Verification code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：向 iPay 商户转账 · 办理流程

核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Leave this page?，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示Leave this page?，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收款方未核验不能继续

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：向 iPay 商户转账 · 办理流程

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：向 iPay 商户转账 · 操作入口

核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示向 iPay 商户转账 · 操作入口，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在向 iPay 商户转账中能够核实收款商户后，从当前商户钱包发起一笔内部出款。 本区域展示向 iPay 商户转账 · 操作入口，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收款方未核验不能继续
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 支持选择最近收款商户，提交前再次显示接收商户名称和账户标识。网页不增加独立支付密码，沿用既有资金操作身份验证；App 已有支付密码用于其资金确认流程。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Disbursement Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| 手续费（Fee） | 本次业务按生效收费规则产生的费用，保留当时的计费依据。 | 只读展示；无值时显示无记录或不适用。 |
| Total Debit | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| Recipient Receives | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-dashboard"></a>
## 商户首页

### 要解决什么问题

让商户快速了解账户是否可用、今天的交易情况和需要处理的事项。

### 为什么这样设计

日常工作需要先知道经营和资金状况，再决定处理哪件事；概览必须能继续找到具体业务，避免只看到数字而无法跟进。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 账户提示：认证或能力限制
- 钱包余额：可用资金
- 今日交易与销售摘要：经营概况
- 待办与消息：需要关注的事项
- 欢迎与开始使用：向尚未完成开通或首次使用的商户提供清楚的下一步。
- 完成企业认证：让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。
- 首次收款引导：向尚未完成开通或首次使用的商户提供清楚的下一步。
- 钱包使用引导：向尚未完成开通或首次使用的商户提供清楚的下一步。
- 开通更多支付方式：向尚未完成开通或首次使用的商户提供清楚的下一步。
- 钱包余额：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 今日交易：让商户快速知道马尼拉业务日期内发生的交易及当前结果。
- 销售摘要：观察指定期间的成功收款规模，并能核对组成这些数字的交易。
- 交易摘要：从金额、笔数和结果三个角度了解当前范围的业务表现。
- 待办与消息：让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

### 用户如何完成业务

- 从待办进入认证等相应页面
- 从钱包、交易或收款工具入口继续办理业务

### 业务规则与结果

- 新商户引导和正常经营概况根据账户状态展示
- 读取失败时余额不能显示为零
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：欢迎与开始使用

向尚未完成开通或首次使用的商户提供清楚的下一步。

背景与用途：向尚未完成开通或首次使用的商户提供清楚的下一步。

业务规则：

- 账号建立、企业认证和业务开通分别表示。
- 已经完成的步骤不要求重复提交；未开通业务说明限制及办理条件。

操作与交互结果：

- 继续认证进入现有认证流程；创建收款链接进入固定金额收款链接；管理资金进入钱包。

异常处理：

- 缺少查看权限时不暴露对应敏感内容；已完成引导后展示正常经营入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：完成企业认证

让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

背景与用途：让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

业务规则：

- 提示包含问题对象、当前状态、影响及下一步。
- 认证、余额限制和待复核事项分别描述；已处理事项不继续作为未处理提醒。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 点击事项进入该笔申请或对应办理页面；处理后返回刷新该事项结果。

异常处理：

- 没有待办说明目前没有需要处理的事项；无权限查看具体对象时提供可联系角色，不泄露敏感细节。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：首次收款引导

向尚未完成开通或首次使用的商户提供清楚的下一步。

背景与用途：向尚未完成开通或首次使用的商户提供清楚的下一步。

业务规则：

- 账号建立、企业认证和业务开通分别表示。
- 已经完成的步骤不要求重复提交；未开通业务说明限制及办理条件。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。

操作与交互结果：

- 继续认证进入现有认证流程；创建收款链接进入固定金额收款链接；管理资金进入钱包。

异常处理：

- 缺少查看权限时不暴露对应敏感内容；已完成引导后展示正常经营入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包使用引导

向尚未完成开通或首次使用的商户提供清楚的下一步。

背景与用途：向尚未完成开通或首次使用的商户提供清楚的下一步。

业务规则：

- 账号建立、企业认证和业务开通分别表示。
- 已经完成的步骤不要求重复提交；未开通业务说明限制及办理条件。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。

操作与交互结果：

- 继续认证进入现有认证流程；创建收款链接进入固定金额收款链接；管理资金进入钱包。

异常处理：

- 缺少查看权限时不暴露对应敏感内容；已完成引导后展示正常经营入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：开通更多支付方式

向尚未完成开通或首次使用的商户提供清楚的下一步。

背景与用途：向尚未完成开通或首次使用的商户提供清楚的下一步。

业务规则：

- 账号建立、企业认证和业务开通分别表示。
- 已经完成的步骤不要求重复提交；未开通业务说明限制及办理条件。

操作与交互结果：

- 继续认证进入现有认证流程；创建收款链接进入固定金额收款链接；管理资金进入钱包。

异常处理：

- 缺少查看权限时不暴露对应敏感内容；已完成引导后展示正常经营入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包余额

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 可用余额（Available） | 当前可以用于已授权支付或提现的资金，不包含待结算和冻结余额。 | PHP；保留两位小数；真实为零才显示 0.00。 |
| 待结算余额（Pending Settlement） | 已形成待结算记录但尚未转入可用余额的资金。 | PHP；保留两位小数；真实为零才显示 0.00。 |
| 冻结余额（Frozen） | 因业务预留或限制暂时不可使用的资金。 | PHP；保留两位小数；真实为零才显示 0.00。 |
| 更新时间（As of） | 最近一次成功获取整组余额的时间，按 Asia/Manila 展示。 | 刷新中显示更新中；失败保留最后成功时间。 |

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：今日交易

让商户快速知道马尼拉业务日期内发生的交易及当前结果。

背景与用途：让商户快速知道马尼拉业务日期内发生的交易及当前结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Collected amount | 当日成功收款本金合计，非当前钱包余额。 | 按马尼拉当日统计；无记录显示 0，未知不显示 0。 |
| Successful | 成功付款笔数。 | 按马尼拉当日统计；无记录显示 0，未知不显示 0。 |
| Failed | 付款失败笔数。 | 按马尼拉当日统计；无记录显示 0，未知不显示 0。 |
| Processing | 尚在处理的付款笔数。 | 按马尼拉当日统计；无记录显示 0，未知不显示 0。 |

业务规则：

- 日期为 Asia/Manila 当天，不采用访问者电脑时区。
- 成功、失败、处理中各自统计；成功收款金额不等于到账余额。
- 退款保留原成功事实，退款金额单列；通知发送失败不改变收款结果。

操作与交互结果：

- 点击查看全部付款进入订单列表并带上今天日期；进一步点击状态时保留该日期。
- 刷新时金额、笔数和统计时间一起更新。

异常处理：

- 没有今日交易显示真实零值；读取失败显示无法获取，不能显示成零交易。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：销售摘要

观察指定期间的成功收款规模，并能核对组成这些数字的交易。

背景与用途：观察指定期间的成功收款规模，并能核对组成这些数字的交易。

业务规则：

- 收款总额采用成功付款本金，手续费和退款单独展示。
- 统计显示起止日期、币种和数据更新时间；不把待结算释放再次记成销售收入。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。

操作与交互结果：

- 选择期间后同步刷新汇总与图表；点击明细沿用同一期间与商户范围。

异常处理：

- 无数据说明暂无成功收款；不完整或读取失败时不将缺失值当作零。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易摘要

从金额、笔数和结果三个角度了解当前范围的业务表现。

背景与用途：从金额、笔数和结果三个角度了解当前范围的业务表现。

业务规则：

- 金额与笔数分别命名；成功率分母和排除项在指标旁说明。
- 收款、出款和结算分别统计，不用一个成功状态代替所有业务结果。
- 内部成本和毛利仅管理后台获授权人员可见，缺失成本不按零计算。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 未开通业务显示原因和开通路径；没有查看权限的敏感内容不展示。查看全部沿用当前统计期间；不足以形成排名的数据展示实际数值，不给出最优判断。

操作与交互结果：

- 修改统计期间后所有指标同步刷新；点击指标进入有相同筛选范围的业务明细。

异常处理：

- 范围内无记录时显示暂无记录；无法形成比例时显示不适用，不显示误导性的百分比。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：待办与消息

让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

背景与用途：让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

业务规则：

- 提示包含问题对象、当前状态、影响及下一步。
- 认证、余额限制和待复核事项分别描述；已处理事项不继续作为未处理提醒。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。

操作与交互结果：

- 点击事项进入该笔申请或对应办理页面；处理后返回刷新该事项结果。

异常处理：

- 没有待办说明目前没有需要处理的事项；无权限查看具体对象时提供可联系角色，不泄露敏感细节。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-disbursement-detail"></a>
## 内部转账详情

### 要解决什么问题

核对一笔商户间转账的收付款对象、结果和钱包变化。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 转账概览：金额和状态
- 转账双方：付款与收款商户
- 钱包影响：扣款或入账信息
- 关联记录与时间线：追溯处理过程
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 出款概览：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 转账信息：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 钱包影响：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 关联记录：核对一笔商户间转账的收付款对象、结果和钱包变化。 本区域展示关联记录，用于确认当前业务内容及下一步。
- 处理时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 从记录进入详情
- 沿关联记录查看钱包流水

### 业务规则与结果

- 这页解释商户间转账，与银行或电子钱包出款详情区分
- 以实际入账记录说明余额变化
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款概览

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：转账信息

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包影响

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：关联记录

核对一笔商户间转账的收付款对象、结果和钱包变化。 本区域展示关联记录，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在内部转账详情中能够核对一笔商户间转账的收付款对象、结果和钱包变化。 本区域展示关联记录，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 关联记录与时间线：追溯处理过程

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-disbursement-details"></a>
## 出款订单详情

### 要解决什么问题

查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。

### 为什么这样设计

付款人员需要确认收款方及总扣款，并知道钱是否已经付出；明确处理中和通知状态，可以避免误判及重复转账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 订单与收款人：订单号、收款机构和脱敏账号
- 金额明细：出款金额、费用和总扣款
- 失败信息：无法完成的原因
- 结果通知与时间线：通知状态及处理过程
- 出款凭证：可提供的交易凭证
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 出款概览：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 订单信息：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。
- 收款人信息：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 金额明细：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 失败原因：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 商户结果通知：说明交易结果是否已成功送到商户的系统。
- 交易时间线：按时间还原业务从创建到当前结果的过程。
- 出款凭证：查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 本区域展示出款凭证，用于确认当前业务内容及下一步。
- 出款订单详情 · 业务内容：查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 本区域展示disbursement Receipt Card，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 打开订单后核对收款方、金额与状态
- 按页面入口查看或下载凭证

### 业务规则与结果

- 出款成功不因结果通知失败而变成出款失败
- 凭证和可用操作随订单状态及权限变化
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款概览

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：订单信息

确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

背景与用途：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

业务规则：

- 展示平台订单号、商户订单号、所属商户、业务来源、金额、币种及创建时间。
- 付款状态与结算状态、结果通知状态分别解释；处理中不等于成功。
- 已经退款仍保留原付款成功事实及独立退款金额。

操作与交互结果：

- 从列表打开同一笔订单，按关联入口查询费用、结算或钱包变化；返回保留原查询条件。

异常处理：

- 找不到该订单时提示不存在或不可访问；未完成时完成时间显示未完成。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款人信息

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额明细

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：失败原因

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户结果通知

说明交易结果是否已成功送到商户的系统。

背景与用途：说明交易结果是否已成功送到商户的系统。

业务规则：

- 通知状态与付款、出款及结算状态分别展示；通知失败不代表资金失败。
- 未发送、发送中、成功、失败和继续重试分别说明当前进展；展示最近尝试时间及可公开的失败原因。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 商户查看结果和通知地址；后台授权人员可对允许的终态通知进行受控重发，保留操作记录。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 地址异常提示检查接入配置；不能通过重发通知修改交易结果或重复扣款。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款凭证

查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 本区域展示出款凭证，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在出款订单详情中能够查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 本区域展示出款凭证，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 出款凭证：可提供的交易凭证
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款订单详情 · 业务内容

查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 本区域展示disbursement Receipt Card，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在出款订单详情中能够查清一笔出款付给谁、扣了多少钱、是否成功，以及结果有没有通知商户系统。 本区域展示disbursement Receipt Card，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 出款成功不因结果通知失败而变成出款失败

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理结果

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-disbursement-report"></a>
## 出款报表

### 要解决什么问题

分析指定期间出款的金额、成功情况和费用，支持付款核对。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 日期和筛选：统计期间
- 指标与趋势：金额、笔数和变化
- 状态与转账类型：成功失败和银行/电子钱包等分类
- 费用和交易明细：核对出款成本与订单
- 报表筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 统计说明：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 期间趋势：分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Disbursement Trend，用于确认当前业务内容及下一步。
- 业务状态：分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Disbursement Status Breakdown，用于确认当前业务内容及下一步。
- 出款报表 · 业务内容：分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Transfer Type Breakdown，用于确认当前业务内容及下一步。
- 费用拆分：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 操作与下一步：说明「出款报表」中Created Date、出款订单号、Transfer Type、收款人、金额的用途，便于填写、查找或核对当前记录。
- 统计说明：在保持查询条件的前提下浏览更多记录。

### 用户如何完成业务

- 选择期间和筛选条件
- 查看交易明细
- 按页面入口导出

### 业务规则与结果

- 出款金额、手续费、钱包总扣款分别展示
- 处理中不能归入成功金额
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：报表筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 可选值：全部：不按该条件限制；已完成：当前业务处理结束；处理中：已开始处理但未结束；待处理：尚未得到最终业务结果；失败：本次业务未成功，查看原因；已取消：按允许阶段结束申请。 |
| Transfer type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：全部：不按该条件限制；Bank Transfer；E-wallet Transfer；Internal Transfer。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 可选值：全部：不按该条件限制；已完成：当前业务处理结束；处理中：已开始处理但未结束；待处理：尚未得到最终业务结果；失败：本次业务未成功，查看原因；已取消：按允许阶段结束申请。 |
| Transfer type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：全部：不按该条件限制；Bank Transfer；E-wallet Transfer；Internal Transfer。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「出款报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「出款报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：状态

在「出款报表」中，状态用于当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

背景与用途：这一部分让使用者在出款报表中能够在「出款报表」中，状态用于当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 可选值：全部：不按该条件限制；已完成：当前业务处理结束；处理中：已开始处理但未结束；待处理：尚未得到最终业务结果；失败：本次业务未成功，查看原因；已取消：按允许阶段结束申请。 |

业务规则：

- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Transfer type

在「出款报表」中，Transfer type用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：这一部分让使用者在出款报表中能够在「出款报表」中，Transfer type用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Transfer type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：全部：不按该条件限制；Bank Transfer；E-wallet Transfer；Internal Transfer。 |

业务规则：

- Transfer type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

在「出款报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

背景与用途：在「出款报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：最低金额

在「出款报表」中，最低金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在出款报表中能够在「出款报表」中，最低金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 最低金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：最高金额

在「出款报表」中，最高金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在出款报表中能够在「出款报表」中，最高金额用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 最高金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「出款报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「出款报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「出款报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「出款报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：期间趋势

分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Disbursement Trend，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在出款报表中能够分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Disbursement Trend，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 出款金额、手续费、钱包总扣款分别展示

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务状态

分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Disbursement Status Breakdown，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在出款报表中能够分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Disbursement Status Breakdown，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 出款金额、手续费、钱包总扣款分别展示

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款报表 · 业务内容

分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Transfer Type Breakdown，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在出款报表中能够分析指定期间出款的金额、成功情况和费用，支持付款核对。 本区域展示Transfer Type Breakdown，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 出款金额、手续费、钱包总扣款分别展示

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：费用拆分

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

说明「出款报表」中Created Date、出款订单号、Transfer Type、收款人、金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在出款报表中能够说明「出款报表」中Created Date、出款订单号、Transfer Type、收款人、金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 出款订单号（Disbursement ID） | iPay 为这笔出款生成的唯一编号，用于查询和追踪。 | 只读展示；无值时显示无记录或不适用。 |
| Transfer Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 收款人（Recipient） | 实际接收出款的人或商户；账户号码应脱敏展示。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Created Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 出款订单号：iPay 为这笔出款生成的唯一编号，用于查询和追踪。
- Transfer Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款订单号明细表

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 出款订单号（Disbursement ID） | iPay 为这笔出款生成的唯一编号，用于查询和追踪。 | 只读展示；无值时显示无记录或不适用。 |
| Transfer Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 收款人（Recipient） | 实际接收出款的人或商户；账户号码应脱敏展示。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

在保持查询条件的前提下浏览更多记录。

背景与用途：在保持查询条件的前提下浏览更多记录。

业务规则：

- 展示结果总数、当前页和每页数量；总数仅属于本次获授权筛选范围。
- 筛选变化后回到第一页，翻页不更改业务数据。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 最后一页不能继续下一页；新查询无记录时显示空结果，不显示旧页数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-disbursements"></a>
## 出款订单列表

### 要解决什么问题

查询出款订单，了解款项是否已转给收款人，并找到需要跟进的处理中或失败订单。

### 为什么这样设计

付款人员需要确认收款方及总扣款，并知道钱是否已经付出；明确处理中和通知状态，可以避免误判及重复转账。

### 谁在什么场景使用

有出款查看权限的商户财务或业务人员；在付款核对、收款人咨询或出款失败时查询当前商户订单。

### 页面包含哪些内容

- 搜索：按出款订单号、商户订单号、收款人、交易参考号或备注查找
- 状态分类：全部、成功、处理中、失败
- 高级筛选：日期、状态、来源、转账类型、收款机构、结果通知状态和金额范围
- 订单列表：订单号、收款人、类型、金额、状态、来源、时间、备注及详情入口
- 搜索与筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 出款订单列表：说明「出款订单列表」中出款订单号、收款人、类型、金额、状态的用途，便于填写、查找或核对当前记录。
- 出款状态分类：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

### 用户如何完成业务

- 输入关键词查询
- 点击状态分类快速筛选
- 在 Filters 中选择条件后点击 Apply filters，Reset 清除条件
- 点击 View 打开所选订单
- 按分页浏览或使用导出入口

### 业务规则与结果

- Succeeded 表示出款成功，Processing 表示仍在处理，Failed 表示出款失败
- 订单金额是出款本金，费用和总扣款在详情核对
- 结果通知是发送给商户系统的通知，与实际出款结果分开
- 金额下限不能大于上限；日期起点不能晚于终点。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Search disbursements | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款订单列表

说明「出款订单列表」中出款订单号、收款人、类型、金额、状态的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在出款订单列表中能够说明「出款订单列表」中出款订单号、收款人、类型、金额、状态的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 出款订单号（Disbursement ID） | iPay 为这笔出款生成的唯一编号，用于查询和追踪。 | 只读展示；无值时显示无记录或不适用。 |
| 收款人（Recipient） | 实际接收出款的人或商户；账户号码应脱敏展示。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 备注（Remark） | 供业务人员补充的信息；内部备注不自动显示给付款客户。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 出款订单号：iPay 为这笔出款生成的唯一编号，用于查询和追踪。
- 收款人：实际接收出款的人或商户；账户号码应脱敏展示。
- 类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款订单号明细表

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 出款订单号（Disbursement ID） | iPay 为这笔出款生成的唯一编号，用于查询和追踪。 | 只读展示；无值时显示无记录或不适用。 |
| 收款人（Recipient） | 实际接收出款的人或商户；账户号码应脱敏展示。 | 只读展示；无值时显示无记录或不适用。 |
| 类型（Type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 备注（Remark） | 供业务人员补充的信息；内部备注不自动显示给付款客户。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：筛选条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Date type | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选值：Created at；Completed at。 |
| Start date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |
| 转账类型（Disbursement type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 收款机构（Destination） | 收款账户所属的银行或电子钱包。 | 只读展示；无值时显示无记录或不适用。 |
| 商户结果通知状态（Merchant callback status） | 商户系统是否收到交易结果通知；通知失败不代表付款或出款失败。 | 只读展示；无值时显示无记录或不适用。 |
| 金额范围（Amount range） | 按最低和最高金额筛选；下限不能大于上限。 | 只读展示；无值时显示无记录或不适用。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Date type | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选值：Created at；Completed at。 |
| Start date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |
| 转账类型（Disbursement type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 收款机构（Destination） | 收款账户所属的银行或电子钱包。 | 只读展示；无值时显示无记录或不适用。 |
| 商户结果通知状态（Merchant callback status） | 商户系统是否收到交易结果通知；通知失败不代表付款或出款失败。 | 只读展示；无值时显示无记录或不适用。 |
| 金额范围（Amount range） | 按最低和最高金额筛选；下限不能大于上限。 | 只读展示；无值时显示无记录或不适用。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期

说明「出款订单列表」中日期、Date type、Start date、End date的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在出款订单列表中能够说明「出款订单列表」中日期、Date type、Start date、End date的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Date type | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选值：Created at；Completed at。 |
| Start date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。
- Date type：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- Start date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：状态

在「出款订单列表」中，状态用于当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

背景与用途：这一部分让使用者在出款订单列表中能够在「出款订单列表」中，状态用于当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：来源

在「出款订单列表」中，来源用于这条记录由哪个业务入口产生；来源不代表当前处理结果。

背景与用途：这一部分让使用者在出款订单列表中能够在「出款订单列表」中，来源用于这条记录由哪个业务入口产生；来源不代表当前处理结果，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 来源：这条记录由哪个业务入口产生；来源不代表当前处理结果。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：转账类型

在「出款订单列表」中，转账类型用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：这一部分让使用者在出款订单列表中能够在「出款订单列表」中，转账类型用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 转账类型（Disbursement type） | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 转账类型：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款机构

在「出款订单列表」中，收款机构用于收款账户所属的银行或电子钱包。

背景与用途：这一部分让使用者在出款订单列表中能够在「出款订单列表」中，收款机构用于收款账户所属的银行或电子钱包，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收款机构（Destination） | 收款账户所属的银行或电子钱包。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 收款机构：收款账户所属的银行或电子钱包。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户结果通知状态

在「出款订单列表」中，商户结果通知状态用于商户系统是否收到交易结果通知；通知失败不代表付款或出款失败。

背景与用途：在「出款订单列表」中，商户结果通知状态用于商户系统是否收到交易结果通知；通知失败不代表付款或出款失败。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 商户结果通知状态（Merchant callback status） | 商户系统是否收到交易结果通知；通知失败不代表付款或出款失败。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 通知状态与付款、出款及结算状态分别展示；通知失败不代表资金失败。
- 未发送、发送中、成功、失败和继续重试分别说明当前进展；展示最近尝试时间及可公开的失败原因。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 地址异常提示检查接入配置；不能通过重发通知修改交易结果或重复扣款。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额范围

说明「出款订单列表」中金额范围、最低金额、最高金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在出款订单列表中能够说明「出款订单列表」中金额范围、最低金额、最高金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额范围（Amount range） | 按最低和最高金额筛选；下限不能大于上限。 | 只读展示；无值时显示无记录或不适用。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 金额范围：按最低和最高金额筛选；下限不能大于上限。
- 最低金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 最高金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款状态分类

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 首版网页新建出款交付商户间转账。银行和电子钱包出款保留已有业务记录查询；只有该商户已开通且具备完整执行和异常处理能力的接入方式才可使用，不新增未经开通的创建入口。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

状态含义：

- 待处理（Pending）：出款订单已建立。
- 处理中（Processing）：正在执行出款，不能解释为已到账。
- 成功（Succeeded）：出款完成，查看完成时间及资金记录。
- 失败（Failed）：出款未成功，查询原因与余额恢复记录。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-export-detail"></a>
## 导出文件详情

### 要解决什么问题

确认一份导出文件包含什么数据、是否生成完成以及还能否下载。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 导出概览：任务状态
- 范围与参数：报表、日期及筛选
- 文件信息：文件名称和有效性
- 下载历史与时间线：追踪生成和下载
- 记录不存在或不可访问：把当前有权查看的记录带出用于核对，导出范围与页面一致。
- 导出概览：把当前有权查看的记录带出用于核对，导出范围与页面一致。
- 导出范围：把当前有权查看的记录带出用于核对，导出范围与页面一致。
- 导出参数：把当前有权查看的记录带出用于核对，导出范围与页面一致。
- 文件信息：确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 本区域展示文件信息，用于确认当前业务内容及下一步。
- 下载历史：确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 本区域展示下载历史，用于确认当前业务内容及下一步。
- 处理时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 查看导出参数
- 在文件可下载时下载结果

### 业务规则与结果

- 生成中、失败和过期均不能显示为可下载
- 文件内容应与本次任务记录的筛选范围一致
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：导出概览

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：导出范围

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：导出参数

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件信息

确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 本区域展示文件信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在导出文件详情中能够确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 本区域展示文件信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 文件信息：文件名称和有效性

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：下载历史

确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 本区域展示下载历史，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在导出文件详情中能够确认一份导出文件包含什么数据、是否生成完成以及还能否下载。 本区域展示下载历史，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 下载历史与时间线：追踪生成和下载

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-export-history"></a>
## 导出历史

### 要解决什么问题

集中查找已申请生成的报表文件，跟进生成状态并下载。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 筛选和日期：查找导出任务
- 任务汇总：了解任务状态
- 导出列表：报表类型、范围、生成结果和文件入口
- 查询条件：按「Export Filters」缩小导出历史的查询范围。
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 统计说明：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 已生成的导出文件：把当前有权查看的记录带出用于核对，导出范围与页面一致。
- 导出历史 · 记录明细：把当前有权查看的记录带出用于核对，导出范围与页面一致。

### 用户如何完成业务

- 筛选历史任务
- 打开详情核对范围
- 下载可用文件

### 业务规则与结果

- 导出任务与业务交易分别记录
- 失败任务不能用空文件表示成功
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：查询条件

按「Export Filters」缩小导出历史的查询范围。

背景与用途：按「Export Filters」缩小导出历史的查询范围。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 可选值：All Report Types；Collection Report；Settlement Report；Disbursement Report；Wallet Report；Fee Report。 |
| Export Status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 可选值：All Statuses；已完成：当前业务处理结束；处理中：已开始处理但未结束；失败：本次业务未成功，查看原因；已到期：不能继续新操作，保留历史。 |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 本标注是查询条件，只改变显示范围，不改变业务状态；选择多个条件时同时生效。

操作与交互结果：

- 选择条件后应用，重新查询并回到第一页；重置恢复默认条件。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 可选值：All Report Types；Collection Report；Settlement Report；Disbursement Report；Wallet Report；Fee Report。 |
| Export Status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 可选值：All Statuses；已完成：当前业务处理结束；处理中：已开始处理但未结束；失败：本次业务未成功，查看原因；已到期：不能继续新操作，保留历史。 |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「导出历史」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「导出历史」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：报表类型

在「导出历史」中，报表类型用于决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。

背景与用途：这一部分让使用者在导出历史中能够在「导出历史」中，报表类型用于决定导出的业务数据类别，文件仍受当前权限和筛选范围限制，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 可选值：All Report Types；Collection Report；Settlement Report；Disbursement Report；Wallet Report；Fee Report。 |

业务规则：

- 报表类型：决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务状态

在「导出历史」中，Export Status用于当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。

背景与用途：在「导出历史」中，Export Status用于当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Export Status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 可选值：All Statuses；已完成：当前业务处理结束；处理中：已开始处理但未结束；失败：本次业务未成功，查看原因；已到期：不能继续新操作，保留历史。 |

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 生成中：文件正在准备，显示范围和创建时间。
- 可下载：文件生成成功且仍在有效期内。
- 失败：生成未成功，保留参数并允许重试。
- 过期：不再提供旧文件下载，可按原条件重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件格式

在「导出历史」中，文件格式用于首版 CSV；其他格式不作为已交付能力显示。

背景与用途：这一部分让使用者在导出历史中能够在「导出历史」中，文件格式用于首版 CSV；其他格式不作为已交付能力显示，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |

业务规则：

- 文件格式：首版 CSV；其他格式不作为已交付能力显示。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

在「导出历史」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

背景与用途：在「导出历史」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「导出历史」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「导出历史」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「导出历史」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「导出历史」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已生成的导出文件

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 只读展示；无值时显示无记录或不适用。 |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 只读展示；无值时显示无记录或不适用。 |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| Requested By | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

状态含义：

- 生成中：文件正在准备，显示范围和创建时间。
- 可下载：文件生成成功且仍在有效期内。
- 失败：生成未成功，保留参数并允许重试。
- 过期：不再提供旧文件下载，可按原条件重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件格式明细表

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 只读展示；无值时显示无记录或不适用。 |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 只读展示；无值时显示无记录或不适用。 |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| Requested By | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 生成中：文件正在准备，显示范围和创建时间。
- 可下载：文件生成成功且仍在有效期内。
- 失败：生成未成功，保留参数并允许重试。
- 过期：不再提供旧文件下载，可按原条件重新生成。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：导出历史 · 记录明细

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：报表类型

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 可选值：Collection Report；Settlement Report；Disbursement Report；Wallet Report；Fee Report。 |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；Custom Range。 |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：查询结果导出

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 可选值：Collection Report；Settlement Report；Disbursement Report；Wallet Report；Fee Report。 |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；Custom Range。 |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：报表类型

在「导出历史」中，报表类型用于决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。

背景与用途：这一部分让使用者在导出历史中能够在「导出历史」中，报表类型用于决定导出的业务数据类别，文件仍受当前权限和筛选范围限制，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 报表类型（Report Type） | 决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。 | 可选值：Collection Report；Settlement Report；Disbursement Report；Wallet Report；Fee Report。 |

业务规则：

- 报表类型：决定导出的业务数据类别，文件仍受当前权限和筛选范围限制。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「导出历史」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「导出历史」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件格式

在「导出历史」中，文件格式用于首版 CSV；其他格式不作为已交付能力显示。

背景与用途：这一部分让使用者在导出历史中能够在「导出历史」中，文件格式用于首版 CSV；其他格式不作为已交付能力显示，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件格式（File Format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |

业务规则：

- 文件格式：首版 CSV；其他格式不作为已交付能力显示。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「导出历史」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「导出历史」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「导出历史」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「导出历史」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-fee-detail"></a>
## 费用明细

### 要解决什么问题

解释一笔费用因哪项业务产生，以及金额如何计算。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 费用概览：费用类型和金额
- 关联记录：产生费用的业务单据
- 计算明细：计费依据和当时使用的费率
- 时间线：费用记录过程
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 费用概览：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 关联业务：解释一笔费用因哪项业务产生，以及金额如何计算。 本区域展示关联业务，用于确认当前业务内容及下一步。
- 费用计算明细：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 处理时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 查看关联业务
- 核对计算依据

### 业务规则与结果

- 历史费用按照该笔业务发生时的规则解释，不能用今天的费率重新计算
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 费率依次经过草稿、待审批、批准。批准后按指定时间立即生效或等待生效；已排期表示已批准但尚未到生效时间。驳回不能生效，历史订单仍使用交易时费用。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：费用概览

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：关联业务

解释一笔费用因哪项业务产生，以及金额如何计算。 本区域展示关联业务，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在费用明细中能够解释一笔费用因哪项业务产生，以及金额如何计算。 本区域展示关联业务，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 历史费用按照该笔业务发生时的规则解释，不能用今天的费率重新计算

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：费用计算明细

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-fee-report"></a>
## 费用报表

### 要解决什么问题

了解一段时间商户承担了多少费用，并找到具体费用来源。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 日期和筛选：限定费用范围
- 费用汇总与趋势：金额变化
- 费用类型与业务来源：分类比较
- 费用明细：逐笔追溯
- 筛选条件：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 统计说明：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 期间趋势：了解一段时间商户承担了多少费用，并找到具体费用来源。 本区域展示Fee Trend，用于确认当前业务内容及下一步。
- 费用报表 · 统计指标：使商户收费或平台成本有清楚的适用范围、计算依据和生效记录。
- 费用报表 · 统计指标：了解一段时间商户承担了多少费用，并找到具体费用来源。 本区域展示Business Source Breakdown，用于确认当前业务内容及下一步。
- 操作与下一步：说明「费用报表」中日期、Fee ID、Fee Type、来源、金额的用途，便于填写、查找或核对当前记录。
- 统计说明：在保持查询条件的前提下浏览更多记录。

### 用户如何完成业务

- 切换统计期间
- 查看某笔费用及关联业务
- 按页面入口导出

### 业务规则与结果

- 收款、出款等费用分清业务来源
- 此页不展示平台的通道成本和利润
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 费率依次经过草稿、待审批、批准。批准后按指定时间立即生效或等待生效；已排期表示已批准但尚未到生效时间。驳回不能生效，历史订单仍使用交易时费用。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：筛选条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Fee Type | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 可选值：All Fees；Collection Fee；Disbursement Fee；Withdrawal Fee；Adjustment Fee。 |
| Business Source | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Sources；Payment Collection；Disbursement；Withdrawal；Manual Adjustment；Settlement Adjustment。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| Minimum Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| Maximum Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Fee Type | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 可选值：All Fees；Collection Fee；Disbursement Fee；Withdrawal Fee；Adjustment Fee。 |
| Business Source | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Sources；Payment Collection；Disbursement；Withdrawal；Manual Adjustment；Settlement Adjustment。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| Minimum Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| Maximum Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「费用报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「费用报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date Range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Fee Type

在「费用报表」中，Fee Type用于本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。

背景与用途：在「费用报表」中，Fee Type用于本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Fee Type | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 可选值：All Fees；Collection Fee；Disbursement Fee；Withdrawal Fee；Adjustment Fee。 |

业务规则：

- 展示产品、支付方式、计算方式、费率、固定费、上下限、币种及生效时间。
- 计算方式包含比例、固定金额、比例加固定金额；百分比与固定金额分别填写。
- 草稿、待审批、已排期、生效、驳回和停用分别描述，已排期必须已经批准；历史订单不重算。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 上下限冲突或必填费用缺失时禁止提交；通道成本不能作为商户公开费用展示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Business Source

在「费用报表」中，Business Source用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：这一部分让使用者在费用报表中能够在「费用报表」中，Business Source用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Business Source | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Sources；Payment Collection；Disbursement；Withdrawal；Manual Adjustment；Settlement Adjustment。 |

业务规则：

- Business Source：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

在「费用报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

背景与用途：在「费用报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Minimum Amount

在「费用报表」中，Minimum Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在费用报表中能够在「费用报表」中，Minimum Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Minimum Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- Minimum Amount：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Maximum Amount

在「费用报表」中，Maximum Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在费用报表中能够在「费用报表」中，Maximum Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Maximum Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- Maximum Amount：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「费用报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「费用报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「费用报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「费用报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：期间趋势

了解一段时间商户承担了多少费用，并找到具体费用来源。 本区域展示Fee Trend，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在费用报表中能够了解一段时间商户承担了多少费用，并找到具体费用来源。 本区域展示Fee Trend，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收款、出款等费用分清业务来源

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：费用报表 · 统计指标

使商户收费或平台成本有清楚的适用范围、计算依据和生效记录。

背景与用途：使商户收费或平台成本有清楚的适用范围、计算依据和生效记录。

业务规则：

- 展示产品、支付方式、计算方式、费率、固定费、上下限、币种及生效时间。
- 计算方式包含比例、固定金额、比例加固定金额；百分比与固定金额分别填写。
- 草稿、待审批、已排期、生效、驳回和停用分别描述，已排期必须已经批准；历史订单不重算。

操作与交互结果：

- 查看当前配置，编辑后核对差异并提交独立审批，批准后按生效时间应用。

异常处理：

- 上下限冲突或必填费用缺失时禁止提交；通道成本不能作为商户公开费用展示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：费用报表 · 统计指标

了解一段时间商户承担了多少费用，并找到具体费用来源。 本区域展示Business Source Breakdown，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在费用报表中能够了解一段时间商户承担了多少费用，并找到具体费用来源。 本区域展示Business Source Breakdown，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收款、出款等费用分清业务来源

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

说明「费用报表」中日期、Fee ID、Fee Type、来源、金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在费用报表中能够说明「费用报表」中日期、Fee ID、Fee Type、来源、金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Fee ID | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 只读展示；无值时显示无记录或不适用。 |
| Fee Type | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 只读展示；无值时显示无记录或不适用。 |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。
- Fee ID：本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。
- Fee Type：本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务参考号明细表

使商户收费或平台成本有清楚的适用范围、计算依据和生效记录。

背景与用途：使商户收费或平台成本有清楚的适用范围、计算依据和生效记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Fee ID | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 只读展示；无值时显示无记录或不适用。 |
| Fee Type | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 只读展示；无值时显示无记录或不适用。 |
| 来源（Source） | 这条记录由哪个业务入口产生；来源不代表当前处理结果。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示产品、支付方式、计算方式、费率、固定费、上下限、币种及生效时间。
- 计算方式包含比例、固定金额、比例加固定金额；百分比与固定金额分别填写。
- 草稿、待审批、已排期、生效、驳回和停用分别描述，已排期必须已经批准；历史订单不重算。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 上下限冲突或必填费用缺失时禁止提交；通道成本不能作为商户公开费用展示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

在保持查询条件的前提下浏览更多记录。

背景与用途：在保持查询条件的前提下浏览更多记录。

业务规则：

- 展示结果总数、当前页和每页数量；总数仅属于本次获授权筛选范围。
- 筛选变化后回到第一页，翻页不更改业务数据。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 最后一页不能继续下一页；新查询无记录时显示空结果，不显示旧页数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-forgot-password"></a>
## 重置登录密码

### 要解决什么问题

帮助无法登录的商户成员找回账号信息或重新设置登录密码。

### 为什么这样设计

先确认账号归属再开放业务，避免他人看到商户资料或操作资金；验证失败时仍应让本人知道如何恢复使用。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 找回登录邮箱：通过账户联系信息找回
- 身份验证：验证账号归属
- 重置密码：输入并确认新密码
- 账号凭据：在「重置登录密码」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。
- 重置登录密码 · 业务内容：帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示auth-step，用于确认当前业务内容及下一步。
- 重置登录密码 · 信息区域：帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示重置登录密码 · 信息区域，用于确认当前业务内容及下一步。
- 账号凭据：让用户建立或验证账号归属，并保护登录和资金操作。

### 用户如何完成业务

- 选择对应找回方式
- 完成身份验证后重置
- 返回登录

### 业务规则与结果

- 未通过身份验证不能改密
- 验证码错误或失效需明确提示
- 主动改密完成身份验证后保留当前设备登录，其他设备退出；忘记密码重置后全部旧登录失效，需要重新登录。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：账号凭据

在「重置登录密码」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

背景与用途：在「重置登录密码」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 登录邮箱（Email） | 登录使用的账号标识，输入后用于确认账号归属。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录邮箱

在「重置登录密码」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

背景与用途：在「重置登录密码」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 登录邮箱（Email） | 登录使用的账号标识，输入后用于确认账号归属。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 业务内容

帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示auth-step，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在重置登录密码中能够帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示auth-step，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 未通过身份验证不能改密

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 填写与确认

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 信息区域

帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示重置登录密码 · 信息区域，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在重置登录密码中能够帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示重置登录密码 · 信息区域，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 未通过身份验证不能改密
- 主动改密完成身份验证后保留当前设备登录，其他设备退出；忘记密码重置后全部旧登录失效，需要重新登录。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号凭据

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| New password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |
| Confirm new password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：New password

在「重置登录密码」中，New password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「重置登录密码」中，New password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| New password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Confirm new password

在「重置登录密码」中，Confirm new password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「重置登录密码」中，Confirm new password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Confirm new password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 办理流程

帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示forgot reset submit，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在重置登录密码中能够帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示forgot reset submit，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 未通过身份验证不能改密

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 业务内容

帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示auth-step，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在重置登录密码中能够帮助无法登录的商户成员找回账号信息或重新设置登录密码。 本区域展示auth-step，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 未通过身份验证不能改密

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 办理入口

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：重置登录密码 · 办理入口

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-in-store-qr"></a>
## 门店收款码

### 要解决什么问题

管理门店和柜台使用的收款二维码，确认哪些码可以继续使用。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 收款码列表：对应门店、位置和状态
- 管理入口：创建和查看二维码
- Store Name：让客户扫描指定门店的有效二维码完成付款。
- 门店收款码 · 业务信息：说明「门店收款码」中Store Name、收款码编号、状态、Created Date、Internal Note的用途，便于填写、查找或核对当前记录。

### 用户如何完成业务

- 从创建入口为门店建立收款码
- 打开详情查看海报及可用操作

### 业务规则与结果

- 未签发、停用或过期的码不能继续作为有效收款码
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：Store Name

让客户扫描指定门店的有效二维码完成付款。

背景与用途：让客户扫描指定门店的有效二维码完成付款。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 收款码编号（QR Reference） | 用于识别本次签发的门店收款码，与付款订单编号分开。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Internal Note | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 显示商户、门店、收款位置和二维码状态；二维码必须属于当前有效门店。
- 已停用、失效或无门店时不可作为有效收款码展示。
- 首版支持下载和打印素材，不包含实体立牌配送。

操作与交互结果：

- 创建时选择门店、核对展示信息；查看时可保存素材，使用前检查状态。

异常处理：

- 无权限保存或素材下载失败时说明原因并支持重试；扫码失效给客户明确不可付款提示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：门店收款码 · 业务信息

说明「门店收款码」中Store Name、收款码编号、状态、Created Date、Internal Note的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在门店收款码中能够说明「门店收款码」中Store Name、收款码编号、状态、Created Date、Internal Note的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 收款码编号（QR Reference） | 用于识别本次签发的门店收款码，与付款订单编号分开。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Internal Note | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Store Name：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。
- 收款码编号：用于识别本次签发的门店收款码，与付款订单编号分开。
- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款码编号明细表

说明「门店收款码」中Store Name、收款码编号、状态、Created Date、Internal Note的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在门店收款码中能够说明「门店收款码」中Store Name、收款码编号、状态、Created Date、Internal Note的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 收款码编号（QR Reference） | 用于识别本次签发的门店收款码，与付款订单编号分开。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Created Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Internal Note | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Store Name：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。
- 收款码编号：用于识别本次签发的门店收款码，与付款订单编号分开。
- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-invitation-acceptance"></a>
## 接受商户邀请

### 要解决什么问题

根据邀请链接确认加入指定商户，先同意法律条款，再按邮箱是否已有账号完成新账号创建或直接绑定。

### 为什么这样设计

先确认账号归属再开放业务，避免他人看到商户资料或操作资金；验证失败时仍应让本人知道如何恢复使用。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 邀请信息：商户、受邀身份和邀请状态
- 接受入口：确认加入
- 姓名：说明「接受团队邀请」中姓名、Email verification的用途，便于填写、查找或核对当前记录。

### 用户如何完成业务

- 核对邀请对象后接受
- 邀请无效时联系邀请人

### 业务规则与结果

- 管理端建户只要求 Owner 邮箱，不收 Owner 用户名、姓名或密码；创建 NOT_ACTIVATION 商户、本商户唯一 OWNER 角色和 Owner 邀请，不创建用户或成员。
- 邀请页按 token 读取邀请，邮箱只读，提交不接收邮箱；仅打开链接不创建用户或成员。先接受法律条款，新用户弹框填写姓名和密码，已有用户直接确认绑定且不修改原姓名、密码。
- 接受 Owner 邀请成功后才创建成员并将 NOT_ACTIVATION 改为 PENDING_KYB；已有用户同样必须接受。员工接受邀请只绑定成员，不改变商户状态。
- 邀请默认 24 小时，可配置；重发替换旧 token 并重新计时；过期、撤销、已接受链接均不能创建用户或成员。管理端重发 Owner 邀请仅限 NOT_ACTIVATION；员工邀请及重发要求 ACTIVE 和当前角色权限。
- 不能把过期或已失效的邀请当作仍然有效
- 加入后的可用操作由所分配权限决定

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：邀请邮箱与账号激活

根据邀请链接确认加入指定商户，先同意法律条款，再按邮箱是否已有账号完成新账号创建或直接绑定。

背景与用途：这一部分让使用者在接受团队邀请中能够说明「接受团队邀请」中姓名、Email verification的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 邀请邮箱（Email） | 邀请指定的收件邮箱，只读展示；提交不允许替换邮箱。 | 从有效邀请 token 读取。 |

业务规则：

- 管理端建户只要求 Owner 邮箱，不收 Owner 用户名、姓名或密码；创建 NOT_ACTIVATION 商户、本商户唯一 OWNER 角色和 Owner 邀请，不创建用户或成员。
- 邀请页按 token 读取邀请，邮箱只读，提交不接收邮箱；仅打开链接不创建用户或成员。先接受法律条款，新用户弹框填写姓名和密码，已有用户直接确认绑定且不修改原姓名、密码。
- 接受 Owner 邀请成功后才创建成员并将 NOT_ACTIVATION 改为 PENDING_KYB；已有用户同样必须接受。员工接受邀请只绑定成员，不改变商户状态。
- 邀请默认 24 小时，可配置；重发替换旧 token 并重新计时；过期、撤销、已接受链接均不能创建用户或成员。管理端重发 Owner 邀请仅限 NOT_ACTIVATION；员工邀请及重发要求 ACTIVE 和当前角色权限。
- 不能把过期或已失效的邀请当作仍然有效
- 加入后的可用操作由所分配权限决定

操作与交互结果：

- 接受条款后继续：新用户弹框填写姓名和密码；已有用户直接确认绑定。

异常处理：

- 链接过期、已使用或角色不可用时拒绝接受，不创建用户或成员。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：邀请邮箱与账号激活

根据邀请链接确认加入指定商户，先同意法律条款，再按邮箱是否已有账号完成新账号创建或直接绑定。

背景与用途：这一部分让使用者在接受团队邀请中能够在「接受团队邀请」中，姓名用于当前账号或申请人的真实姓名；与企业名称分开填写，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 邀请邮箱（Email） | 邀请指定的收件邮箱，只读展示；提交不允许替换邮箱。 | 从有效邀请 token 读取。 |

业务规则：

- 管理端建户只要求 Owner 邮箱，不收 Owner 用户名、姓名或密码；创建 NOT_ACTIVATION 商户、本商户唯一 OWNER 角色和 Owner 邀请，不创建用户或成员。
- 邀请页按 token 读取邀请，邮箱只读，提交不接收邮箱；仅打开链接不创建用户或成员。先接受法律条款，新用户弹框填写姓名和密码，已有用户直接确认绑定且不修改原姓名、密码。
- 接受 Owner 邀请成功后才创建成员并将 NOT_ACTIVATION 改为 PENDING_KYB；已有用户同样必须接受。员工接受邀请只绑定成员，不改变商户状态。
- 邀请默认 24 小时，可配置；重发替换旧 token 并重新计时；过期、撤销、已接受链接均不能创建用户或成员。管理端重发 Owner 邀请仅限 NOT_ACTIVATION；员工邀请及重发要求 ACTIVE 和当前角色权限。
- 不能把过期或已失效的邀请当作仍然有效
- 加入后的可用操作由所分配权限决定

操作与交互结果：

- 接受条款后继续：新用户弹框填写姓名和密码；已有用户直接确认绑定。

异常处理：

- 链接过期、已使用或角色不可用时拒绝接受，不创建用户或成员。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：接受团队邀请 · 填写与确认

让受邀成员确认加入哪家商户，并完成加入流程。 本区域展示v2-field，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在接受团队邀请中能够让受邀成员确认加入哪家商户，并完成加入流程。 本区域展示v2-field，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 管理端建户只要求 Owner 邮箱，不收 Owner 用户名、姓名或密码；创建 NOT_ACTIVATION 商户、本商户唯一 OWNER 角色和 Owner 邀请，不创建用户或成员。
- 邀请页按 token 读取邀请，邮箱只读，提交不接收邮箱；仅打开链接不创建用户或成员。先接受法律条款，新用户弹框填写姓名和密码，已有用户直接确认绑定且不修改原姓名、密码。
- 接受 Owner 邀请成功后才创建成员并将 NOT_ACTIVATION 改为 PENDING_KYB；已有用户同样必须接受。员工接受邀请只绑定成员，不改变商户状态。
- 邀请默认 24 小时，可配置；重发替换旧 token 并重新计时；过期、撤销、已接受链接均不能创建用户或成员。管理端重发 Owner 邀请仅限 NOT_ACTIVATION；员工邀请及重发要求 ACTIVE 和当前角色权限。
- 不能把过期或已失效的邀请当作仍然有效

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-kyb-onboarding"></a>
## 提交企业认证

### 要解决什么问题

引导商户填写企业资料并上传证明文件，以申请开通相应业务能力。

### 为什么这样设计

商户需要知道谁能访问自己的业务、资料是否准确以及谁做过修改；日常资料和认证资料分清，才能避免误改。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 企业与地址：企业身份和注册地点
- 授权代表及受益人：谁负责、谁持有企业权益
- 认证文件：支持申请的证明
- 草稿和补件提示：了解当前进度
- 企业信息：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。
- 企业信息：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 企业地址：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 授权代表：说明由谁代表企业，以及谁实际拥有或控制企业。
- 股东与受益所有人：说明由谁代表企业，以及谁实际拥有或控制企业。
- 认证文件：向审核人员提供与当前企业或人员对应的证明材料。
- 资料填写：引导商户填写企业资料并上传证明文件，以申请开通相应业务能力。 本区域展示I confirm that I am authorized to submit this information and that it is complete and accurate.，用于确认当前业务内容及下一步。
- 提交企业认证 · 办理流程：向尚未完成开通或首次使用的商户提供清楚的下一步。
- 资料填写：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。
- 提交企业认证 · 办理流程：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

### 用户如何完成业务

- 按步骤填写并保存草稿
- 检查完整性后提交
- 有补件要求时补充指定资料

### 业务规则与结果

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 必填项与材料不全不能提交
- 已提交版本只读
- 提交完成表示等待审核，不等于已通过认证

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：企业信息

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Service phone | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 必填；未完成时在此字段提示。 |
| Business type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Select business type；Catering；Service；Supermarket；Other。 |
| Enterprise form | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Select enterprise form；Partnership / Corporation；Sole Proprietorship；Individual。 |
| Company name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Store prefix | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Industries | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Service hours | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Registration number | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Tax Identification Number | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Registration date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 必填；未完成时在此字段提示。 |
| Website / social links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Business description | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 必填；未完成时在此字段提示。 |
| Detailed address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 必填；未完成时在此字段提示。 |
| Region / Province | Region：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；省或地区：地址所属行政区域，与城市和街区保持一致。 | 必填；未完成时在此字段提示。 |
| 城市（City / Municipality） | 地址所在城市或市镇，与选定省份匹配。 | 必填；未完成时在此字段提示。 |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 必填；未完成时在此字段提示。 |
| 邮政编码（Postal code） | 对应地址的邮政编码，按当地有效格式填写。 | 必填；未完成时在此字段提示。 |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |
| 经纬度（Longitude / latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 必填；未完成时在此字段提示。 |
| Given name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Last name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Position / title | Position：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；title：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| 出生日期（Date of birth） | 认证人员真实出生日期，不接受未来日期。 | 必填；未完成时在此字段提示。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 必填；未完成时在此字段提示。 |
| 手机号（Phone） | 联系使用的号码；可选字段未填写不影响仅依赖账号资料的保存。 | 必填；未完成时在此字段提示。 |
| 邮箱（Email） | 账号验证或联系使用的邮箱，明确用途；已验证邮箱变更需相应验证。 | 必填；未完成时在此字段提示。 |
| ID type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Select ID type；Passport；Driver's License；National ID。 |
| ID number | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Place of birth | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Current address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 必填；未完成时在此字段提示。 |
| Permanent address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 必填；未完成时在此字段提示。 |
| Occupation | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Source of income | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 必填；未完成时在此字段提示。 |

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：企业信息

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Service phone | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 必填；未完成时在此字段提示。 |
| Business type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Select business type；Catering；Service；Supermarket；Other。 |
| Enterprise form | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Select enterprise form；Partnership / Corporation；Sole Proprietorship；Individual。 |
| Company name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Store prefix | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Industries | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Service hours | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Registration number | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Tax Identification Number | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Registration date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 必填；未完成时在此字段提示。 |
| Website / social links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Business description | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 必填；未完成时在此字段提示。 |

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：企业地址

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Detailed address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 必填；未完成时在此字段提示。 |
| Region / Province | Region：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；省或地区：地址所属行政区域，与城市和街区保持一致。 | 必填；未完成时在此字段提示。 |
| 城市（City / Municipality） | 地址所在城市或市镇，与选定省份匹配。 | 必填；未完成时在此字段提示。 |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 必填；未完成时在此字段提示。 |
| 邮政编码（Postal code） | 对应地址的邮政编码，按当地有效格式填写。 | 必填；未完成时在此字段提示。 |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |
| 经纬度（Longitude / latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 必填；未完成时在此字段提示。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：授权代表

说明由谁代表企业，以及谁实际拥有或控制企业。

背景与用途：说明由谁代表企业，以及谁实际拥有或控制企业。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Given name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Last name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 必填；未完成时在此字段提示。 |
| Position / title | Position：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；title：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| 出生日期（Date of birth） | 认证人员真实出生日期，不接受未来日期。 | 必填；未完成时在此字段提示。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 必填；未完成时在此字段提示。 |
| 手机号（Phone） | 联系使用的号码；可选字段未填写不影响仅依赖账号资料的保存。 | 必填；未完成时在此字段提示。 |
| 邮箱（Email） | 账号验证或联系使用的邮箱，明确用途；已验证邮箱变更需相应验证。 | 必填；未完成时在此字段提示。 |
| ID type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Select ID type；Passport；Driver's License；National ID。 |
| ID number | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Place of birth | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Current address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 必填；未完成时在此字段提示。 |
| Permanent address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 必填；未完成时在此字段提示。 |
| Occupation | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 必填；未完成时在此字段提示。 |
| Source of income | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 必填；未完成时在此字段提示。 |

业务规则：

- 展示姓名、身份信息、国籍、出生日期、持股或控制关系；多位所有人分别记录。
- 持股比例是企业归属信息，不是费率；身份证明仅授权人员查看。

操作与交互结果：

- 逐人填写或核对资料；更换代表人或所有人时保留相应审核依据。

异常处理：

- 必要资料缺失或比例格式不正确时提示对应人员，不能用其他人的资料补位。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：股东与受益所有人

说明由谁代表企业，以及谁实际拥有或控制企业。

背景与用途：说明由谁代表企业，以及谁实际拥有或控制企业。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 展示姓名、身份信息、国籍、出生日期、持股或控制关系；多位所有人分别记录。
- 持股比例是企业归属信息，不是费率；身份证明仅授权人员查看。

操作与交互结果：

- 逐人填写或核对资料；更换代表人或所有人时保留相应审核依据。

异常处理：

- 必要资料缺失或比例格式不正确时提示对应人员，不能用其他人的资料补位。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：认证文件

向审核人员提供与当前企业或人员对应的证明材料。

背景与用途：向审核人员提供与当前企业或人员对应的证明材料。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 每份文件列出类型、文件名、上传时间和审核状态，明确属于哪个对象。
- 敏感文件仅授权人员可查看或下载，不通过猜测网址访问。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 选择文件类型并上传，核对预览后提交；审核不通过时说明需替换哪份资料。

异常处理：

- 上传失败保留其他已填资料；文件不可读或类型不符时明确提示，不显示上传成功。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：资料填写

引导商户填写企业资料并上传证明文件，以申请开通相应业务能力。 本区域展示I confirm that I am authorized to submit this information and that it is complete and accurate.，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在提交企业认证中能够引导商户填写企业资料并上传证明文件，以申请开通相应业务能力。 本区域展示I confirm that I am authorized to submit this information and that it is complete and accurate.，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 必填项与材料不全不能提交

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：提交企业认证 · 办理流程

向尚未完成开通或首次使用的商户提供清楚的下一步。

背景与用途：向尚未完成开通或首次使用的商户提供清楚的下一步。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 账号建立、企业认证和业务开通分别表示。
- 已经完成的步骤不要求重复提交；未开通业务说明限制及办理条件。

操作与交互结果：

- 继续认证进入现有认证流程；创建收款链接进入固定金额收款链接；管理资金进入钱包。

异常处理：

- 缺少查看权限时不暴露对应敏感内容；已完成引导后展示正常经营入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：资料填写

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：提交企业认证 · 办理流程

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：认证步骤

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-login"></a>
## 商户登录

### 要解决什么问题

验证商户成员身份，进入自己有权限使用的商户工作区。

### 为什么这样设计

先确认账号归属再开放业务，避免他人看到商户资料或操作资金；验证失败时仍应让本人知道如何恢复使用。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 登录邮箱与密码：登录凭据
- 安全题：多次输入错误时出现
- 登录及找回入口：继续验证或找回账号
- 登录邮箱：在「商户登录」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。
- 密码：在「商户登录」中，密码用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。
- Answer：说明「商户登录」中Answer的用途，便于填写、查找或核对当前记录。
- 商户登录 · 办理流程：让用户建立或验证账号归属，并保护登录和资金操作。

### 用户如何完成业务

- 填写登录邮箱和密码
- 按要求回答安全题
- 继续完成身份验证

### 业务规则与结果

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 凭据错误给出统一提示
- 不能在身份验证完成前进入受保护业务

### 特殊情况

- 凭据或验证码错误时提示重新输入；验证码失效时提示重新获取。
- 验证过程中禁用重复提交；失败后保留重新验证或返回登录的入口。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：账号凭据

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 登录邮箱（Email） | 登录使用的账号标识，输入后用于确认账号归属。 | 可选；不适用时允许留空。 |
| 密码（Password） | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |
| Answer | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录邮箱

在「商户登录」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

背景与用途：在「商户登录」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 登录邮箱（Email） | 登录使用的账号标识，输入后用于确认账号归属。 | 可选；不适用时允许留空。 |

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：密码

在「商户登录」中，密码用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「商户登录」中，密码用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 密码（Password） | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户登录 · 办理流程

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Answer

说明「商户登录」中Answer的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在商户登录中能够说明「商户登录」中Answer的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Answer | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- Answer：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Answer

在「商户登录」中，Answer用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在商户登录中能够在「商户登录」中，Answer用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Answer | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- Answer：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户登录 · 业务内容

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户登录 · 办理流程

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户登录 · 业务内容

验证商户成员身份，进入自己有权限使用的商户工作区。 本区域展示login register link，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户登录中能够验证商户成员身份，进入自己有权限使用的商户工作区。 本区域展示login register link，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 凭据错误给出统一提示

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-money"></a>
## 商户钱包

### 要解决什么问题

查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 余额：可用、待结算、冻结及总额
- 快捷操作：充值、提现等已授权入口
- 待处理充值：跟进资金申请
- 最近流水：核对已发生的余额变化
- 待办与业务提示：让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。
- 读取进度：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 钱包管理：查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示钱包管理，用于确认当前业务内容及下一步。
- 商户钱包：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 快捷操作：查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示快捷操作，用于确认当前业务内容及下一步。
- 待处理充值：帮助商户建立和跟进一笔向钱包补充资金的申请。
- 最近钱包变动：说明「商户钱包」中时间、收支方向、Transaction Type、Details、金额的用途，便于填写、查找或核对当前记录。

### 用户如何完成业务

- 进入资金操作页面
- 查看待处理申请及流水详情

### 业务规则与结果

- 可用余额才是当前可支配金额
- 待结算、冻结资金不计入可用
- 资金申请与已经入账的流水分别展示
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 向商户展示可公开的冻结原因、受影响金额、需补资料和处理入口；内部风险识别细节仅供授权人员查看。未有可靠预计时间时不承诺恢复时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：待办与业务提示

让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

背景与用途：让用户发现当前必须处理的事项，并知道下一步找谁或去哪里办理。

业务规则：

- 提示包含问题对象、当前状态、影响及下一步。
- 认证、余额限制和待复核事项分别描述；已处理事项不继续作为未处理提醒。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。

操作与交互结果：

- 点击事项进入该笔申请或对应办理页面；处理后返回刷新该事项结果。

异常处理：

- 没有待办说明目前没有需要处理的事项；无权限查看具体对象时提供可联系角色，不泄露敏感细节。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取进度

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包管理

查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示钱包管理，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户钱包中能够查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示钱包管理，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可用余额才是当前可支配金额

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户钱包

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：快捷操作

查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示快捷操作，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户钱包中能够查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示快捷操作，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 快捷操作：充值、提现等已授权入口

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：待处理充值

帮助商户建立和跟进一笔向钱包补充资金的申请。

背景与用途：帮助商户建立和跟进一笔向钱包补充资金的申请。

业务规则：

- 金额大于零且最多两位小数；根据充值方式展示费用和实付总额。
- 申请已提交、实际已付款、资料已核实、已入账分别表示。
- 少付、多付、重复和凭证不一致进入待核实，核实前不作为到账完成。

操作与交互结果：

- 填写金额，选择可用方式并确认费用；依付款指引办理，随后在申请详情跟进结果。

状态含义：

- 等待付款（Awaiting Transfer）：申请已建立，等待商户按指引付款。
- 等待审批（Pending Approval）：等待独立复核。
- 等待核实（Pending Verification）：等待核对实际付款与凭证，差额单独说明。
- 处理中（Processing）：核实后的业务正在执行，不等于已入账。
- 完成（Completed）：已完成实际入账，可查看钱包流水。
- 驳回（Rejected）：申请未获通过；可补正资料时保留原申请重新提交，已付款款项继续跟进。
- 到期／取消：只适用于未付款且符合结束条件的申请。

异常处理：

- 结果未知时保留申请编号查询，不要求再次付款；未付款申请可在允许阶段取消。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：最近钱包变动

说明「商户钱包」中时间、收支方向、Transaction Type、Details、金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在商户钱包中能够说明「商户钱包」中时间、收支方向、Transaction Type、Details、金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 只读展示；无值时显示无记录或不适用。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Details | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 变动后余额（Balance After） | 该笔已记账事件发生后的对应余额，与当前最新余额区分。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 时间：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。
- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户钱包明细表

说明「商户钱包」中时间、收支方向、Transaction Type、Details、金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在商户钱包中能够说明「商户钱包」中时间、收支方向、Transaction Type、Details、金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 只读展示；无值时显示无记录或不适用。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Details | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 变动后余额（Balance After） | 该笔已记账事件发生后的对应余额，与当前最新余额区分。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 时间：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。
- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户钱包 · 办理流程

查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示Wallet verification，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户钱包中能够查看可使用、待结算及冻结资金，并进入充值、提现或钱包流水。 本区域展示Wallet verification，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可用余额才是当前可支配金额

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-notifications"></a>
## 商户消息

### 要解决什么问题

集中查看与商户业务相关的通知，找到需要关注的事件。

### 为什么这样设计

日常工作需要先知道经营和资金状况，再决定处理哪件事；概览必须能继续找到具体业务，避免只看到数字而无法跟进。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 消息列表：通知标题、时间和阅读状态
- 查询工具：查找相关消息
- 消息：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 商户消息：告诉用户发生了什么，并能继续查看对应业务。

### 用户如何完成业务

- 阅读消息
- 通过可用关联入口查看业务记录

### 业务规则与结果

- 消息阅读状态不改变对应订单或申请的业务状态
- 只发送有完整查看路径的业务通知。点击后进入对应消息及业务对象；无权或对象不可用时解释原因并可返回消息列表。首版不为缺少详情路径的新增出款或退款业务发送悬空通知。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：消息

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 只发送有完整查看路径的业务通知。点击后进入对应消息及业务对象；无权或对象不可用时解释原因并可返回消息列表。首版不为缺少详情路径的新增出款或退款业务发送悬空通知。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户消息

告诉用户发生了什么，并能继续查看对应业务。

背景与用途：告诉用户发生了什么，并能继续查看对应业务。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Update | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Related object | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 展示消息标题、摘要、发生时间、已读状态和关联业务。
- 只发送有完整查看路径的通知，不把发送成功当作业务成功。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。
- 只发送有完整查看路径的业务通知。点击后进入对应消息及业务对象；无权或对象不可用时解释原因并可返回消息列表。首版不为缺少详情路径的新增出款或退款业务发送悬空通知。

操作与交互结果：

- 点击消息打开该消息内容，再进入对应订单或申请；关闭详情或返回后保留列表位置。

异常处理：

- 对象不可访问时说明原因并能返回，不能跳到别的订单。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户消息明细表

说明「商户消息」中时间、Update、Related object、状态、操作的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在商户消息中能够说明「商户消息」中时间、Update、Related object、状态、操作的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Update | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Related object | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 时间：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- Update：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- Related object：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。
- 只发送有完整查看路径的业务通知。点击后进入对应消息及业务对象；无权或对象不可用时解释原因并可返回消息列表。首版不为缺少详情路径的新增出款或退款业务发送悬空通知。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-payment-details"></a>
## 收款订单详情

### 要解决什么问题

核对客户付款结果、商户费用、结算情况和商户系统通知情况。

### 为什么这样设计

客户是否付款、是否结算以及是否通知商户系统是不同事实；分开解释可以减少对账争议和重复处理。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 订单概览与付款人：确认哪笔付款
- 订单上下文：关联工具和业务参考
- 结算与费用：款项何时、以多少净额入账
- 结果通知与时间线：追踪处理
- 订单不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 付款概览：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。
- 付款来源：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。
- 订单信息：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。
- 付款人信息：核对客户付款结果、商户费用、结算情况和商户系统通知情况。 本区域展示付款人信息，用于确认当前业务内容及下一步。
- 结算信息：核对客户付款结果、商户费用、结算情况和商户系统通知情况。 本区域展示结算信息，用于确认当前业务内容及下一步。
- 退款与费用概况：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 商户结果通知：说明交易结果是否已成功送到商户的系统。
- 交易时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 打开订单查看付款信息
- 沿关联入口核对结算记录

### 业务规则与结果

- 付款成功不等于钱包已入账
- 结果通知失败不改变客户实际付款结果
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：订单不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款概览

确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

背景与用途：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

业务规则：

- 展示平台订单号、商户订单号、所属商户、业务来源、金额、币种及创建时间。
- 付款状态与结算状态、结果通知状态分别解释；处理中不等于成功。
- 已经退款仍保留原付款成功事实及独立退款金额。

操作与交互结果：

- 从列表打开同一笔订单，按关联入口查询费用、结算或钱包变化；返回保留原查询条件。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 找不到该订单时提示不存在或不可访问；未完成时完成时间显示未完成。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款来源

确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

背景与用途：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

业务规则：

- 展示平台订单号、商户订单号、所属商户、业务来源、金额、币种及创建时间。
- 付款状态与结算状态、结果通知状态分别解释；处理中不等于成功。
- 已经退款仍保留原付款成功事实及独立退款金额。

操作与交互结果：

- 从列表打开同一笔订单，按关联入口查询费用、结算或钱包变化；返回保留原查询条件。

异常处理：

- 找不到该订单时提示不存在或不可访问；未完成时完成时间显示未完成。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：订单信息

确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

背景与用途：确认这笔交易是谁发起、属于谁以及当前处于哪个业务阶段。

业务规则：

- 展示平台订单号、商户订单号、所属商户、业务来源、金额、币种及创建时间。
- 付款状态与结算状态、结果通知状态分别解释；处理中不等于成功。
- 已经退款仍保留原付款成功事实及独立退款金额。

操作与交互结果：

- 从列表打开同一笔订单，按关联入口查询费用、结算或钱包变化；返回保留原查询条件。

异常处理：

- 找不到该订单时提示不存在或不可访问；未完成时完成时间显示未完成。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款人信息

核对客户付款结果、商户费用、结算情况和商户系统通知情况。 本区域展示付款人信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在收款订单详情中能够核对客户付款结果、商户费用、结算情况和商户系统通知情况。 本区域展示付款人信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款成功不等于钱包已入账

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算信息

核对客户付款结果、商户费用、结算情况和商户系统通知情况。 本区域展示结算信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在收款订单详情中能够核对客户付款结果、商户费用、结算情况和商户系统通知情况。 本区域展示结算信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款成功不等于钱包已入账
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：退款与费用概况

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户结果通知

说明交易结果是否已成功送到商户的系统。

背景与用途：说明交易结果是否已成功送到商户的系统。

业务规则：

- 通知状态与付款、出款及结算状态分别展示；通知失败不代表资金失败。
- 未发送、发送中、成功、失败和继续重试分别说明当前进展；展示最近尝试时间及可公开的失败原因。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 商户查看结果和通知地址；后台授权人员可对允许的终态通知进行受控重发，保留操作记录。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 地址异常提示检查接入配置；不能通过重发通知修改交易结果或重复扣款。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款查询与操作结果

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-payment-links"></a>
## 收款链接

### 要解决什么问题

创建可发送给客户的付款链接，并管理其状态。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 链接列表：金额、说明和可用状态
- 创建表单：金额、描述及可选备注
- 归档显示：查找不再日常使用的链接
- Show archived links：通过一个固定金额链接向客户发起收款，并跟进付款结果。
- Show archived links：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 搜索与筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 收款链接 · 业务信息：说明「收款链接」中Reference number、金额、Created date、说明、Remarks的用途，便于填写、查找或核对当前记录。
- 金额（菲律宾比索）：在「收款链接」中，金额（菲律宾比索）用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 说明：在「收款链接」中，说明用于帮助识别该业务的文字内容，不代替订单状态或金额。
- 备注（可选）：在「收款链接」中，备注（可选）用于解释本条业务的补充文字；内部备注与客户可见说明分别处理。

### 用户如何完成业务

- 填写金额和描述创建链接
- 从列表管理或查看链接
- 按开关查看归档记录

### 业务规则与结果

- 金额和说明应让客户清楚要支付什么
- 归档不等于删除历史订单
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 创建时默认一次性，商户可明确选择重复使用。一次性链接成功收款后停止收款；重复使用链接的每笔付款独立生成订单。未成功付款不直接标为已使用。
- 首版采用商户指定的固定金额，必须大于零，最多两位小数；允许设置未来到期时间。未设置时不自动到期；到期或停用后不可继续发起新付款。首版不提供客户自填金额。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：Show archived links

通过一个固定金额链接向客户发起收款，并跟进付款结果。

背景与用途：通过一个固定金额链接向客户发起收款，并跟进付款结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Show archived links | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Reference number | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| Created date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| Remarks | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 默认一次性，可选择重复使用；每笔付款独立成单。
- 金额大于零、最多两位小数；可设置未来到期时间，未设置不自动到期。
- 一次性成功付款或链接失效后不能继续发起新付款。

操作与交互结果：

- 填写金额和说明，核对使用次数与有效期后创建；复制链接提供给客户，按链接查询关联付款。

异常处理：

- 停用链接向客户显示无法付款；归档保留历史，不删除交易。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Show archived links

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Show archived links | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Show archived links

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Show archived links | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款链接 · 业务信息

说明「收款链接」中Reference number、金额、Created date、说明、Remarks的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款链接中能够说明「收款链接」中Reference number、金额、Created date、说明、Remarks的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Reference number | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| Created date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| Remarks | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Reference number：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- 金额：本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。
- Created date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 创建时默认一次性，商户可明确选择重复使用。一次性链接成功收款后停止收款；重复使用链接的每笔付款独立生成订单。未成功付款不直接标为已使用。
- 首版采用商户指定的固定金额，必须大于零，最多两位小数；允许设置未来到期时间。未设置时不自动到期；到期或停用后不可继续发起新付款。首版不提供客户自填金额。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款链接明细表

说明「收款链接」中Reference number、金额、Created date、说明、Remarks的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款链接中能够说明「收款链接」中Reference number、金额、Created date、说明、Remarks的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Reference number | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| Created date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| Remarks | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Reference number：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- 金额：本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。
- Created date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 创建时默认一次性，商户可明确选择重复使用。一次性链接成功收款后停止收款；重复使用链接的每笔付款独立生成订单。未成功付款不直接标为已使用。
- 首版采用商户指定的固定金额，必须大于零，最多两位小数；允许设置未来到期时间。未设置时不自动到期；到期或停用后不可继续发起新付款。首版不提供客户自填金额。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额（菲律宾比索）

通过一个固定金额链接向客户发起收款，并跟进付款结果。

背景与用途：通过一个固定金额链接向客户发起收款，并跟进付款结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额（菲律宾比索）（Amount (₱)） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 必填；未完成时在此字段提示。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 必填；未完成时在此字段提示。 |
| 备注（可选）（Remarks (Optional)） | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |
| 使用次数（Usage） | 一次性链接成功付款后不能继续收款；重复使用的每笔付款独立成单。 | Single payment：默认，一次性；Multiple payments：重复使用。 |
| 到期时间（Expires at） | 链接允许发起新付款的截止时间，使用 Asia/Manila。 | 可选，必须为未来时间；不填写表示不自动到期。 |

业务规则：

- 默认一次性，可选择重复使用；每笔付款独立成单。
- 金额大于零、最多两位小数；可设置未来到期时间，未设置不自动到期。
- 一次性成功付款或链接失效后不能继续发起新付款。

操作与交互结果：

- 填写金额和说明，核对使用次数与有效期后创建；复制链接提供给客户，按链接查询关联付款。

异常处理：

- 停用链接向客户显示无法付款；归档保留历史，不删除交易。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款链接

通过一个固定金额链接向客户发起收款，并跟进付款结果。

背景与用途：通过一个固定金额链接向客户发起收款，并跟进付款结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额（菲律宾比索）（Amount (₱)） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 必填；未完成时在此字段提示。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 必填；未完成时在此字段提示。 |
| 备注（可选）（Remarks (Optional)） | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |
| 使用次数（Usage） | 一次性链接成功付款后不能继续收款；重复使用的每笔付款独立成单。 | Single payment：默认，一次性；Multiple payments：重复使用。 |
| 到期时间（Expires at） | 链接允许发起新付款的截止时间，使用 Asia/Manila。 | 可选，必须为未来时间；不填写表示不自动到期。 |

业务规则：

- 默认一次性，可选择重复使用；每笔付款独立成单。
- 金额大于零、最多两位小数；可设置未来到期时间，未设置不自动到期。
- 一次性成功付款或链接失效后不能继续发起新付款。
- 创建时默认一次性，商户可明确选择重复使用。一次性链接成功收款后停止收款；重复使用链接的每笔付款独立生成订单。未成功付款不直接标为已使用。
- 首版采用商户指定的固定金额，必须大于零，最多两位小数；允许设置未来到期时间。未设置时不自动到期；到期或停用后不可继续发起新付款。首版不提供客户自填金额。

操作与交互结果：

- 填写金额和说明，核对使用次数与有效期后创建；复制链接提供给客户，按链接查询关联付款。

异常处理：

- 停用链接向客户显示无法付款；归档保留历史，不删除交易。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额（菲律宾比索）

在「收款链接」中，金额（菲律宾比索）用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在收款链接中能够在「收款链接」中，金额（菲律宾比索）用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额（菲律宾比索）（Amount (₱)） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 必填；未完成时在此字段提示。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 金额（菲律宾比索）：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：说明

在「收款链接」中，说明用于帮助识别该业务的文字内容，不代替订单状态或金额。

背景与用途：这一部分让使用者在收款链接中能够在「收款链接」中，说明用于帮助识别该业务的文字内容，不代替订单状态或金额，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 必填；未完成时在此字段提示。 |

业务规则：

- 说明：帮助识别该业务的文字内容，不代替订单状态或金额。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：备注（可选）

在「收款链接」中，备注（可选）用于解释本条业务的补充文字；内部备注与客户可见说明分别处理。

背景与用途：这一部分让使用者在收款链接中能够在「收款链接」中，备注（可选）用于解释本条业务的补充文字；内部备注与客户可见说明分别处理，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 备注（可选）（Remarks (Optional)） | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |

业务规则：

- 备注（可选）：解释本条业务的补充文字；内部备注与客户可见说明分别处理。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款链接 · 办理流程

通过一个固定金额链接向客户发起收款，并跟进付款结果。

背景与用途：通过一个固定金额链接向客户发起收款，并跟进付款结果。

业务规则：

- 默认一次性，可选择重复使用；每笔付款独立成单。
- 金额大于零、最多两位小数；可设置未来到期时间，未设置不自动到期。
- 一次性成功付款或链接失效后不能继续发起新付款。

操作与交互结果：

- 填写金额和说明，核对使用次数与有效期后创建；复制链接提供给客户，按链接查询关联付款。

异常处理：

- 停用链接向客户显示无法付款；归档保留历史，不删除交易。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-payment-methods"></a>
## 可用支付方式

### 要解决什么问题

让商户了解已经配置的收款方式及其可用情况。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 支付方式列表：名称和状态
- 业务能力说明：商户可使用的支付方式范围
- 可用支付方式 · 查询条件：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 已配置支付方式：让商户知道哪些收款或出款方式现在可以使用。
- 可用支付方式 · 业务内容：让商户了解已经配置的收款方式及其可用情况。 本区域展示Merchant method / provider boundary，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 查看配置和状态
- 按已有管理入口操作

### 业务规则与结果

- 商户可用支付方式与平台内部通道路由不同
- 不展示通道成本
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：可用支付方式 · 查询条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已配置支付方式

让商户知道哪些收款或出款方式现在可以使用。

背景与用途：让商户知道哪些收款或出款方式现在可以使用。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 支付方式（Method） | 客户选择或本笔业务实际使用的方式；不等同内部提供服务的通道。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Usage modes | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Fee display | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 能力状态与企业认证分别展示；未开通、可用、停用分别解释。
- 商户只能看到自己的适用方式和收费，平台内部通道成本不公开。

操作与交互结果：

- 查看方式和费用，从开通指引或对应工具入口继续；停用前说明影响。

异常处理：

- 未开通时不给出可成功操作的假入口；能力读取失败时停止依赖其授权的交易提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：可用支付方式明细表

说明「可用支付方式」中支付方式、状态、Usage modes、Fee display的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在可用支付方式中能够说明「可用支付方式」中支付方式、状态、Usage modes、Fee display的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 支付方式（Method） | 客户选择或本笔业务实际使用的方式；不等同内部提供服务的通道。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Usage modes | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| Fee display | 本项对应的收费或限制数值，按当前有效业务配置展示；缺失不解释为免费或无限制。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 支付方式：客户选择或本笔业务实际使用的方式；不等同内部提供服务的通道。
- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。
- Usage modes：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：可用支付方式 · 业务内容

让商户了解已经配置的收款方式及其可用情况。 本区域展示Merchant method / provider boundary，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在可用支付方式中能够让商户了解已经配置的收款方式及其可用情况。 本区域展示Merchant method / provider boundary，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 商户可用支付方式与平台内部通道路由不同

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-payment-page-editor"></a>
## 编辑支付页面

### 要解决什么问题

配置一个客户可访问的付款页面，并在保存前预览。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 基本内容：页面名称、标题和网址名称
- 商品或服务：说明客户购买的内容
- 金额设置：固定或其他已支持金额方式
- 展示设置：自定义字段、颜色、商户标识和头图
- 实时预览：检查客户看到的效果
- 记录不存在或不可访问：让商户准备客户能理解的商品说明、金额和联系信息。
- 客户付款页：让商户准备客户能理解的商品说明、金额和联系信息。
- 页面名称：在「编辑支付页面」中，页面名称用于商户内部管理收款页面的名称，与客户可见标题分开。
- 客户付款页标题：在「编辑支付页面」中，客户付款页标题用于付款客户看到的商品或收款标题。
- 付款页网址名称：在「编辑支付页面」中，付款页网址名称用于客户付款链接中的唯一名称；保存前检查格式与重复。
- 商品或服务说明：在「编辑支付页面」中，商品或服务说明用于业务产品：该记录或配置所属的收款、出款等业务范围。；Service Description：解释本条业务的补充文字；内部备注与客户可见说明分别处理。
- 金额方式：在「编辑支付页面」中，金额方式用于首版固定金额，客户不能自行修改应付本金。
- 金额（菲律宾比索）：在「编辑支付页面」中，金额（菲律宾比索）用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 自定义字段：在「编辑支付页面」中，自定义字段用于姓名、邮箱、手机号和单行备注，可分别设置是否必填。
- 头部颜色：在「编辑支付页面」中，头部颜色用于影响客户付款页的视觉呈现，不改变金额或业务规则。
- Merchant Logo / Header Image：在「编辑支付页面」中，Merchant Logo / Header Image用于商户标识：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。；头图：当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。
- 客户付款页预览：让商户准备客户能理解的商品说明、金额和联系信息。

### 用户如何完成业务

- 填写页面内容和金额
- 查看右侧预览
- 保存有效配置

### 业务规则与结果

- 必填字段和金额应校验
- 预览不表示已经发生付款
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 付款页支持停用与恢复；停用后旧网址显示当前无法付款。归档用于整理商户列表，历史交易保留；停用或归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

让商户准备客户能理解的商品说明、金额和联系信息。

背景与用途：让商户准备客户能理解的商品说明、金额和联系信息。

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。

操作与交互结果：

- 填写内容，核对客户预览后保存；未保存预览不发布新内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：客户付款页

让商户准备客户能理解的商品说明、金额和联系信息。

背景与用途：让商户准备客户能理解的商品说明、金额和联系信息。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 页面名称（Page Name） | 商户内部管理收款页面的名称，与客户可见标题分开。 | 必填；未完成时在此字段提示。 |
| 客户付款页标题（Checkout Page Title） | 付款客户看到的商品或收款标题。 | 必填；未完成时在此字段提示。 |
| 付款页网址名称（URL Slug） | 客户付款链接中的唯一名称；保存前检查格式与重复。 | 必填；未完成时在此字段提示。 |
| 商品或服务说明（Product / Service Description） | 业务产品：该记录或配置所属的收款、出款等业务范围。；Service Description：解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 必填；未完成时在此字段提示。 |
| 金额方式（Amount Type） | 首版固定金额，客户不能自行修改应付本金。 | 固定金额：由商户设定，客户不能自行更改。 |
| 金额（菲律宾比索）（Amount (₱)） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 自定义字段（Custom Fields） | 姓名、邮箱、手机号和单行备注，可分别设置是否必填。 | 可选；不适用时允许留空。 |
| 头部颜色（Header Color） | 影响客户付款页的视觉呈现，不改变金额或业务规则。 | 可选；不适用时允许留空。 |
| Merchant Logo / Header Image | 商户标识：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。；头图：当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 可选；不适用时允许留空。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 付款页支持停用与恢复；停用后旧网址显示当前无法付款。归档用于整理商户列表，历史交易保留；停用或归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。

操作与交互结果：

- 填写内容，核对客户预览后保存；未保存预览不发布新内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：页面名称

在「编辑支付页面」中，页面名称用于商户内部管理收款页面的名称，与客户可见标题分开。

背景与用途：在「编辑支付页面」中，页面名称用于商户内部管理收款页面的名称，与客户可见标题分开。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 页面名称（Page Name） | 商户内部管理收款页面的名称，与客户可见标题分开。 | 必填；未完成时在此字段提示。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：客户付款页标题

在「编辑支付页面」中，客户付款页标题用于付款客户看到的商品或收款标题。

背景与用途：在「编辑支付页面」中，客户付款页标题用于付款客户看到的商品或收款标题。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 客户付款页标题（Checkout Page Title） | 付款客户看到的商品或收款标题。 | 必填；未完成时在此字段提示。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 付款页支持停用与恢复；停用后旧网址显示当前无法付款。归档用于整理商户列表，历史交易保留；停用或归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款页网址名称

在「编辑支付页面」中，付款页网址名称用于客户付款链接中的唯一名称；保存前检查格式与重复。

背景与用途：在「编辑支付页面」中，付款页网址名称用于客户付款链接中的唯一名称；保存前检查格式与重复。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 付款页网址名称（URL Slug） | 客户付款链接中的唯一名称；保存前检查格式与重复。 | 必填；未完成时在此字段提示。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 付款页支持停用与恢复；停用后旧网址显示当前无法付款。归档用于整理商户列表，历史交易保留；停用或归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商品或服务说明

在「编辑支付页面」中，商品或服务说明用于业务产品：该记录或配置所属的收款、出款等业务范围。；Service Description：解释本条业务的补充文字；内部备注与客户可见说明分别处理。

背景与用途：这一部分让使用者在编辑支付页面中能够在「编辑支付页面」中，商品或服务说明用于业务产品：该记录或配置所属的收款、出款等业务范围。；Service Description：解释本条业务的补充文字；内部备注与客户可见说明分别处理，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 商品或服务说明（Product / Service Description） | 业务产品：该记录或配置所属的收款、出款等业务范围。；Service Description：解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 必填；未完成时在此字段提示。 |

业务规则：

- 商品或服务说明：业务产品：该记录或配置所属的收款、出款等业务范围。；Service Description：解释本条业务的补充文字；内部备注与客户可见说明分别处理。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额方式

在「编辑支付页面」中，金额方式用于首版固定金额，客户不能自行修改应付本金。

背景与用途：在「编辑支付页面」中，金额方式用于首版固定金额，客户不能自行修改应付本金。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额方式（Amount Type） | 首版固定金额，客户不能自行修改应付本金。 | 固定金额：由商户设定，客户不能自行更改。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额（菲律宾比索）

在「编辑支付页面」中，金额（菲律宾比索）用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：这一部分让使用者在编辑支付页面中能够在「编辑支付页面」中，金额（菲律宾比索）用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额（菲律宾比索）（Amount (₱)） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 金额（菲律宾比索）：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：自定义字段

在「编辑支付页面」中，自定义字段用于姓名、邮箱、手机号和单行备注，可分别设置是否必填。

背景与用途：在「编辑支付页面」中，自定义字段用于姓名、邮箱、手机号和单行备注，可分别设置是否必填。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 自定义字段（Custom Fields） | 姓名、邮箱、手机号和单行备注，可分别设置是否必填。 | 可选；不适用时允许留空。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：头部颜色

在「编辑支付页面」中，头部颜色用于影响客户付款页的视觉呈现，不改变金额或业务规则。

背景与用途：在「编辑支付页面」中，头部颜色用于影响客户付款页的视觉呈现，不改变金额或业务规则。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 头部颜色（Header Color） | 影响客户付款页的视觉呈现，不改变金额或业务规则。 | 可选；不适用时允许留空。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Merchant Logo / Header Image

在「编辑支付页面」中，Merchant Logo / Header Image用于商户标识：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。；头图：当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。

背景与用途：在「编辑支付页面」中，Merchant Logo / Header Image用于商户标识：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。；头图：当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Merchant Logo / Header Image | 商户标识：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。；头图：当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 可选；不适用时允许留空。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：客户付款页预览

让商户准备客户能理解的商品说明、金额和联系信息。

背景与用途：让商户准备客户能理解的商品说明、金额和联系信息。

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 付款页支持停用与恢复；停用后旧网址显示当前无法付款。归档用于整理商户列表，历史交易保留；停用或归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。

操作与交互结果：

- 填写内容，核对客户预览后保存；未保存预览不发布新内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-payment-pages"></a>
## 支付页面列表

### 要解决什么问题

查找和管理商户创建的支付页面，进入创建或编辑。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 支付页面列表：名称、状态及入口
- 管理操作：创建和编辑对应页面
- Page Name & Type：让商户准备客户能理解的商品说明、金额和联系信息。
- 支付页面列表 · 业务信息：说明「支付页面列表」中Page Name & Type、公开付款网址、状态、Actions的用途，便于填写、查找或核对当前记录。

### 用户如何完成业务

- 创建新页面
- 打开已有页面进行编辑或查看

### 业务规则与结果

- 页面名称、可访问地址及可用状态应能区分
- 不混淆页面与该页面产生的付款订单
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 付款页支持停用与恢复；停用后旧网址显示当前无法付款。归档用于整理商户列表，历史交易保留；停用或归档不删除历史订单。
- 首版提供页面名称、客户可见标题、商品说明、图片、固定金额和必要的联系字段；支付方式仅能选择商户已开通的方式。自定义信息限姓名、邮箱、手机号和单行备注，可分别设置必填；不收集密码、验证码和支付卡敏感信息。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：Page Name & Type

让商户准备客户能理解的商品说明、金额和联系信息。

背景与用途：让商户准备客户能理解的商品说明、金额和联系信息。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Page Name & Type | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 公开付款网址（Public URL） | 提供给客户访问的地址，停用后显示明确不可付款提示。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Actions | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。

操作与交互结果：

- 填写内容，核对客户预览后保存；未保存预览不发布新内容。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：支付页面列表 · 业务信息

说明「支付页面列表」中Page Name & Type、公开付款网址、状态、Actions的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在支付页面列表中能够说明「支付页面列表」中Page Name & Type、公开付款网址、状态、Actions的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Page Name & Type | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 公开付款网址（Public URL） | 提供给客户访问的地址，停用后显示明确不可付款提示。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Actions | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Page Name & Type：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。
- 公开付款网址：提供给客户访问的地址，停用后显示明确不可付款提示。
- 状态：当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：支付页面列表明细表

让商户准备客户能理解的商品说明、金额和联系信息。

背景与用途：让商户准备客户能理解的商品说明、金额和联系信息。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Page Name & Type | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 公开付款网址（Public URL） | 提供给客户访问的地址，停用后显示明确不可付款提示。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Actions | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 首版固定金额；名称用于商户管理，标题和商品说明向客户展示。
- 联系字段限姓名、邮箱、手机号和单行备注，必填性可单独配置；支付方式限已开通方式。
- 停用与恢复改变能否付款，归档不删除历史订单。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 网址名称冲突、金额不合法或必填内容缺失时提示对应字段；不收集密码、验证码等敏感内容。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-payments"></a>
## 收款订单列表

### 要解决什么问题

查找客户付款记录，确认是否收到款项并跟进异常。

### 为什么这样设计

客户是否付款、是否结算以及是否通知商户系统是不同事实；分开解释可以减少对账争议和重复处理。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 搜索与筛选：查找指定付款
- 状态分类：按付款结果查看
- 订单列表：金额、付款方式、状态及时间
- 搜索与筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 收款订单列表：说明「收款订单列表」中收款订单号、Source / Acceptance、金额、状态、时间的用途，便于填写、查找或核对当前记录。
- 付款状态分类：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

### 用户如何完成业务

- 输入查询条件或切换状态
- 点击订单查看付款与结算详情
- 按页面入口导出

### 业务规则与结果

- 付款状态和结算状态分开
- 处理中或失败订单不能计入成功收款
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Search payments | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款订单列表

说明「收款订单列表」中收款订单号、Source / Acceptance、金额、状态、时间的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款订单列表中能够说明「收款订单列表」中收款订单号、Source / Acceptance、金额、状态、时间的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收款订单号（Payment ID） | iPay 的付款记录编号，用于查找这笔客户付款。 | 只读展示；无值时显示无记录或不适用。 |
| Source / Acceptance | 来源：这条记录由哪个业务入口产生；来源不代表当前处理结果。；Acceptance：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 结算状态（Settlement Status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 只读展示；无值时显示无记录或不适用。 |
| 备注（Remark） | 供业务人员补充的信息；内部备注不自动显示给付款客户。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 收款订单号：iPay 的付款记录编号，用于查找这笔客户付款。
- Source / Acceptance：来源：这条记录由哪个业务入口产生；来源不代表当前处理结果。；Acceptance：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 金额：本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款订单号明细表

说明「收款订单列表」中收款订单号、Source / Acceptance、金额、状态、时间的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款订单列表中能够说明「收款订单列表」中收款订单号、Source / Acceptance、金额、状态、时间的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收款订单号（Payment ID） | iPay 的付款记录编号，用于查找这笔客户付款。 | 只读展示；无值时显示无记录或不适用。 |
| Source / Acceptance | 来源：这条记录由哪个业务入口产生；来源不代表当前处理结果。；Acceptance：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 结算状态（Settlement Status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 只读展示；无值时显示无记录或不适用。 |
| 备注（Remark） | 供业务人员补充的信息；内部备注不自动显示给付款客户。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 收款订单号：iPay 的付款记录编号，用于查找这笔客户付款。
- Source / Acceptance：来源：这条记录由哪个业务入口产生；来源不代表当前处理结果。；Acceptance：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- 金额：本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：筛选条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Date type | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选值：Created at；Paid at；Settled at。 |
| Start date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| 付款状态（Payment status） | 客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。 | 只读展示；无值时显示无记录或不适用。 |
| 收款入口（Entry point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 只读展示；无值时显示无记录或不适用。 |
| 受理方式（Acceptance mode） | 客户以何种产品入口完成付款，例如接口、收款链接或门店码。 | 只读展示；无值时显示无记录或不适用。 |
| Payment method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 只读展示；无值时显示无记录或不适用。 |
| 结算状态（Settlement status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 只读展示；无值时显示无记录或不适用。 |
| Callback status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 可选值：Any callback status；Delivered；重试中：正在重新发送结果通知；失败：本次业务未成功，查看原因。 |
| 金额范围（Amount range） | 按最低和最高金额筛选；下限不能大于上限。 | 只读展示；无值时显示无记录或不适用。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Date type | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选值：Created at；Paid at；Settled at。 |
| Start date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| 付款状态（Payment status） | 客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。 | 只读展示；无值时显示无记录或不适用。 |
| 收款入口（Entry point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 只读展示；无值时显示无记录或不适用。 |
| 受理方式（Acceptance mode） | 客户以何种产品入口完成付款，例如接口、收款链接或门店码。 | 只读展示；无值时显示无记录或不适用。 |
| Payment method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 只读展示；无值时显示无记录或不适用。 |
| 结算状态（Settlement status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 只读展示；无值时显示无记录或不适用。 |
| Callback status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 可选值：Any callback status；Delivered；重试中：正在重新发送结果通知；失败：本次业务未成功，查看原因。 |
| 金额范围（Amount range） | 按最低和最高金额筛选；下限不能大于上限。 | 只读展示；无值时显示无记录或不适用。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期

说明「收款订单列表」中日期、Date type、Start date、End date的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款订单列表中能够说明「收款订单列表」中日期、Date type、Start date、End date的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Date type | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选值：Created at；Paid at；Settled at。 |
| Start date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。
- Date type：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- Start date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款状态

在「收款订单列表」中，付款状态用于客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。

背景与用途：这一部分让使用者在收款订单列表中能够在「收款订单列表」中，付款状态用于客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 付款状态（Payment status） | 客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 付款状态：客户付款的结果；待处理、成功和失败分别显示，退款另保留退款事实。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款入口

在「收款订单列表」中，收款入口用于产生该笔付款的工具或入口，用于追溯业务来源。

背景与用途：这一部分让使用者在收款订单列表中能够在「收款订单列表」中，收款入口用于产生该笔付款的工具或入口，用于追溯业务来源，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收款入口（Entry point） | 产生该笔付款的工具或入口，用于追溯业务来源。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 收款入口：产生该笔付款的工具或入口，用于追溯业务来源。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：受理方式

在「收款订单列表」中，受理方式用于客户以何种产品入口完成付款，例如接口、收款链接或门店码。

背景与用途：这一部分让使用者在收款订单列表中能够在「收款订单列表」中，受理方式用于客户以何种产品入口完成付款，例如接口、收款链接或门店码，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 受理方式（Acceptance mode） | 客户以何种产品入口完成付款，例如接口、收款链接或门店码。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 受理方式：客户以何种产品入口完成付款，例如接口、收款链接或门店码。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Payment method

在「收款订单列表」中，Payment method用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：在「收款订单列表」中，Payment method用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Payment method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 仅显示适用方式，停用方式不可选；未选择前不显示确定的最终手续费。
- 金额或方式改变后重新展示报价，总额清楚标明本金及费用。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 无可用方式时解释原因并保留返回；报价失效后须刷新并再次确认。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：所属门店

在「收款订单列表」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属。

背景与用途：这一部分让使用者在收款订单列表中能够在「收款订单列表」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 所属门店：本次收款所属营业场所；无门店时不能虚构归属。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算状态

在「收款订单列表」中，结算状态用于成功付款对应资金的结算进度；未结算不等于未付款。

背景与用途：这一部分让使用者在收款订单列表中能够在「收款订单列表」中，结算状态用于成功付款对应资金的结算进度；未结算不等于未付款，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 结算状态（Settlement status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 结算状态：成功付款对应资金的结算进度；未结算不等于未付款。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 待结算（Pending）：成功收款对应资金尚未释放。
- 结算中（Processing）：正在办理结算，尚未完成。
- 已结算（Settled）：本笔结算已完成，可核对实际钱包变化。
- 失败（Failed）：本次结算未成功，需要继续处理。
- 暂缓（On Hold）：结算被暂时保留，显示可公开的处理原因。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务状态

在「收款订单列表」中，Callback status用于当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。

背景与用途：在「收款订单列表」中，Callback status用于当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Callback status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 可选值：Any callback status；Delivered；重试中：正在重新发送结果通知；失败：本次业务未成功，查看原因。 |

业务规则：

- 通知状态与付款、出款及结算状态分别展示；通知失败不代表资金失败。
- 未发送、发送中、成功、失败和继续重试分别说明当前进展；展示最近尝试时间及可公开的失败原因。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 地址异常提示检查接入配置；不能通过重发通知修改交易结果或重复扣款。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额范围

说明「收款订单列表」中金额范围、最低金额、最高金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款订单列表中能够说明「收款订单列表」中金额范围、最低金额、最高金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 金额范围（Amount range） | 按最低和最高金额筛选；下限不能大于上限。 | 只读展示；无值时显示无记录或不适用。 |
| 最低金额（Minimum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |
| 最高金额（Maximum amount） | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 金额最多两位小数，业务金额必须大于零；筛选下限不能大于上限。 |

业务规则：

- 金额范围：按最低和最高金额筛选；下限不能大于上限。
- 最低金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 最高金额：本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 只读展示；无值时显示无记录或不适用。 |
| 筛选条件（Filters） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 只读展示；无值时显示无记录或不适用。 |
| 收款订单（Payments） | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 文件格式（File format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| CSV | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Excel | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件格式

说明「收款订单列表」中文件格式、CSV、Excel的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在收款订单列表中能够说明「收款订单列表」中文件格式、CSV、Excel的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件格式（File format） | 首版 CSV；其他格式不作为已交付能力显示。 | CSV：首版唯一导出格式。 |
| CSV | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Excel | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- 文件格式：首版 CSV；其他格式不作为已交付能力显示。
- CSV：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- Excel：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：付款状态分类

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

状态含义：

- 待处理（Pending）：订单已建立，尚未获得最终付款结果。
- 处理中（Processing）：付款正在处理，请继续查询原订单。
- 已付款（Paid／Succeeded）：客户付款成功，结算与通知结果分别显示。
- 失败（Failed）：付款未成功，显示可公开原因。
- 关闭／取消（Closed／Cancelled）：付款订单已结束，不继续发起新付款；保留原记录。
- 已退款（Refunded）：展示已发生的退款事实及金额，保留原成功付款记录。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-privacy"></a>
## 隐私政策

### 要解决什么问题

向使用者说明个人与企业信息如何被收集和使用。

### 为什么这样设计

使用者需要在作出同意前了解服务约定及信息用途，政策版本和维护责任也必须清楚。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 隐私政策正文：信息处理及联系说明
- 隐私政策 · 业务内容：向使用者说明个人与企业信息如何被收集和使用。 本区域展示Privacy Policy，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 阅读政策内容并返回原流程

### 业务规则与结果

- 政策展示不代表使用者已同意
- 是否需要同意由发起流程明确
- 展示正式批准的条款、隐私政策和版本日期，由业务维护发布版本。注册同意记录对应当时版本；缺少正式版本时禁止正式注册提交，不用演示正文替代。

### 特殊情况

- 内容无法打开时提示返回或重试；不能用其他页面的内容代替当前说明。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：隐私政策 · 业务内容

向使用者说明个人与企业信息如何被收集和使用。 本区域展示Privacy Policy，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在隐私政策中能够向使用者说明个人与企业信息如何被收集和使用。 本区域展示Privacy Policy，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 政策展示不代表使用者已同意

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-qr-create"></a>
## 创建门店收款码

### 要解决什么问题

为指定门店或柜台建立可识别的收款码。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 所属门店：二维码归属
- 位置标签：区分柜台或收款点
- 短信号码与内部备注：可选通知和管理信息
- 海报预览：核对展示内容
- 门店收款码：让客户扫描指定门店的有效二维码完成付款。
- 所属门店：在「创建门店收款码」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属。
- Counter / location label (Optional)：在「创建门店收款码」中，Counter / location label (Optional)用于Counter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；location label (Optional)：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。
- Mobile number for SMS notifications (Optional)：在「创建门店收款码」中，Mobile number for SMS notifications (Optional)用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。
- Internal Note (Optional)：在「创建门店收款码」中，Internal Note (Optional)用于解释本条业务的补充文字；内部备注与客户可见说明分别处理。
- 收款码海报预览：让客户扫描指定门店的有效二维码完成付款。

### 用户如何完成业务

- 选择门店并补充需要的信息
- 核对预览后创建

### 业务规则与结果

- 可选字段不能误标为必填
- 二维码归属必须明确
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：门店收款码

让客户扫描指定门店的有效二维码完成付款。

背景与用途：让客户扫描指定门店的有效二维码完成付款。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 必填；未完成时在此字段提示。 |
| Counter / location label (Optional) | Counter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；location label (Optional)：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Mobile number for SMS notifications (Optional) | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Internal Note (Optional) | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |
| I consent to the collection and processing of the information entered above for this QR tool. | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 必填；未完成时在此字段提示。 |

业务规则：

- 显示商户、门店、收款位置和二维码状态；二维码必须属于当前有效门店。
- 已停用、失效或无门店时不可作为有效收款码展示。
- 首版支持下载和打印素材，不包含实体立牌配送。
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

操作与交互结果：

- 创建时选择门店、核对展示信息；查看时可保存素材，使用前检查状态。

异常处理：

- 无权限保存或素材下载失败时说明原因并支持重试；扫码失效给客户明确不可付款提示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：所属门店

在「创建门店收款码」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属。

背景与用途：这一部分让使用者在创建门店收款码中能够在「创建门店收款码」中，所属门店用于本次收款所属营业场所；无门店时不能虚构归属，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 所属门店（Store） | 本次收款所属营业场所；无门店时不能虚构归属。 | 必填；未完成时在此字段提示。 |

业务规则：

- 所属门店：本次收款所属营业场所；无门店时不能虚构归属。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Counter / location label (Optional)

在「创建门店收款码」中，Counter / location label (Optional)用于Counter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；location label (Optional)：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在创建门店收款码中能够在「创建门店收款码」中，Counter / location label (Optional)用于Counter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；location label (Optional)：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Counter / location label (Optional) | Counter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；location label (Optional)：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- Counter / location label (Optional)：Counter：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。；location label (Optional)：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Mobile number for SMS notifications (Optional)

在「创建门店收款码」中，Mobile number for SMS notifications (Optional)用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：在「创建门店收款码」中，Mobile number for SMS notifications (Optional)用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Mobile number for SMS notifications (Optional) | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- 展示消息标题、摘要、发生时间、已读状态和关联业务。
- 只发送有完整查看路径的通知，不把发送成功当作业务成功。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 对象不可访问时说明原因并能返回，不能跳到别的订单。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Internal Note (Optional)

在「创建门店收款码」中，Internal Note (Optional)用于解释本条业务的补充文字；内部备注与客户可见说明分别处理。

背景与用途：这一部分让使用者在创建门店收款码中能够在「创建门店收款码」中，Internal Note (Optional)用于解释本条业务的补充文字；内部备注与客户可见说明分别处理，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Internal Note (Optional) | 解释本条业务的补充文字；内部备注与客户可见说明分别处理。 | 可选；不适用时允许留空。 |

业务规则：

- Internal Note (Optional)：解释本条业务的补充文字；内部备注与客户可见说明分别处理。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款码海报预览

让客户扫描指定门店的有效二维码完成付款。

背景与用途：让客户扫描指定门店的有效二维码完成付款。

业务规则：

- 显示商户、门店、收款位置和二维码状态；二维码必须属于当前有效门店。
- 已停用、失效或无门店时不可作为有效收款码展示。
- 首版支持下载和打印素材，不包含实体立牌配送。
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

操作与交互结果：

- 创建时选择门店、核对展示信息；查看时可保存素材，使用前检查状态。

异常处理：

- 无权限保存或素材下载失败时说明原因并支持重试；扫码失效给客户明确不可付款提示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-qr-details"></a>
## 门店收款码详情

### 要解决什么问题

查看某个收款码的归属、状态和展示海报。

### 为什么这样设计

商户需要按线上或门店场景选择收款工具，并清楚每个链接、页面或二维码能否使用、属于哪里。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 二维码信息：门店、位置和状态
- 海报预览：客户扫码时使用的内容
- 门店收款码详情 · 业务内容：让客户扫描指定门店的有效二维码完成付款。
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 门店收款码：让客户扫描指定门店的有效二维码完成付款。
- 收款码海报预览：让客户扫描指定门店的有效二维码完成付款。

### 用户如何完成业务

- 核对门店归属
- 使用页面提供的海报和状态管理入口

### 业务规则与结果

- 不可用二维码需明确提示，不能继续当作有效收款凭据
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：门店收款码详情 · 业务内容

让客户扫描指定门店的有效二维码完成付款。

背景与用途：让客户扫描指定门店的有效二维码完成付款。

业务规则：

- 显示商户、门店、收款位置和二维码状态；二维码必须属于当前有效门店。
- 已停用、失效或无门店时不可作为有效收款码展示。
- 首版支持下载和打印素材，不包含实体立牌配送。

操作与交互结果：

- 创建时选择门店、核对展示信息；查看时可保存素材，使用前检查状态。

异常处理：

- 无权限保存或素材下载失败时说明原因并支持重试；扫码失效给客户明确不可付款提示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：门店收款码

让客户扫描指定门店的有效二维码完成付款。

背景与用途：让客户扫描指定门店的有效二维码完成付款。

业务规则：

- 显示商户、门店、收款位置和二维码状态；二维码必须属于当前有效门店。
- 已停用、失效或无门店时不可作为有效收款码展示。
- 首版支持下载和打印素材，不包含实体立牌配送。
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

操作与交互结果：

- 创建时选择门店、核对展示信息；查看时可保存素材，使用前检查状态。

异常处理：

- 无权限保存或素材下载失败时说明原因并支持重试；扫码失效给客户明确不可付款提示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款码海报预览

让客户扫描指定门店的有效二维码完成付款。

背景与用途：让客户扫描指定门店的有效二维码完成付款。

业务规则：

- 显示商户、门店、收款位置和二维码状态；二维码必须属于当前有效门店。
- 已停用、失效或无门店时不可作为有效收款码展示。
- 首版支持下载和打印素材，不包含实体立牌配送。
- 停用码显示不可收款原因。短信为单独开通的服务，只发送成功收款通知；未开通时不展示可发送的承诺。手机号默认脱敏，完整信息仅授权人员可见。短信送达与交易成功分别表示。
- 首版提供二维码素材下载和打印，不包含实体立牌申请、收费、配送、补发及售后。

操作与交互结果：

- 创建时选择门店、核对展示信息；查看时可保存素材，使用前检查状态。

异常处理：

- 无权限保存或素材下载失败时说明原因并支持重试；扫码失效给客户明确不可付款提示。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-register"></a>
## 商户注册

### 要解决什么问题

建立商户所有者账号，验证邮箱后进入企业认证流程。

### 为什么这样设计

先确认账号归属再开放业务，避免他人看到商户资料或操作资金；验证失败时仍应让本人知道如何恢复使用。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 账户信息：姓名、登录邮箱、业务邮箱和密码
- 可选经营资料：门店和联系信息
- 邮箱验证：确认业务邮箱
- 注册结果：引导企业认证
- 资料填写：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 商户注册 · 业务内容：建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示auth-step，用于确认当前业务内容及下一步。
- 商户注册 · 信息区域：建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示商户注册 · 信息区域，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 填写账户资料
- 可补充或跳过可选经营信息
- 完成邮箱验证后继续认证

### 业务规则与结果

- 可选经营字段不应阻止注册
- 账号建立不等于企业认证通过
- 展示正式批准的条款、隐私政策和版本日期，由业务维护发布版本。注册同意记录对应当时版本；缺少正式版本时禁止正式注册提交，不用演示正文替代。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：资料填写

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 企业名称（Business name） | 注册和管理商户的名称，不替代门店名称。 | 可选；不适用时允许留空。 |
| Owner full name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| 登录邮箱（Email） | 登录使用的账号标识，输入后用于确认账号归属。 | 可选；不适用时允许留空。 |
| Business email address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| 经营名称（Store / trading name） | 对外经营使用的名称，与认证企业法定名称区分。 | 可选；不适用时允许留空。 |
| Business contact number | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Main business | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Select if applicable；Catering；Service；Supermarket；Other。 |
| Store short name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| 经营行业（Business industry） | 描述商户经营类别，使用适用行业列表选择。 | 可选；不适用时允许留空。 |
| 营业时间（Opening hours） | 商户对外营业的时间信息，不等于平台资金服务时效。 | 可选；不适用时允许留空。 |
| Website / social links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Detailed operating address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 可选；不适用时允许留空。 |
| 省或地区（Province） | 地址所属行政区域，与城市和街区保持一致。 | 可选；不适用时允许留空。 |
| 城市（City / municipality） | 地址所在城市或市镇，与选定省份匹配。 | 可选；不适用时允许留空。 |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 可选；不适用时允许留空。 |
| 邮政编码（Postal code） | 对应地址的邮政编码，按当地有效格式填写。 | 可选；不适用时允许留空。 |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |
| 经纬度（Longitude / latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 可选；不适用时允许留空。 |
| 密码（Password） | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |
| Confirm password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |
| I agree to the Terms of Service and Privacy Policy . | 本项明确要求的确认或必填条件；未满足时指出原因，不能代用户勾选同意。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：企业名称

在「商户注册」中，企业名称用于注册和管理商户的名称，不替代门店名称。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，企业名称用于注册和管理商户的名称，不替代门店名称，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 企业名称（Business name） | 注册和管理商户的名称，不替代门店名称。 | 可选；不适用时允许留空。 |

业务规则：

- 企业名称：注册和管理商户的名称，不替代门店名称。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Owner full name

在「商户注册」中，Owner full name用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，Owner full name用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Owner full name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |

业务规则：

- Owner full name：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录邮箱

在「商户注册」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

背景与用途：在「商户注册」中，登录邮箱用于登录使用的账号标识，输入后用于确认账号归属。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 登录邮箱（Email） | 登录使用的账号标识，输入后用于确认账号归属。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Business email address

在「商户注册」中，Business email address用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，Business email address用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Business email address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- Business email address：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：资料填写

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营名称（Store / trading name） | 对外经营使用的名称，与认证企业法定名称区分。 | 可选；不适用时允许留空。 |
| Business contact number | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |
| Main business | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Select if applicable；Catering；Service；Supermarket；Other。 |
| Store short name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |
| 经营行业（Business industry） | 描述商户经营类别，使用适用行业列表选择。 | 可选；不适用时允许留空。 |
| 营业时间（Opening hours） | 商户对外营业的时间信息，不等于平台资金服务时效。 | 可选；不适用时允许留空。 |
| Website / social links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Detailed operating address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 可选；不适用时允许留空。 |
| 省或地区（Province） | 地址所属行政区域，与城市和街区保持一致。 | 可选；不适用时允许留空。 |
| 城市（City / municipality） | 地址所在城市或市镇，与选定省份匹配。 | 可选；不适用时允许留空。 |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 可选；不适用时允许留空。 |
| 邮政编码（Postal code） | 对应地址的邮政编码，按当地有效格式填写。 | 可选；不适用时允许留空。 |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |
| 经纬度（Longitude / latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 可选；不适用时允许留空。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营名称

在「商户注册」中，经营名称用于对外经营使用的名称，与认证企业法定名称区分。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，经营名称用于对外经营使用的名称，与认证企业法定名称区分，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营名称（Store / trading name） | 对外经营使用的名称，与认证企业法定名称区分。 | 可选；不适用时允许留空。 |

业务规则：

- 经营名称：对外经营使用的名称，与认证企业法定名称区分。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Business contact number

在「商户注册」中，Business contact number用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，Business contact number用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Business contact number | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 可选；不适用时允许留空。 |

业务规则：

- Business contact number：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Main business

在「商户注册」中，Main business用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，Main business用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Main business | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选值：Select if applicable；Catering；Service；Supermarket；Other。 |

业务规则：

- Main business：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Store short name

在「商户注册」中，Store short name用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，Store short name用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Store short name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选；不适用时允许留空。 |

业务规则：

- Store short name：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经营行业

在「商户注册」中，经营行业用于描述商户经营类别，使用适用行业列表选择。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，经营行业用于描述商户经营类别，使用适用行业列表选择，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经营行业（Business industry） | 描述商户经营类别，使用适用行业列表选择。 | 可选；不适用时允许留空。 |

业务规则：

- 经营行业：描述商户经营类别，使用适用行业列表选择。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：营业时间

在「商户注册」中，营业时间用于商户对外营业的时间信息，不等于平台资金服务时效。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，营业时间用于商户对外营业的时间信息，不等于平台资金服务时效，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 营业时间（Opening hours） | 商户对外营业的时间信息，不等于平台资金服务时效。 | 可选；不适用时允许留空。 |

业务规则：

- 营业时间：商户对外营业的时间信息，不等于平台资金服务时效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Website / social links

在「商户注册」中，Website / social links用于Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，Website / social links用于Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Website / social links | Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- Website / social links：Website：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。；social links：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Detailed operating address

在「商户注册」中，Detailed operating address用于当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。

背景与用途：在「商户注册」中，Detailed operating address用于当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Detailed operating address | 当前对象地址的对应部分，经营地址与认证地址分开，相关行政区域保持一致。 | 可选；不适用时允许留空。 |

业务规则：

- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：省或地区

在「商户注册」中，省或地区用于地址所属行政区域，与城市和街区保持一致。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，省或地区用于地址所属行政区域，与城市和街区保持一致，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 省或地区（Province） | 地址所属行政区域，与城市和街区保持一致。 | 可选；不适用时允许留空。 |

业务规则：

- 省或地区：地址所属行政区域，与城市和街区保持一致。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：城市

在「商户注册」中，城市用于地址所在城市或市镇，与选定省份匹配。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，城市用于地址所在城市或市镇，与选定省份匹配，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 城市（City / municipality） | 地址所在城市或市镇，与选定省份匹配。 | 可选；不适用时允许留空。 |

业务规则：

- 城市：地址所在城市或市镇，与选定省份匹配。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：街区

在「商户注册」中，街区用于菲律宾地址中的街区信息，与城市保持一致。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，街区用于菲律宾地址中的街区信息，与城市保持一致，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 街区（Barangay） | 菲律宾地址中的街区信息，与城市保持一致。 | 可选；不适用时允许留空。 |

业务规则：

- 街区：菲律宾地址中的街区信息，与城市保持一致。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：邮政编码

在「商户注册」中，邮政编码用于对应地址的邮政编码，按当地有效格式填写。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，邮政编码用于对应地址的邮政编码，按当地有效格式填写，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 邮政编码（Postal code） | 对应地址的邮政编码，按当地有效格式填写。 | 可选；不适用时允许留空。 |

业务规则：

- 邮政编码：对应地址的邮政编码，按当地有效格式填写。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：国家

在「商户注册」中，国家用于当前地址或主体所属国家，用于解释地址格式及适用范围。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，国家用于当前地址或主体所属国家，用于解释地址格式及适用范围，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 国家（Country） | 当前地址或主体所属国家，用于解释地址格式及适用范围。 | 可选；不适用时允许留空。 |

业务规则：

- 国家：当前地址或主体所属国家，用于解释地址格式及适用范围。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：经纬度

在「商户注册」中，经纬度用于经营位置的经度和纬度，分别校验合法数值范围。

背景与用途：这一部分让使用者在商户注册中能够在「商户注册」中，经纬度用于经营位置的经度和纬度，分别校验合法数值范围，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 经纬度（Longitude / latitude） | 经营位置的经度和纬度，分别校验合法数值范围。 | 可选；不适用时允许留空。 |

业务规则：

- 经纬度：经营位置的经度和纬度，分别校验合法数值范围。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：密码

在「商户注册」中，密码用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「商户注册」中，密码用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 密码（Password） | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Confirm password

在「商户注册」中，Confirm password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「商户注册」中，Confirm password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Confirm password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 业务内容

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示register agreement，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示register agreement，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 办理流程

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示register submit，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示register submit，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 业务内容

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示auth-step，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示auth-step，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 办理流程

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示register change email，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示register change email，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 填写与确认

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 信息区域

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示商户注册 · 信息区域，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示商户注册 · 信息区域，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 业务内容

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示auth-step，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示auth-step，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 业务信息

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示商户注册 · 业务信息，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示商户注册 · 业务信息，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户注册 · 办理入口

建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示Existing user login，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在商户注册中能够建立商户所有者账号，验证邮箱后进入企业认证流程。 本区域展示Existing user login，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可选经营字段不应阻止注册

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-security"></a>
## 账号安全

### 要解决什么问题

管理登录密码和两步验证，并检查近期登录活动。

### 为什么这样设计

商户需要知道谁能访问自己的业务、资料是否准确以及谁做过修改；日常资料和认证资料分清，才能避免误改。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 密码：更改登录凭据
- 两步验证：额外身份保护
- 登录活动：时间和设备等记录
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 密码：让用户建立或验证账号归属，并保护登录和资金操作。
- 两步验证：证明当前操作由账号本人发起，避免验证码被用于错误用途。
- 登录活动：说明「账号安全」中日期、登录设备、网络地址、登录位置的用途，便于填写、查找或核对当前记录。
- 账号安全 · 业务内容：准确说明当前是否已取得结果，以及用户下一步能做什么。

### 用户如何完成业务

- 按入口修改密码或设置验证方式
- 查看异常登录记录

### 业务规则与结果

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 敏感操作需要重新验证身份
- 未成功验证的新方式不能视为已启用
- 主动改密完成身份验证后保留当前设备登录，其他设备退出；忘记密码重置后全部旧登录失效，需要重新登录。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：密码

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 密码（Password） | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 只读展示；无值时显示无记录或不适用。 |
| Last Updated | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。
- 主动改密完成身份验证后保留当前设备登录，其他设备退出；忘记密码重置后全部旧登录失效，需要重新登录。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：两步验证

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Verified Email | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 只读展示；无值时显示无记录或不适用。 |
| Email Status | 当前对象的处理阶段或结论；审批、执行、付款、结算与通知分别展示，不能互相替代。 | 只读展示；无值时显示无记录或不适用。 |
| Google Authenticator | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 绑定时间（Bound At） | 该验证器或安全方式完成绑定的时间。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录活动

说明「账号安全」中日期、登录设备、网络地址、登录位置的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在账号安全中能够说明「账号安全」中日期、登录设备、网络地址、登录位置的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| 登录设备（Device） | 该次登录使用的设备或客户端，用于本人核对是否认识。 | 只读展示；无值时显示无记录或不适用。 |
| 网络地址（IP） | 登录或操作的来源地址，用于安全追溯，不直接作为人员身份。 | 只读展示；无值时显示无记录或不适用。 |
| 登录位置（Location） | 用于帮助用户核对登录来源的位置信息，不能当作精确实时定位。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。
- 登录设备：该次登录使用的设备或客户端，用于本人核对是否认识。
- 网络地址：登录或操作的来源地址，用于安全追溯，不直接作为人员身份。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号安全明细表

说明「账号安全」中日期、登录设备、网络地址、登录位置的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在账号安全中能够说明「账号安全」中日期、登录设备、网络地址、登录位置的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| 登录设备（Device） | 该次登录使用的设备或客户端，用于本人核对是否认识。 | 只读展示；无值时显示无记录或不适用。 |
| 网络地址（IP） | 登录或操作的来源地址，用于安全追溯，不直接作为人员身份。 | 只读展示；无值时显示无记录或不适用。 |
| 登录位置（Location） | 用于帮助用户核对登录来源的位置信息，不能当作精确实时定位。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。
- 登录设备：该次登录使用的设备或客户端，用于本人核对是否认识。
- 网络地址：登录或操作的来源地址，用于安全追溯，不直接作为人员身份。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号安全 · 业务内容

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Current Password

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Current Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| New Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| Confirm New Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| Verification Method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Email OTP；Google Authenticator。 |
| Verification Code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号凭据

让用户建立或验证账号归属，并保护登录和资金操作。

背景与用途：让用户建立或验证账号归属，并保护登录和资金操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Current Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| New Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| Confirm New Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| Verification Method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Email OTP；Google Authenticator。 |
| Verification Code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写凭据并提交验证，错误时指出可修正项；显示密码按钮只改变可见性，不提交表单。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Current Password

在「账号安全」中，Current Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「账号安全」中，Current Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Current Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：New Password

在「账号安全」中，New Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「账号安全」中，New Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| New Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Confirm New Password

在「账号安全」中，Confirm New Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「账号安全」中，Confirm New Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Confirm New Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Verification Method

在「账号安全」中，Verification Method用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：这一部分让使用者在账号安全中能够在「账号安全」中，Verification Method用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Verification Method | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：Email OTP；Google Authenticator。 |

业务规则：

- Verification Method：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Verification Code

在「账号安全」中，Verification Code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

背景与用途：在「账号安全」中，Verification Code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Verification Code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Current Password

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Current Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| Manual Setup Key | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Authenticator Code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 必填；未完成时在此字段提示。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：身份验证

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Current Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |
| Manual Setup Key | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| Authenticator Code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 必填；未完成时在此字段提示。 |

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Current Password

在「账号安全」中，Current Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「账号安全」中，Current Password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Current Password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 必填；未完成时在此字段提示。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Manual Setup Key

在「账号安全」中，Manual Setup Key用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在账号安全中能够在「账号安全」中，Manual Setup Key用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Manual Setup Key | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- Manual Setup Key：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号安全 · 填写与确认

管理登录密码和两步验证，并检查近期登录活动。 本区域展示administration-copy-field，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在账号安全中能够管理登录密码和两步验证，并检查近期登录活动。 本区域展示administration-copy-field，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 敏感操作需要重新验证身份

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Authenticator Code

在「账号安全」中，Authenticator Code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

背景与用途：在「账号安全」中，Authenticator Code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Authenticator Code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 必填；未完成时在此字段提示。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-settlement-detail"></a>
## 结算详情

### 要解决什么问题

解释一笔收款怎样扣除费用并进入商户钱包。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 结算概览：状态及关联付款
- 金额拆分：收款、费用和结算净额
- 关联付款与钱包影响：对应订单和入账
- 时间线：处理过程
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 结算概览：解释一笔收款怎样扣除费用并进入商户钱包。 本区域展示结算概览，用于确认当前业务内容及下一步。
- 金额拆分：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 关联付款：解释一笔收款怎样扣除费用并进入商户钱包。 本区域展示关联付款，用于确认当前业务内容及下一步。
- 钱包影响：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 结算详情 · 统计指标：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 处理时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 查看关联收款和钱包流水
- 核对净额与入账结果

### 业务规则与结果

- 结算以实际结果为准
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算概览

解释一笔收款怎样扣除费用并进入商户钱包。 本区域展示结算概览，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算详情中能够解释一笔收款怎样扣除费用并进入商户钱包。 本区域展示结算概览，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 结算概览：状态及关联付款
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

状态含义：

- 待结算（Pending）：成功收款对应资金尚未释放。
- 结算中（Processing）：正在办理结算，尚未完成。
- 已结算（Settled）：本笔结算已完成，可核对实际钱包变化。
- 失败（Failed）：本次结算未成功，需要继续处理。
- 暂缓（On Hold）：结算被暂时保留，显示可公开的处理原因。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额拆分

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：关联付款

解释一笔收款怎样扣除费用并进入商户钱包。 本区域展示关联付款，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算详情中能够解释一笔收款怎样扣除费用并进入商户钱包。 本区域展示关联付款，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 结算概览：状态及关联付款
- 关联付款与钱包影响：对应订单和入账

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包影响

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算详情 · 统计指标

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-settlement-report"></a>
## 结算报表

### 要解决什么问题

核对指定期间结算的进度、金额和对应收款。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 日期与筛选：结算范围
- 指标、趋势和状态：了解已完成及待处理结算
- 金额拆分与结算明细：核对净额
- 报表筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 统计说明：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 期间趋势：核对指定期间结算的进度、金额和对应收款。 本区域展示Settlement Trend，用于确认当前业务内容及下一步。
- 结算报表 · 信息区域：核对指定期间结算的进度、金额和对应收款。 本区域展示结算报表 · 信息区域，用于确认当前业务内容及下一步。
- 业务状态：核对指定期间结算的进度、金额和对应收款。 本区域展示Settlement Status Breakdown，用于确认当前业务内容及下一步。
- 结算金额拆分：核对指定期间结算的进度、金额和对应收款。 本区域展示结算金额拆分，用于确认当前业务内容及下一步。
- 操作与下一步：说明「结算报表」中Settlement Timeline、Settlement ID、Payment Count、Gross Amount、Net Amount的用途，便于填写、查找或核对当前记录。
- 结算报表 · 记录明细：在保持查询条件的前提下浏览更多记录。
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。

### 用户如何完成业务

- 选择期间
- 从结算明细查看付款和钱包影响
- 按页面入口导出

### 业务规则与结果

- 付款日期和结算日期可能不同
- 收款总额不等于结算净额
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：报表筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| 结算状态（Settlement status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 可选值：全部：不按该条件限制；Settled；待处理：尚未得到最终业务结果；处理中：已开始处理但未结束；失败：本次业务未成功，查看原因；On Hold。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| 结算状态（Settlement status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 可选值：全部：不按该条件限制；Settled；待处理：尚未得到最终业务结果；处理中：已开始处理但未结束；失败：本次业务未成功，查看原因；On Hold。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「结算报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「结算报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算状态

在「结算报表」中，结算状态用于成功付款对应资金的结算进度；未结算不等于未付款。

背景与用途：这一部分让使用者在结算报表中能够在「结算报表」中，结算状态用于成功付款对应资金的结算进度；未结算不等于未付款，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 结算状态（Settlement status） | 成功付款对应资金的结算进度；未结算不等于未付款。 | 可选值：全部：不按该条件限制；Settled；待处理：尚未得到最终业务结果；处理中：已开始处理但未结束；失败：本次业务未成功，查看原因；On Hold。 |

业务规则：

- 结算状态：成功付款对应资金的结算进度；未结算不等于未付款。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 待结算（Pending）：成功收款对应资金尚未释放。
- 结算中（Processing）：正在办理结算，尚未完成。
- 已结算（Settled）：本笔结算已完成，可核对实际钱包变化。
- 失败（Failed）：本次结算未成功，需要继续处理。
- 暂缓（On Hold）：结算被暂时保留，显示可公开的处理原因。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

在「结算报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

背景与用途：在「结算报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「结算报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「结算报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「结算报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「结算报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：期间趋势

核对指定期间结算的进度、金额和对应收款。 本区域展示Settlement Trend，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算报表中能够核对指定期间结算的进度、金额和对应收款。 本区域展示Settlement Trend，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款日期和结算日期可能不同

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算报表 · 信息区域

核对指定期间结算的进度、金额和对应收款。 本区域展示结算报表 · 信息区域，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算报表中能够核对指定期间结算的进度、金额和对应收款。 本区域展示结算报表 · 信息区域，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款日期和结算日期可能不同
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务状态

核对指定期间结算的进度、金额和对应收款。 本区域展示Settlement Status Breakdown，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算报表中能够核对指定期间结算的进度、金额和对应收款。 本区域展示Settlement Status Breakdown，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款日期和结算日期可能不同

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

状态含义：

- 待结算（Pending）：成功收款对应资金尚未释放。
- 结算中（Processing）：正在办理结算，尚未完成。
- 已结算（Settled）：本笔结算已完成，可核对实际钱包变化。
- 失败（Failed）：本次结算未成功，需要继续处理。
- 暂缓（On Hold）：结算被暂时保留，显示可公开的处理原因。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算金额拆分

核对指定期间结算的进度、金额和对应收款。 本区域展示结算金额拆分，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算报表中能够核对指定期间结算的进度、金额和对应收款。 本区域展示结算金额拆分，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款日期和结算日期可能不同
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算报表 · 信息区域

核对指定期间结算的进度、金额和对应收款。 本区域展示结算报表 · 信息区域，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在结算报表中能够核对指定期间结算的进度、金额和对应收款。 本区域展示结算报表 · 信息区域，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 付款日期和结算日期可能不同
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

说明「结算报表」中Settlement Timeline、Settlement ID、Payment Count、Gross Amount、Net Amount的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在结算报表中能够说明「结算报表」中Settlement Timeline、Settlement ID、Payment Count、Gross Amount、Net Amount的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Settlement Timeline | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Settlement ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| Payment Count | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| Gross Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| Net Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Settlement Timeline：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- Settlement ID：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- Payment Count：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算报表明细表

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Settlement Timeline | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Settlement ID | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| Payment Count | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| Gross Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| Net Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 待结算（Pending）：成功收款对应资金尚未释放。
- 结算中（Processing）：正在办理结算，尚未完成。
- 已结算（Settled）：本笔结算已完成，可核对实际钱包变化。
- 失败（Failed）：本次结算未成功，需要继续处理。
- 暂缓（On Hold）：结算被暂时保留，显示可公开的处理原因。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：结算报表 · 记录明细

在保持查询条件的前提下浏览更多记录。

背景与用途：在保持查询条件的前提下浏览更多记录。

业务规则：

- 展示结果总数、当前页和每页数量；总数仅属于本次获授权筛选范围。
- 筛选变化后回到第一页，翻页不更改业务数据。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 最后一页不能继续下一页；新查询无记录时显示空结果，不显示旧页数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-support"></a>
## 帮助与支持

### 要解决什么问题

帮助商户找到与账号、认证或其他问题对应的处理入口。

### 为什么这样设计

用户遇到问题时需要明确的下一步和负责渠道，避免在账号页面之间来回寻找。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 问题分类：选择相关账户业务
- 对应入口：进入相关设置或支持途径
- 帮助与支持 · 业务内容：帮助商户找到与账号、认证或其他问题对应的处理入口。 本区域展示Choose the relevant account area，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 选择遇到问题的业务分类

### 业务规则与结果

- 应明确下一步去哪里，不把进入设置页当成问题已解决
- 提供一个正式配置且有人承接的客服渠道；订单和申请页面求助时携带对应编号。未配置渠道时显示联系账户管理员的说明，不显示无效联系方式；首版不建设工单系统。

### 特殊情况

- 内容无法打开时提示返回或重试；不能用其他页面的内容代替当前说明。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：帮助与支持 · 业务内容

帮助商户找到与账号、认证或其他问题对应的处理入口。 本区域展示Choose the relevant account area，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在帮助与支持中能够帮助商户找到与账号、认证或其他问题对应的处理入口。 本区域展示Choose the relevant account area，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 应明确下一步去哪里，不把进入设置页当成问题已解决

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-team-management"></a>
## 团队成员

### 要解决什么问题

管理谁可以访问当前商户以及各成员能做哪些事。

### 为什么这样设计

商户需要知道谁能访问自己的业务、资料是否准确以及谁做过修改；日常资料和认证资料分清，才能避免误改。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 成员列表：身份、角色和邀请/账号状态
- 成员操作：页面支持的邀请和权限管理
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 暂无记录：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 团队成员：让人员按岗位职责访问业务，并能追溯授权变化。

### 用户如何完成业务

- 邀请成员
- 查看成员状态
- 按权限调整成员访问

### 业务规则与结果

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- 角色名称用于说明职责，具体操作仍按授予权限
- 敏感变更应明确影响的成员

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：暂无记录

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：团队成员

让人员按岗位职责访问业务，并能追溯授权变化。

背景与用途：让人员按岗位职责访问业务，并能追溯授权变化。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 邮箱（Email） | 账号验证或联系使用的邮箱，明确用途；已验证邮箱变更需相应验证。 | 只读展示；无值时显示无记录或不适用。 |
| 角色（Role） | 决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Last Login | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 邀请成员、选择权限范围并发送邀请；修改或移除前核对对象和影响，完成后更新列表。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：角色明细表

让人员按岗位职责访问业务，并能追溯授权变化。

背景与用途：让人员按岗位职责访问业务，并能追溯授权变化。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 邮箱（Email） | 账号验证或联系使用的邮箱，明确用途；已验证邮箱变更需相应验证。 | 只读展示；无值时显示无记录或不适用。 |
| 角色（Role） | 决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Last Login | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Email Address

让人员按岗位职责访问业务，并能追溯授权变化。

背景与用途：让人员按岗位职责访问业务，并能追溯授权变化。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Email Address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 必填；未完成时在此字段提示。 |
| 角色（Role） | 决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。 | 必填；未完成时在此字段提示。 |

业务规则：

- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。

操作与交互结果：

- 邀请成员、选择权限范围并发送邀请；修改或移除前核对对象和影响，完成后更新列表。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：团队成员 · 填写资料

说明「团队成员」中Email Address、角色的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在团队成员中能够说明「团队成员」中Email Address、角色的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Email Address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 必填；未完成时在此字段提示。 |
| 角色（Role） | 决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。 | 必填；未完成时在此字段提示。 |

业务规则：

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- Email Address：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。
- 角色：决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Email Address

在「团队成员」中，Email Address用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

背景与用途：这一部分让使用者在团队成员中能够在「团队成员」中，Email Address用于用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Email Address | 用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。 | 必填；未完成时在此字段提示。 |

业务规则：

- Email Address：用于本项联系或账号验证的信息；用途明确，敏感资料按查看权限脱敏。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：角色

在「团队成员」中，角色用于决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。

背景与用途：在「团队成员」中，角色用于决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 角色（Role） | 决定该人员获授予的业务范围和操作能力；角色名称不代替具体权限检查。 | 必填；未完成时在此字段提示。 |

业务规则：

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Member Name

让人员按岗位职责访问业务，并能追溯授权变化。

背景与用途：让人员按岗位职责访问业务，并能追溯授权变化。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Member Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| Current Role | 当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。 | 只读展示；无值时显示无记录或不适用。 |
| New Role | 当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。 | 必填；未完成时在此字段提示。 |

业务规则：

- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。

操作与交互结果：

- 邀请成员、选择权限范围并发送邀请；修改或移除前核对对象和影响，完成后更新列表。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：人员与权限

让人员按岗位职责访问业务，并能追溯授权变化。

背景与用途：让人员按岗位职责访问业务，并能追溯授权变化。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Member Name | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| Current Role | 当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。 | 只读展示；无值时显示无记录或不适用。 |
| New Role | 当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。 | 必填；未完成时在此字段提示。 |

业务规则：

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 邀请成员、选择权限范围并发送邀请；修改或移除前核对对象和影响，完成后更新列表。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：New Role

在「团队成员」中，New Role用于当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。

背景与用途：在「团队成员」中，New Role用于当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| New Role | 当前岗位被授权的业务对象和动作范围；只允许管理本人有权授予的权限。 | 必填；未完成时在此字段提示。 |

业务规则：

- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：团队成员 · 办理流程

让人员按岗位职责访问业务，并能追溯授权变化。

背景与用途：让人员按岗位职责访问业务，并能追溯授权变化。

业务规则：

- 每商户仅内置 Owner，其余角色由商户自定义；首次邀请员工前先创建自定义角色。角色名称不决定权限，按当前角色权限判断。
- Owner 角色不可重建、改名、改权限、停用或删除；Owner 成员不可改角色、停用、移除或转让。Owner 加载为全量权限。
- 自定义角色可创建、改名称和权限、停用或删除；角色 code 在商户内唯一。有成员的角色不可停用或删除；权限改动下一次请求生效。
- 权限来自全局目录，商户不能创建权限点；自定义角色可勾选目录内全部权限，但仍不能修改 Owner 成员或转让 Owner。
- 角色写入、邀请、成员修改仅限 ACTIVE 且当前角色有相应权限；邀请或改成员必须选择当前商户启用的自定义角色，禁止 OWNER 及跨商户 role_id。
- 本商户已有成员或待接受邀请的邮箱不能重复邀请，同一邮箱可加入不同商户。停用成员立即失效该用户在当前商户的会话，其他商户会话不受影响。
- 成员身份、邮箱、角色、状态和最近登录分别展示。
- 邀请不等于已加入；移除成员不删除其历史操作。
- 查看和操作权限分别配置，资金复核不能由申请人自审；不能越权赋予角色。

操作与交互结果：

- 邀请成员、选择权限范围并发送邀请；修改或移除前核对对象和影响，完成后更新列表。

异常处理：

- 邀请重复、已失效或权限不足时给出可处理原因；不能移除最后一位必要所有者而使商户无人管理。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-terms"></a>
## 服务条款

### 要解决什么问题

说明使用 iPay 服务的约定，供注册或使用前阅读。

### 为什么这样设计

使用者需要在作出同意前了解服务约定及信息用途，政策版本和维护责任也必须清楚。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 服务条款正文：服务约定和责任说明
- 服务条款 · 业务内容：说明使用 iPay 服务的约定，供注册或使用前阅读。 本区域展示Terms of Service，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 阅读条款并返回原流程

### 业务规则与结果

- 展示条款和主动同意是两个动作
- 展示正式批准的条款、隐私政策和版本日期，由业务维护发布版本。注册同意记录对应当时版本；缺少正式版本时禁止正式注册提交，不用演示正文替代。

### 特殊情况

- 内容无法打开时提示返回或重试；不能用其他页面的内容代替当前说明。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：服务条款 · 业务内容

说明使用 iPay 服务的约定，供注册或使用前阅读。 本区域展示Terms of Service，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在服务条款中能够说明使用 iPay 服务的约定，供注册或使用前阅读。 本区域展示Terms of Service，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 展示条款和主动同意是两个动作

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-top-up-details"></a>
## 充值申请详情

### 要解决什么问题

核对一笔充值申请的转账指引、提交资料和最终处理结果。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 申请概览：金额与状态
- 转账指引：收款账户及参考信息
- 已提交资料：转账时间和凭证
- 结果与时间线：审核、核实和入账进展
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 申请摘要：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 充值概览：帮助商户建立和跟进一笔向钱包补充资金的申请。
- 转账指引：让商户按指定账户付款，并向核实人员提供可查证资料。
- 已提交转账资料：让发起方和查询人员确认钱将交给谁、按什么方式办理。
- 处理结果：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 处理时间线：按时间还原业务从创建到当前结果的过程。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。

### 用户如何完成业务

- 根据当前阶段查看指引或已提交信息
- 跟进结果

### 业务规则与结果

- 申请提交、审核通过和充值入账分别表达
- 未核实到账不能提前增加可用余额
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 少付、多付、重复转账和凭证不一致分别标记待核实，保留金额、凭证和处理意见。核实前不完成到账；重复付款不能重复记同一笔充值。以实际核实金额和获批处理结果办理，不自动把差额当费用。
- 资料可补正时在原申请补充后重新提交，保留每次提交和审核记录；新的实际付款新建申请，避免把不同转账合并。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：申请摘要

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：充值概览

帮助商户建立和跟进一笔向钱包补充资金的申请。

背景与用途：帮助商户建立和跟进一笔向钱包补充资金的申请。

业务规则：

- 金额大于零且最多两位小数；根据充值方式展示费用和实付总额。
- 申请已提交、实际已付款、资料已核实、已入账分别表示。
- 少付、多付、重复和凭证不一致进入待核实，核实前不作为到账完成。
- 少付、多付、重复转账和凭证不一致分别标记待核实，保留金额、凭证和处理意见。核实前不完成到账；重复付款不能重复记同一笔充值。以实际核实金额和获批处理结果办理，不自动把差额当费用。
- 资料可补正时在原申请补充后重新提交，保留每次提交和审核记录；新的实际付款新建申请，避免把不同转账合并。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。

操作与交互结果：

- 填写金额，选择可用方式并确认费用；依付款指引办理，随后在申请详情跟进结果。

状态含义：

- 等待付款（Awaiting Transfer）：申请已建立，等待商户按指引付款。
- 等待审批（Pending Approval）：等待独立复核。
- 等待核实（Pending Verification）：等待核对实际付款与凭证，差额单独说明。
- 处理中（Processing）：核实后的业务正在执行，不等于已入账。
- 完成（Completed）：已完成实际入账，可查看钱包流水。
- 驳回（Rejected）：申请未获通过；可补正资料时保留原申请重新提交，已付款款项继续跟进。
- 到期／取消：只适用于未付款且符合结束条件的申请。

异常处理：

- 结果未知时保留申请编号查询，不要求再次付款；未付款申请可在允许阶段取消。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：转账指引

让商户按指定账户付款，并向核实人员提供可查证资料。

背景与用途：让商户按指定账户付款，并向核实人员提供可查证资料。

业务规则：

- 展示收款机构、账户名、账户号、应付金额和本次申请参考号。
- 凭证为 JPG、PNG 或 PDF；银行参考号与平台申请号分别保存。
- 资料补正保留历次提交；另一笔实际转账建立新的申请。

操作与交互结果：

- 核对收款信息后付款，填写转账参考号并上传清晰凭证，提交后显示核实进度。

异常处理：

- 文件格式不支持或无法读取时说明原因并保留其他输入；已付款后资料被驳回仍保留付款事实。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：已提交转账资料

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理结果

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-top-up-requests"></a>
## 充值申请记录

### 要解决什么问题

查找历史及待处理充值，判断哪笔还需要继续操作。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 申请列表：金额、提交时间和当前状态
- 申请历史：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 打开具体申请查看指引、资料和结果

### 业务规则与结果

- 申请状态不能代替钱包是否已入账
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 少付、多付、重复转账和凭证不一致分别标记待核实，保留金额、凭证和处理意见。核实前不完成到账；重复付款不能重复记同一笔充值。以实际核实金额和获批处理结果办理，不自动把差额当费用。
- 资料可补正时在原申请补充后重新提交，保留每次提交和审核记录；新的实际付款新建申请，避免把不同转账合并。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：申请历史

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Created / Submitted | 创建时间：业务记录建立时间，按 Asia/Manila 展示，与提交或完成时间分开。；提交时间：资料或申请正式提交的时间，与保存草稿时间分开。 | 只读展示；无值时显示无记录或不适用。 |
| Top Up Reference | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：充值申请记录明细表

说明「充值申请记录」中Created / Submitted、Top Up Reference、金额、状态、操作的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在充值申请记录中能够说明「充值申请记录」中Created / Submitted、Top Up Reference、金额、状态、操作的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Created / Submitted | 创建时间：业务记录建立时间，按 Asia/Manila 展示，与提交或完成时间分开。；提交时间：资料或申请正式提交的时间，与保存草稿时间分开。 | 只读展示；无值时显示无记录或不适用。 |
| Top Up Reference | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Created / Submitted：创建时间：业务记录建立时间，按 Asia/Manila 展示，与提交或完成时间分开。；提交时间：资料或申请正式提交的时间，与保存草稿时间分开。
- Top Up Reference：用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。
- 金额：本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 少付、多付、重复转账和凭证不一致分别标记待核实，保留金额、凭证和处理意见。核实前不完成到账；重复付款不能重复记同一笔充值。以实际核实金额和获批处理结果办理，不自动把差额当费用。
- 资料可补正时在原申请补充后重新提交，保留每次提交和审核记录；新的实际付款新建申请，避免把不同转账合并。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 等待付款（Awaiting Transfer）：申请已建立，等待商户按指引付款。
- 等待审批（Pending Approval）：等待独立复核。
- 等待核实（Pending Verification）：等待核对实际付款与凭证，差额单独说明。
- 处理中（Processing）：核实后的业务正在执行，不等于已入账。
- 完成（Completed）：已完成实际入账，可查看钱包流水。
- 驳回（Rejected）：申请未获通过；可补正资料时保留原申请重新提交，已付款款项继续跟进。
- 到期／取消：只适用于未付款且符合结束条件的申请。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-top-up"></a>
## 发起充值

### 要解决什么问题

填写充值金额并获取转账指引，完成后按流程提交转账资料。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 金额输入：计划充值金额
- 确认页：复核充值信息
- 转账指引：实际收款账户和填写要求
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 输入金额：帮助商户建立和跟进一笔向钱包补充资金的申请。
- 充值确认：帮助商户建立和跟进一笔向钱包补充资金的申请。
- 转账指引：让商户按指定账户付款，并向核实人员提供可查证资料。

### 用户如何完成业务

- 输入金额并复核
- 按指引转账并继续对应提交步骤

### 业务规则与结果

- 展示指引不表示已经收到资金
- 申请处理结果以核实和入账为准
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 少付、多付、重复转账和凭证不一致分别标记待核实，保留金额、凭证和处理意见。核实前不完成到账；重复付款不能重复记同一笔充值。以实际核实金额和获批处理结果办理，不自动把差额当费用。
- 资料可补正时在原申请补充后重新提交，保留每次提交和审核记录；新的实际付款新建申请，避免把不同转账合并。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：输入金额

帮助商户建立和跟进一笔向钱包补充资金的申请。

背景与用途：帮助商户建立和跟进一笔向钱包补充资金的申请。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Top Up Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |

业务规则：

- 金额大于零且最多两位小数；根据充值方式展示费用和实付总额。
- 申请已提交、实际已付款、资料已核实、已入账分别表示。
- 少付、多付、重复和凭证不一致进入待核实，核实前不作为到账完成。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 填写金额，选择可用方式并确认费用；依付款指引办理，随后在申请详情跟进结果。

异常处理：

- 结果未知时保留申请编号查询，不要求再次付款；未付款申请可在允许阶段取消。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Top Up Amount

在「发起充值」中，Top Up Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：在「发起充值」中，Top Up Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Top Up Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |

业务规则：

- 金额大于零且最多两位小数；根据充值方式展示费用和实付总额。
- 申请已提交、实际已付款、资料已核实、已入账分别表示。
- 少付、多付、重复和凭证不一致进入待核实，核实前不作为到账完成。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 结果未知时保留申请编号查询，不要求再次付款；未付款申请可在允许阶段取消。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：充值确认

帮助商户建立和跟进一笔向钱包补充资金的申请。

背景与用途：帮助商户建立和跟进一笔向钱包补充资金的申请。

业务规则：

- 金额大于零且最多两位小数；根据充值方式展示费用和实付总额。
- 申请已提交、实际已付款、资料已核实、已入账分别表示。
- 少付、多付、重复和凭证不一致进入待核实，核实前不作为到账完成。
- 少付、多付、重复转账和凭证不一致分别标记待核实，保留金额、凭证和处理意见。核实前不完成到账；重复付款不能重复记同一笔充值。以实际核实金额和获批处理结果办理，不自动把差额当费用。
- 资料可补正时在原申请补充后重新提交，保留每次提交和审核记录；新的实际付款新建申请，避免把不同转账合并。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。

操作与交互结果：

- 填写金额，选择可用方式并确认费用；依付款指引办理，随后在申请详情跟进结果。

异常处理：

- 结果未知时保留申请编号查询，不要求再次付款；未付款申请可在允许阶段取消。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：转账指引

让商户按指定账户付款，并向核实人员提供可查证资料。

背景与用途：让商户按指定账户付款，并向核实人员提供可查证资料。

业务规则：

- 展示收款机构、账户名、账户号、应付金额和本次申请参考号。
- 凭证为 JPG、PNG 或 PDF；银行参考号与平台申请号分别保存。
- 资料补正保留历次提交；另一笔实际转账建立新的申请。

操作与交互结果：

- 核对收款信息后付款，填写转账参考号并上传清晰凭证，提交后显示核实进度。

异常处理：

- 文件格式不支持或无法读取时说明原因并保留其他输入；已付款后资料被驳回仍保留付款事实。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：银行转账参考号

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 银行转账参考号（Bank Transfer Reference） | 实际付款机构提供的转账编号，供核实人员查证，不是平台申请号。 | 可选；不适用时允许留空。 |
| Choose a receipt JPG, PNG, or PDF | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 可选；不适用时允许留空。 |
| Transfer Date / Time (optional) | Transfer Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。；Time (optional)：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收款对象与转账信息

让发起方和查询人员确认钱将交给谁、按什么方式办理。

背景与用途：让发起方和查询人员确认钱将交给谁、按什么方式办理。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 银行转账参考号（Bank Transfer Reference） | 实际付款机构提供的转账编号，供核实人员查证，不是平台申请号。 | 可选；不适用时允许留空。 |
| Choose a receipt JPG, PNG, or PDF | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 可选；不适用时允许留空。 |
| Transfer Date / Time (optional) | Transfer Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。；Time (optional)：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款商户或收款人、机构、脱敏账户、业务金额及备注；平台编号与商户自有编号分别标明。
- 网页创建商户间转账时先验证接收商户，再填写金额和费用确认；更换接收方后重新验证。

操作与交互结果：

- 输入或选择收款对象并核对名称；确认前再次展示收款对象和总扣款。

异常处理：

- 对象无效、被限制或无法核实时停止提交并说明原因；不能沿用上一个已验证对象的结果。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：银行转账参考号

在「发起充值」中，银行转账参考号用于实际付款机构提供的转账编号，供核实人员查证，不是平台申请号。

背景与用途：在「发起充值」中，银行转账参考号用于实际付款机构提供的转账编号，供核实人员查证，不是平台申请号。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 银行转账参考号（Bank Transfer Reference） | 实际付款机构提供的转账编号，供核实人员查证，不是平台申请号。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款机构、账户名、账户号、应付金额和本次申请参考号。
- 凭证为 JPG、PNG 或 PDF；银行参考号与平台申请号分别保存。
- 资料补正保留历次提交；另一笔实际转账建立新的申请。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 文件格式不支持或无法读取时说明原因并保留其他输入；已付款后资料被驳回仍保留付款事实。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Choose a receipt JPG, PNG, or PDF

在「发起充值」中，Choose a receipt JPG, PNG, or PDF用于当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。

背景与用途：在「发起充值」中，Choose a receipt JPG, PNG, or PDF用于当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Choose a receipt JPG, PNG, or PDF | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 可选；不适用时允许留空。 |

业务规则：

- 展示收款机构、账户名、账户号、应付金额和本次申请参考号。
- 凭证为 JPG、PNG 或 PDF；银行参考号与平台申请号分别保存。
- 资料补正保留历次提交；另一笔实际转账建立新的申请。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 文件格式不支持或无法读取时说明原因并保留其他输入；已付款后资料被驳回仍保留付款事实。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「发起充值」中，Transfer Date / Time (optional)用于Transfer Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。；Time (optional)：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：这一部分让使用者在发起充值中能够在「发起充值」中，Transfer Date / Time (optional)用于Transfer Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。；Time (optional)：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Transfer Date / Time (optional) | Transfer Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。；Time (optional)：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- Transfer Date / Time (optional)：Transfer Date：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。；Time (optional)：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-verification"></a>
## 企业认证状态

### 要解决什么问题

让商户知道认证进度，以及已经提交了哪些企业信息。

### 为什么这样设计

商户需要知道谁能访问自己的业务、资料是否准确以及谁做过修改；日常资料和认证资料分清，才能避免误改。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 认证状态：待提交、审核或结果提示
- 企业、地址、代表人和受益人：提交资料
- 文件：认证材料
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 暂无记录：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 企业认证状态 · 业务内容：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。
- 认证状态：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。
- 企业认证资料：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。
- 注册地址：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。
- 授权代表：说明由谁代表企业，以及谁实际拥有或控制企业。
- 受益所有人：说明由谁代表企业，以及谁实际拥有或控制企业。
- 认证文件：向审核人员提供与当前企业或人员对应的证明材料。
- 资料填写：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

### 用户如何完成业务

- 查看认证状态
- 有补件要求时按提示继续
- 通过支持入口处理信息问题

### 业务规则与结果

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 审核中资料按已提交版本展示
- 通过认证后仍按实际开通能力使用业务

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：暂无记录

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：企业认证状态 · 业务内容

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：认证状态

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Application Reference | 用于唯一识别本项业务对象的标识，保留原值用于查询，不用另一个对象的编号替代。 | 只读展示；无值时显示无记录或不适用。 |
| 提交版本（Submission Version） | 本次提交资料的版本，用于与前次资料和审核意见对照。 | 只读展示；无值时显示无记录或不适用。 |
| Submitted Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Approved Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Last Reviewed Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| Reviewed By | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

状态含义：

- 未提交／草稿：可编辑资料，尚未进入审核。
- 已提交／审核中：读取已提交版本，等待审核人员处理。
- 需补件：显示具体补充项及原因，补充后重新提交。
- 已通过：认证审核通过，业务能力按开通状态另行判断。
- 已拒绝：显示可公开原因及处理入口。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：企业认证资料

让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

背景与用途：让商户或审核人员知道认证目前进行到哪一步，以及下一步需要什么。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 未提交、审核中、需补件、已通过、已拒绝分别说明结果；认证状态不等同商户全部业务已开通。
- 已提交资料只读，补件时只修改允许补充内容并保留历史。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 商户继续填写或补件；内部审核人员查看材料，给出明确的通过、拒绝或补件意见。

异常处理：

- 读取失败不能显示已通过；补件要求必须具体到缺失或不合格资料。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：注册地址

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：授权代表

说明由谁代表企业，以及谁实际拥有或控制企业。

背景与用途：说明由谁代表企业，以及谁实际拥有或控制企业。

业务规则：

- 展示姓名、身份信息、国籍、出生日期、持股或控制关系；多位所有人分别记录。
- 持股比例是企业归属信息，不是费率；身份证明仅授权人员查看。

操作与交互结果：

- 逐人填写或核对资料；更换代表人或所有人时保留相应审核依据。

异常处理：

- 必要资料缺失或比例格式不正确时提示对应人员，不能用其他人的资料补位。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：受益所有人

说明由谁代表企业，以及谁实际拥有或控制企业。

背景与用途：说明由谁代表企业，以及谁实际拥有或控制企业。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 持股比例（Ownership） | 该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。 | 只读展示；无值时显示无记录或不适用。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 只读展示；无值时显示无记录或不适用。 |
| 出生日期（Date of Birth） | 认证人员真实出生日期，不接受未来日期。 | 只读展示；无值时显示无记录或不适用。 |
| 身份证明（Identification） | 人员身份文件类型及号码；只向授权审核人员展示。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 展示姓名、身份信息、国籍、出生日期、持股或控制关系；多位所有人分别记录。
- 持股比例是企业归属信息，不是费率；身份证明仅授权人员查看。

操作与交互结果：

- 逐人填写或核对资料；更换代表人或所有人时保留相应审核依据。

异常处理：

- 必要资料缺失或比例格式不正确时提示对应人员，不能用其他人的资料补位。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：企业认证状态明细表

说明「企业认证状态」中名称、持股比例、国籍、出生日期、身份证明的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在企业认证状态中能够说明「企业认证状态」中名称、持股比例、国籍、出生日期、身份证明的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 名称（Name） | 当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。 | 只读展示；无值时显示无记录或不适用。 |
| 持股比例（Ownership） | 该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。 | 只读展示；无值时显示无记录或不适用。 |
| 国籍（Nationality） | 认证人员身份证明对应的国籍信息。 | 只读展示；无值时显示无记录或不适用。 |
| 出生日期（Date of Birth） | 认证人员真实出生日期，不接受未来日期。 | 只读展示；无值时显示无记录或不适用。 |
| 身份证明（Identification） | 人员身份文件类型及号码；只向授权审核人员展示。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 名称：当前对象的可读名称，与其唯一编号配合识别，不用名称替代业务编号。
- 持股比例：该受益所有人对应的企业持股比例，填写 0 至 100 的百分数；不是服务费率。
- 国籍：认证人员身份证明对应的国籍信息。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：认证文件

向审核人员提供与当前企业或人员对应的证明材料。

背景与用途：向审核人员提供与当前企业或人员对应的证明材料。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件类型（Document Type） | 说明上传材料证明的事项，必须与当前企业或人员对应。 | 只读展示；无值时显示无记录或不适用。 |
| File | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Uploaded Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 每份文件列出类型、文件名、上传时间和审核状态，明确属于哪个对象。
- 敏感文件仅授权人员可查看或下载，不通过猜测网址访问。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 选择文件类型并上传，核对预览后提交；审核不通过时说明需替换哪份资料。

异常处理：

- 上传失败保留其他已填资料；文件不可读或类型不符时明确提示，不显示上传成功。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：文件类型明细表

向审核人员提供与当前企业或人员对应的证明材料。

背景与用途：向审核人员提供与当前企业或人员对应的证明材料。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 文件类型（Document Type） | 说明上传材料证明的事项，必须与当前企业或人员对应。 | 只读展示；无值时显示无记录或不适用。 |
| File | 当前资料或图片文件，展示文件名及状态；上传失败不表示保存成功，敏感文件仅授权人员可查看。 | 只读展示；无值时显示无记录或不适用。 |
| 状态（Status） | 当前对象的业务阶段；具体可选值及含义在本标注的状态说明中解释。 | 只读展示；无值时显示无记录或不适用。 |
| Uploaded Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 每份文件列出类型、文件名、上传时间和审核状态，明确属于哪个对象。
- 敏感文件仅授权人员可查看或下载，不通过猜测网址访问。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

状态含义：

- 未提交／草稿：可编辑资料，尚未进入审核。
- 已提交／审核中：读取已提交版本，等待审核人员处理。
- 需补件：显示具体补充项及原因，补充后重新提交。
- 已通过：认证审核通过，业务能力按开通状态另行判断。
- 已拒绝：显示可公开原因及处理入口。

异常处理：

- 上传失败保留其他已填资料；文件不可读或类型不符时明确提示，不显示上传成功。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：资料填写

区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

背景与用途：区分正式认证资料和日常经营联系方式，确保用户知道哪些可修改。

业务规则：

- Owner 接受邀请仅完成账号激活并进入 PENDING_KYB，不代表 KYB 已通过或业务能力已开通。KYB 提交、补件、审核事实与 Merchant 状态、Capability 分别展示；不使用邀请接受结果代替 KYB 审核。
- 企业名称、经营名称、行业、地址、联系人分别说明用途；认证提交内容保留提交时版本。
- 日常经营资料修改不自动改写已审核的认证材料。

操作与交互结果：

- 查看当前值，编辑允许修改的字段并保存；必填缺失时在对应字段说明。

异常处理：

- 保存失败保留输入并继续展示原生效资料；无编辑权限时只读。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-wallet-balance-detail"></a>
## 每日余额详情

### 要解决什么问题

解释某一天钱包余额如何从期初变为期末，并定位对账差异。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 快照范围：日期和币种
- 期初与期末：当天开始和结束余额
- 收入与支出：分类变化
- 对账与关联流水：差异及明细
- 读取失败与重试：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 记录不存在或不可访问：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 余额概览：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 余额拆分：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 资金变动汇总：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 收入变动：从一天的期初、变动和期末余额核对资金是否一致。
- 支出变动：从一天的期初、变动和期末余额核对资金是否一致。
- 钱包对账：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 相关资金变动：说明「每日余额详情」中时间、收支方向、Transaction Type、业务参考号、金额的用途，便于填写、查找或核对当前记录。
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。

### 用户如何完成业务

- 核对期初、变动和期末
- 进入相关流水追溯差异

### 业务规则与结果

- 这是指定日期的余额快照，不是实时余额
- 各类余额分别核对
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 向商户展示可公开的冻结原因、受影响金额、需补资料和处理入口；内部风险识别细节仅供授权人员查看。未有可靠预计时间时不承诺恢复时间。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取失败与重试

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：记录不存在或不可访问

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：余额概览

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：余额拆分

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：资金变动汇总

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收入变动

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。

操作与交互结果：

- 选择日期查看快照，从差额或变动进入该日相关流水。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：支出变动

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。

操作与交互结果：

- 选择日期查看快照，从差额或变动进入该日相关流水。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包对账

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：相关资金变动

说明「每日余额详情」中时间、收支方向、Transaction Type、业务参考号、金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在每日余额详情中能够说明「每日余额详情」中时间、收支方向、Transaction Type、业务参考号、金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 只读展示；无值时显示无记录或不适用。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 可用余额变化（Available Impact） | 本次记录对可用余额的实际增减；可能与业务本金不同。 | 只读展示；无值时显示无记录或不适用。 |
| 变动后余额（Balance After） | 该笔已记账事件发生后的对应余额，与当前最新余额区分。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 时间：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。
- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务参考号明细表

说明「每日余额详情」中时间、收支方向、Transaction Type、业务参考号、金额的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在每日余额详情中能够说明「每日余额详情」中时间、收支方向、Transaction Type、业务参考号、金额的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 时间（Time） | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 只读展示；无值时显示无记录或不适用。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 可用余额变化（Available Impact） | 本次记录对可用余额的实际增减；可能与业务本金不同。 | 只读展示；无值时显示无记录或不适用。 |
| 变动后余额（Balance After） | 该笔已记账事件发生后的对应余额，与当前最新余额区分。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 时间：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。
- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-wallet-report"></a>
## 钱包余额报表

### 要解决什么问题

按天查看钱包余额变化，支持商户对账。

### 为什么这样设计

财务需要从汇总追溯明细，并用一致的期间、币种和金额口径对账，避免同一笔业务在不同报表中无法对上。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 查询期间：日期范围
- 余额汇总和趋势：观察变化
- 每日快照：逐日的期初期末余额
- 收支分类与对账提示：解释变化和差异
- 报表筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 查询条件：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 日期范围：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 搜索与筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 暂无记录：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 统计说明：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。
- 期间趋势：从一天的期初、变动和期末余额核对资金是否一致。
- 日期：从一天的期初、变动和期末余额核对资金是否一致。
- 统计说明：在保持查询条件的前提下浏览更多记录。
- 统计说明：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 收入变动：从一天的期初、变动和期末余额核对资金是否一致。
- 支出变动：从一天的期初、变动和期末余额核对资金是否一致。
- 钱包余额报表 · 统计指标：按天查看钱包余额变化，支持商户对账。 本区域展示Reconciliation Alerts，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 选择期间
- 打开某日余额详情
- 查看关联流水

### 业务规则与结果

- 可用、待结算及冻结余额分别展示
- 快照应显示所属日期和数据时点
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 退款本金、退还手续费和额外费用分别记录。手续费处理使用该交易适用的业务协议和费用配置；没有适用规则时禁止发起新的退款费用调整并说明原因。首版提供已发生退款的查询，不新增通用退款操作。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 向商户展示可公开的冻结原因、受影响金额、需补资料和处理入口；内部风险识别细节仅供授权人员查看。未有可靠预计时间时不承诺恢复时间。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：报表筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Balance type | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 可选值：全部：不按该条件限制；Available Balance；Frozen Balance；Pending Settlement。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：查询条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Balance type | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 可选值：全部：不按该条件限制；Available Balance；Frozen Balance；Pending Settlement。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |
| Balance type | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 可选值：全部：不按该条件限制；Available Balance；Frozen Balance；Pending Settlement。 |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「钱包余额报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

背景与用途：在「钱包余额报表」中，日期范围用于限定查询起止日期，并明确使用的业务时间与时区。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期范围（Date range） | 限定查询起止日期，并明确使用的业务时间与时区。 | 可选值：今天：马尼拉业务日；昨天：上一个马尼拉业务日；This Week；This Month；Last Month；最近三十个业务日；Custom Range。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Balance type

在「钱包余额报表」中，Balance type用于本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。

背景与用途：这一部分让使用者在钱包余额报表中能够在「钱包余额报表」中，Balance type用于本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Balance type | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 可选值：全部：不按该条件限制；Available Balance；Frozen Balance；Pending Settlement。 |

业务规则：

- Balance type：本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

在「钱包余额报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

背景与用途：在「钱包余额报表」中，搜索用于用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「钱包余额报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「钱包余额报表」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「钱包余额报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「钱包余额报表」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：暂无记录

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

背景与用途：帮助商户判断现在能用多少钱，以及其余资金暂时不可用的原因。

业务规则：

- 可用余额可用于当前已授权的资金业务；待结算余额是已收款但尚未释放的资金；冻结余额暂不可用。
- 余额合计等于可用、待结算和冻结之和，不等于全部可提现。
- 三个余额使用同一商户、同一币种和同一更新时间；不能将不同时间的值拼成一份最新余额。

操作与交互结果：

- 先核对商户和币种，再查看余额分类。
- 点击刷新重新读取余额，期间显示更新中；成功后一起更新金额和时间。
- 点击查看钱包详情进入当前商户的钱包，继续查询流水和申请。

异常处理：

- 读取中不显示假零值；失败保留最后成功数据并注明未更新，支持重试。
- 无权限时不展示金额；确认为零时才显示 0.00。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：期间趋势

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。

操作与交互结果：

- 选择日期查看快照，从差额或变动进入该日相关流水。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Opening Available Balance | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 只读展示；无值时显示无记录或不适用。 |
| 收入变动（Credits） | 统计期间已记账的收入变化，不把未完成申请计入。 | 只读展示；无值时显示无记录或不适用。 |
| 支出变动（Debits） | 统计期间已记账的支出变化，本金及费用按对应业务明示。 | 只读展示；无值时显示无记录或不适用。 |
| Closing Available Balance | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 只读展示；无值时显示无记录或不适用。 |
| Frozen Balance | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 只读展示；无值时显示无记录或不适用。 |
| 待结算余额（Pending Settlement） | 已形成待结算记录但尚未转入可用余额的资金。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。

操作与交互结果：

- 选择日期查看快照，从差额或变动进入该日相关流水。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包余额报表明细表

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Opening Available Balance | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 只读展示；无值时显示无记录或不适用。 |
| 收入变动（Credits） | 统计期间已记账的收入变化，不把未完成申请计入。 | 只读展示；无值时显示无记录或不适用。 |
| 支出变动（Debits） | 统计期间已记账的支出变化，本金及费用按对应业务明示。 | 只读展示；无值时显示无记录或不适用。 |
| Closing Available Balance | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 只读展示；无值时显示无记录或不适用。 |
| Frozen Balance | 本项对应时点和分类的余额；期初、期末及变动分开，不把待结算或冻结金额算作可提现。 | 只读展示；无值时显示无记录或不适用。 |
| 待结算余额（Pending Settlement） | 已形成待结算记录但尚未转入可用余额的资金。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 成功收款保留原始付款事实；退款单列，不从历史成功笔数中删除。净收款为同一统计范围内成功收款金额减退款金额，手续费另外展示。各指标明确采用付款或退款发生时间，不能把两个不同期间直接对比。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

在保持查询条件的前提下浏览更多记录。

背景与用途：在保持查询条件的前提下浏览更多记录。

业务规则：

- 展示结果总数、当前页和每页数量；总数仅属于本次获授权筛选范围。
- 筛选变化后回到第一页，翻页不更改业务数据。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 最后一页不能继续下一页；新查询无记录时显示空结果，不显示旧页数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：统计说明

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收入变动

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。

操作与交互结果：

- 选择日期查看快照，从差额或变动进入该日相关流水。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：支出变动

从一天的期初、变动和期末余额核对资金是否一致。

背景与用途：从一天的期初、变动和期末余额核对资金是否一致。

业务规则：

- 按 Asia/Manila 业务日期、商户和币种组织。
- 期初加本期有效变动等于期末；可用、待结算、冻结分别核对。
- 迟到记账与修正保留发生时间、记账时间及修正原因；任何非零差额明确展示。

操作与交互结果：

- 选择日期查看快照，从差额或变动进入该日相关流水。

异常处理：

- 没有完整资料时显示待核实；不能将没有快照解释为零余额或已对平。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：钱包余额报表 · 统计指标

按天查看钱包余额变化，支持商户对账。 本区域展示Reconciliation Alerts，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在钱包余额报表中能够按天查看钱包余额变化，支持商户对账。 本区域展示Reconciliation Alerts，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 可用、待结算及冻结余额分别展示

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-wallet-transaction-details"></a>
## 钱包流水详情

### 要解决什么问题

说明一笔已记录的资金变动因何发生，以及各类余额怎样变化。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 交易概览：类型、方向、金额和时间
- 关联业务：对应订单或申请
- 余额变化：变动前、变动额和变动后
- 时间线：发生与入账时间
- 读取进度：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 无访问权限：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 记录不存在或不可访问：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 流水概览：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 关联交易：说明一笔已记录的资金变动因何发生，以及各类余额怎样变化。 本区域展示关联交易，用于确认当前业务内容及下一步。
- 余额变化：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 交易信息：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 处理时间线：按时间还原业务从创建到当前结果的过程。

### 用户如何完成业务

- 查看关联交易
- 核对余额变化

### 业务规则与结果

- 收入和支出方向必须清楚
- 记录不存在或无权查看时不能显示其他流水替代
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 向商户展示可公开的冻结原因、受影响金额、需补资料和处理入口；内部风险识别细节仅供授权人员查看。未有可靠预计时间时不承诺恢复时间。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：无访问权限

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：记录不存在或不可访问

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：流水概览

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：关联交易

说明一笔已记录的资金变动因何发生，以及各类余额怎样变化。 本区域展示关联交易，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在钱包流水详情中能够说明一笔已记录的资金变动因何发生，以及各类余额怎样变化。 本区域展示关联交易，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 收入和支出方向必须清楚

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：余额变化

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易信息

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理时间线

按时间还原业务从创建到当前结果的过程。

背景与用途：按时间还原业务从创建到当前结果的过程。

业务规则：

- 每个事件展示时间、事件名称、处理人或系统来源、结果及必要说明。
- 创建、提交、审批、支付和入账分别记录，不能互相替代。
- 补件和重新提交保留前次记录；历史修正留存原因。

操作与交互结果：

- 按时间阅读记录并打开相关凭证或业务详情；返回后保留当前对象。

异常处理：

- 尚未发生的完成事件不显示虚构时间；无记录时说明暂无处理记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-wallet-transactions"></a>
## 钱包流水

### 要解决什么问题

逐笔查询钱包收入、支出和其他余额变化，用于核账。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 查询条件：关键词、日期、类型和收支方向
- 流水列表：金额、方向、关联业务和入账时间
- 钱包流水：解释一笔业务如何影响商户钱包，支持逐笔对账。
- 查询条件：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 搜索：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 日期：在「钱包流水」中，日期用于当前业务使用的日期范围；统一使用 Asia/Manila。
- 操作与下一步：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 收支方向：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 搜索与筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 交易记录：说明「钱包流水」中Date & Time、收支方向、Transaction Type、说明、业务参考号的用途，便于填写、查找或核对当前记录。

### 用户如何完成业务

- 组合查询条件
- 打开流水查看余额变动明细

### 业务规则与结果

- 流水解释实际账务变动
- 待处理申请不应伪装成已经入账的流水
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。
- 确认资金操作前展示适用费用及总额。收款详情分别展示收款本金、实际手续费、净额和结算进度；只有已完成的账务结果改变余额，报价和待处理申请不当作已入账。生效费用按交易发生时的商户配置保留。
- 首版提供 CSV 导出，并能查询生成进度、结果和下载入口。导出沿用当前权限、筛选、时间范围及币种；文件有效期在导出记录中显示，到期后可重新生成。原生 Excel、PDF、多语言和验真二维码凭证不纳入首版。
- 向商户展示可公开的冻结原因、受影响金额、需补资料和处理入口；内部风险识别细节仅供授权人员查看。未有可靠预计时间时不承诺恢复时间。
- 对账分为已核对、存在差异、待核实。默认任何非零差额都显示，不自动抹平；有效财务规则允许的舍入作为有依据的独立调整展示。迟到交易和历史修正保留发生时间、记账时间、修正原因和版本，不静默改写原报表。

### 特殊情况

- 读取失败时说明原因并提供重试或返回入口；不能把失败显示为成功或零余额。
- 没有记录时说明暂无记录；筛选无结果时提示调整条件。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：钱包流水

解释一笔业务如何影响商户钱包，支持逐笔对账。

背景与用途：解释一笔业务如何影响商户钱包，支持逐笔对账。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Types；Collection Settlement；Top Up；Internal Transfer In；Funds Released；Fee Reversal；Manual Adjustment Credit；Disbursement；Withdrawal；Internal Transfer Out；Fee；Funds Frozen；Manual Adjustment Debit。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 可选值：全部：不按该条件限制；Credit；Debit。 |

业务规则：

- 展示业务类型、业务编号、方向、本金、费用、发生时间和记账时间。
- 三类余额分别列出变动前、变动额、变动后，变动后等于变动前加变动额。
- 已记账流水与待处理资金申请分开；冻结和解冻属于余额分类变化，不自动算作新收入。
- 业务金额、本金、手续费和可用余额变化分别标明；详情列出可用、待结算、冻结三类余额的变动前、变动额和变动后。一次资金内部转移不重复计算收入。

操作与交互结果：

- 点击相关订单继续核对业务，返回时仍查看这笔流水。

异常处理：

- 记录结果未知时不产生虚构入账；无权限或记录不存在时保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：查询条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Types；Collection Settlement；Top Up；Internal Transfer In；Funds Released；Fee Reversal；Manual Adjustment Credit；Disbursement；Withdrawal；Internal Transfer Out；Fee；Funds Frozen；Manual Adjustment Debit。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 可选值：全部：不按该条件限制；Credit；Debit。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 搜索（Search） | 用于缩小本页记录范围；不修改记录，应用后明细和汇总使用同一组条件。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期

在「钱包流水」中，日期用于当前业务使用的日期范围；统一使用 Asia/Manila。

背景与用途：这一部分让使用者在钱包流水中能够在「钱包流水」中，日期用于当前业务使用的日期范围；统一使用 Asia/Manila，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「钱包流水」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「钱包流水」中，Start Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Start Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：日期范围

在「钱包流水」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

背景与用途：在「钱包流水」中，End Date用于本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| End Date | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 可选；不适用时允许留空。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Types；Collection Settlement；Top Up；Internal Transfer In；Funds Released；Fee Reversal；Manual Adjustment Credit；Disbursement；Withdrawal；Internal Transfer Out；Fee；Funds Frozen；Manual Adjustment Debit。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

在「钱包流水」中，Transaction Type用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

背景与用途：这一部分让使用者在钱包流水中能够在「钱包流水」中，Transaction Type用于区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 可选值：All Types；Collection Settlement；Top Up；Internal Transfer In；Funds Released；Fee Reversal；Manual Adjustment Credit；Disbursement；Withdrawal；Internal Transfer Out；Fee；Funds Frozen；Manual Adjustment Debit。 |

业务规则：

- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：查询条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 可选值：全部：不按该条件限制；Credit；Debit。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收支方向

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 可选值：全部：不按该条件限制；Credit；Debit。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：收支方向

在「钱包流水」中，收支方向用于收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。

背景与用途：这一部分让使用者在钱包流水中能够在「钱包流水」中，收支方向用于收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 可选值：全部：不按该条件限制；Credit；Debit。 |

业务规则：

- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易记录

说明「钱包流水」中Date & Time、收支方向、Transaction Type、说明、业务参考号的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在钱包流水中能够说明「钱包流水」中Date & Time、收支方向、Transaction Type、说明、业务参考号的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Date & Time | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 只读展示；无值时显示无记录或不适用。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 变动后余额（Balance After） | 该笔已记账事件发生后的对应余额，与当前最新余额区分。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |
| 每页数量（Rows per page） | 一次显示的记录条数，修改后从第一页按原条件查询。 | 可选值：10；25；50；100。 |

业务规则：

- Date & Time：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。
- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：业务参考号明细表

说明「钱包流水」中Date & Time、收支方向、Transaction Type、说明、业务参考号的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在钱包流水中能够说明「钱包流水」中Date & Time、收支方向、Transaction Type、说明、业务参考号的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Date & Time | 本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。 | 只读展示；无值时显示无记录或不适用。 |
| 收支方向（Direction） | 收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。 | 只读展示；无值时显示无记录或不适用。 |
| Transaction Type | 区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。 | 只读展示；无值时显示无记录或不适用。 |
| 说明（Description） | 帮助识别该业务的文字内容，不代替订单状态或金额。 | 只读展示；无值时显示无记录或不适用。 |
| 业务参考号（Reference） | 追踪当前交易或申请的编号；点击时必须进入同一条业务记录。 | 只读展示；无值时显示无记录或不适用。 |
| 金额（Amount） | 本次业务本金，以 PHP 展示两位小数；手续费与净额分别列明。 | 只读展示；无值时显示无记录或不适用。 |
| 变动后余额（Balance After） | 该笔已记账事件发生后的对应余额，与当前最新余额区分。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- Date & Time：本项对应业务事件的时间，统一按 Asia/Manila 展示；未发生时显示未完成或无记录。
- 收支方向：收入和支出表示该流水方向；冻结转移还需查看三类余额各自变化。
- Transaction Type：区分本记录的业务类别或办理方式；选项以当前已开通范围为准，分类不代表执行结果。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作与下一步

把当前有权查看的记录带出用于核对，导出范围与页面一致。

背景与用途：把当前有权查看的记录带出用于核对，导出范围与页面一致。

业务规则：

- 首版格式为 CSV；沿用当前筛选、商户范围、期间、时区和币种，不自动扩大范围。
- 生成中、可下载、失败、已过期分别表示文件状态，展示创建人、时间和文件有效期。

操作与交互结果：

- 确认范围后生成，在导出记录中查看进度，完成后下载；过期可重新生成。

异常处理：

- 生成失败保留参数方便重试；下载时再次判断权限，不能通过旧链接越权取得数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-webhooks"></a>
## 交易结果通知设置

### 要解决什么问题

设置商户系统接收收款和出款结果的地址。

### 为什么这样设计

商户的对接人员需要自主找到接入参数和调用结果，减少接入排障时反复向运营查询；这里的专业内容服务于接入任务。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 收款通知地址：接收付款结果
- 出款通知地址：接收转账结果
- 收款结果通知地址：为商户系统配置接收交易结果的位置。
- 出款结果通知地址：为商户系统配置接收交易结果的位置。

### 用户如何完成业务

- 核对对应业务的地址后保存

### 业务规则与结果

- 地址设置影响后续通知接收
- 保存地址不会改变已有订单的支付结果
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：收款结果通知地址

为商户系统配置接收交易结果的位置。

背景与用途：为商户系统配置接收交易结果的位置。

业务规则：

- 收款和出款地址分别配置；保存前校验有效的 HTTPS 地址。
- 地址变化只影响后续发送目的地，不改变已有交易结果；已有有效配置不因页面改版自动停用。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 编辑后核对地址并保存；取消恢复原值，保存成功显示新地址和更新时间。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 格式错误就地提示；保存失败保留输入但继续标明当前生效旧地址。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：出款结果通知地址

为商户系统配置接收交易结果的位置。

背景与用途：为商户系统配置接收交易结果的位置。

业务规则：

- 收款和出款地址分别配置；保存前校验有效的 HTTPS 地址。
- 地址变化只影响后续发送目的地，不改变已有交易结果；已有有效配置不因页面改版自动停用。
- 已有有效密钥、通知地址及公开付款链接默认继续有效。需要迁移或停用时明确对象、时间和受影响商户，提供通知和处理路径；页面改版不自动使旧接入失效。

操作与交互结果：

- 编辑后核对地址并保存；取消恢复原值，保存成功显示新地址和更新时间。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 格式错误就地提示；保存失败保留输入但继续标明当前生效旧地址。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易结果通知设置 · 办理流程

为商户系统配置接收交易结果的位置。

背景与用途：为商户系统配置接收交易结果的位置。

业务规则：

- 收款和出款地址分别配置；保存前校验有效的 HTTPS 地址。
- 地址变化只影响后续发送目的地，不改变已有交易结果；已有有效配置不因页面改版自动停用。

操作与交互结果：

- 编辑后核对地址并保存；取消恢复原值，保存成功显示新地址和更新时间。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 格式错误就地提示；保存失败保留输入但继续标明当前生效旧地址。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Callback URL

为商户系统配置接收交易结果的位置。

背景与用途：为商户系统配置接收交易结果的位置。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Callback URL | 与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。 | 必填；未完成时在此字段提示。 |

业务规则：

- 收款和出款地址分别配置；保存前校验有效的 HTTPS 地址。
- 地址变化只影响后续发送目的地，不改变已有交易结果；已有有效配置不因页面改版自动停用。

操作与交互结果：

- 编辑后核对地址并保存；取消恢复原值，保存成功显示新地址和更新时间。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 格式错误就地提示；保存失败保留输入但继续标明当前生效旧地址。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：交易结果通知设置 · 填写资料

在「交易结果通知设置」中，Callback URL用于与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。

背景与用途：这一部分让使用者在交易结果通知设置中能够在「交易结果通知设置」中，Callback URL用于与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Callback URL | 与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。 | 必填；未完成时在此字段提示。 |

业务规则：

- Callback URL：与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Callback URL

在「交易结果通知设置」中，Callback URL用于与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。

背景与用途：在「交易结果通知设置」中，Callback URL用于与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Callback URL | 与当前用途对应的网址或接入地址；访问或保存前检查有效性，变更不自动改写历史业务。 | 必填；未完成时在此字段提示。 |

业务规则：

- 收款和出款地址分别配置；保存前校验有效的 HTTPS 地址。
- 地址变化只影响后续发送目的地，不改变已有交易结果；已有有效配置不因页面改版自动停用。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

状态含义：

- 已送达（Delivered）：商户系统已成功接收通知。
- 重试中（Retrying）：通知仍在尝试发送，交易结果不因此变化。
- 失败（Failed）：本次通知发送未成功，查看原因及最近尝试时间。

异常处理：

- 格式错误就地提示；保存失败保留输入但继续标明当前生效旧地址。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-withdrawal"></a>
## 提现

### 要解决什么问题

将商户可用资金提现到指定收款账户，提交前核对收款方、到账金额和总扣款。

### 为什么这样设计

用户需要区分可支配资金、待处理申请和已入账记录，避免把“已提交”或“已批准”理解为资金已经到账。

### 谁在什么场景使用

有相应权限的商户成员，仅处理当前商户的业务。

### 页面包含哪些内容

- 账户与可用余额：钱从哪里来、到哪里去
- 金额摘要：提现金额、费用和总扣款
- 确认与结果：提交前复核及处理进度
- 读取进度：把商户钱包资金提现到其已保存且符合资格的收款账户。
- 提现 · 业务内容：把商户钱包资金提现到其已保存且符合资格的收款账户。
- 读取失败与重试：把商户钱包资金提现到其已保存且符合资格的收款账户。
- 提现信息：把商户钱包资金提现到其已保存且符合资格的收款账户。
- 金额摘要：使用户在提交或对账时能清楚解释本金、费用和最终金额。
- 提现确认：把商户钱包资金提现到其已保存且符合资格的收款账户。
- 处理结果：把商户钱包资金提现到其已保存且符合资格的收款账户。

### 用户如何完成业务

- 选择可用账户并填写金额
- 确认费用和总扣款后提交
- 查看处理结果

### 业务规则与结果

- 余额不足不能提交；提交成功不等于已经到账。
- 提现使用已保存且符合当前商户提现资格的账户。无可用账户时引导添加并验证，完成后返回原提现流程；不提供未保存的一次性提现账户。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。
- 异常队列显示业务编号、所属商户、已等待时间、最近进展、负责人和下一步。提醒及升级使用该业务配置的服务时效；没有承诺时效时显示处理中和联系入口，不虚构预计到账时间。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

### 特殊情况

- 资料缺失、无权查看或当前状态不允许操作时，说明原因并提供可继续的入口。
- 提交后结果暂不明确时先核对原记录，不把等待或失败显示为成功。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

把商户钱包资金提现到其已保存且符合资格的收款账户。

背景与用途：把商户钱包资金提现到其已保存且符合资格的收款账户。

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。

操作与交互结果：

- 复核收款账户、金额和手续费，完成所需验证后提交；在详情跟进申请结果。

状态含义：

- 待审批（Pending Approval）：提现申请等待独立复核。
- 处理中（Processing）：已经进入执行，不能直接取消。
- 成功（Succeeded）：本次提现完成，显示完成时间。
- 失败（Failed）：执行未成功，跟进实际预留资金的释放或其他处理结果。
- 已取消：仅在明确尚未执行且允许撤销时成立，保留申请历史。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：提现 · 业务内容

把商户钱包资金提现到其已保存且符合资格的收款账户。

背景与用途：把商户钱包资金提现到其已保存且符合资格的收款账户。

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。

操作与交互结果：

- 复核收款账户、金额和手续费，完成所需验证后提交；在详情跟进申请结果。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

把商户钱包资金提现到其已保存且符合资格的收款账户。

背景与用途：把商户钱包资金提现到其已保存且符合资格的收款账户。

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。

操作与交互结果：

- 复核收款账户、金额和手续费，完成所需验证后提交；在详情跟进申请结果。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：提现信息

把商户钱包资金提现到其已保存且符合资格的收款账户。

背景与用途：把商户钱包资金提现到其已保存且符合资格的收款账户。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Withdrawal Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。
- 提现使用已保存且符合当前商户提现资格的账户。无可用账户时引导添加并验证，完成后返回原提现流程；不提供未保存的一次性提现账户。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。

操作与交互结果：

- 复核收款账户、金额和手续费，完成所需验证后提交；在详情跟进申请结果。

状态含义：

- 待审批（Pending Approval）：提现申请等待独立复核。
- 处理中（Processing）：已经进入执行，不能直接取消。
- 成功（Succeeded）：本次提现完成，显示完成时间。
- 失败（Failed）：执行未成功，跟进实际预留资金的释放或其他处理结果。
- 已取消：仅在明确尚未执行且允许撤销时成立，保留申请历史。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：提现 · 填写与确认

将商户可用资金提现到指定收款账户，提交前核对收款方、到账金额和总扣款。 本区域展示money-field，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在提现中能够将商户可用资金提现到指定收款账户，提交前核对收款方、到账金额和总扣款。 本区域展示money-field，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 余额不足不能提交；提交成功不等于已经到账。

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Withdrawal Amount

在「提现」中，Withdrawal Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

背景与用途：在「提现」中，Withdrawal Amount用于本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Withdrawal Amount | 本项标明的资金金额，以 PHP 保留两位小数；与手续费、总扣款或实际到账结果分别说明。 | 可选；不适用时允许留空。 |

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：金额摘要

使用户在提交或对账时能清楚解释本金、费用和最终金额。

背景与用途：使用户在提交或对账时能清楚解释本金、费用和最终金额。

业务规则：

- 本金、手续费和总额分别展示，币种为 PHP；不得把手续费再计入本金。
- 转出总扣款为本金加适用费用；收款净额按实际收款和费用事实计算。
- 报价在金额、方式或有效期变化后失效，需重新展示并确认；历史费用保持交易时规则。
- 首版交付 PHP，所有金额明确币种，金额保留两位小数。不同币种不混合汇总；本期不增加多币种切换。
- 费率、额度、文件有效期和服务时效采用按业务及商户生效的配置，标明适用范围和生效时间。必需计费或限额缺失时，资金提交不可用并明确原因；技术无需猜测生产数值，演示金额不作为正式参数。

操作与交互结果：

- 逐项核对金额后确认；点击费用或相关记录可追溯计算依据。

异常处理：

- 费用配置缺失或报价失效时禁止资金确认；失败订单不伪造最终到账净额。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：提现确认

把商户钱包资金提现到其已保存且符合资格的收款账户。

背景与用途：把商户钱包资金提现到其已保存且符合资格的收款账户。

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。
- 提现使用已保存且符合当前商户提现资格的账户。无可用账户时引导添加并验证，完成后返回原提现流程；不提供未保存的一次性提现账户。
- 未付款充值申请可取消或按展示的有效期到期；已付款申请继续核实。提现仅在明确尚未开始执行且允许撤销的阶段可取消；结果未知或执行中不提供直接取消，先核对实际资金结果。

操作与交互结果：

- 复核收款账户、金额和手续费，完成所需验证后提交；在详情跟进申请结果。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：处理结果

把商户钱包资金提现到其已保存且符合资格的收款账户。

背景与用途：把商户钱包资金提现到其已保存且符合资格的收款账户。

业务规则：

- 先选择合格账户，再填写金额；总扣款为本金加费用，不能超过可用额度和余额。
- 无账户先添加并验证，返回原提现流程；未保存的一次性账户不提供提现。
- 提交、复核、执行和到账分开显示；申请人不可自行复核。

操作与交互结果：

- 复核收款账户、金额和手续费，完成所需验证后提交；在详情跟进申请结果。

异常处理：

- 报价变化重新确认；正在执行或结果未知时先查询，不能直接取消或重复提交。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Account password

帮助商户完成系统接入并管理凭据使用。

背景与用途：帮助商户完成系统接入并管理凭据使用。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Account password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |
| Email verification code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 日常显示商户标识、密钥标识、状态及创建时间。
- 完整密钥仅生成时展示一次；更换前说明旧凭据失效范围。

操作与交互结果：

- 有权限的人员完成身份验证，确认更换后复制并妥善保存新密钥。

异常处理：

- 验证失败不能显示或更换密钥；更换结果未知先查询状态，不连续生成多套凭据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号密码

在「提现」中，Account password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

背景与用途：在「提现」中，Account password用于此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Account password | 此用途的账号密码；默认隐藏，输入仅用于本人验证，不进入普通记录或日志。 | 可选；不适用时允许留空。 |

业务规则：

- 邮箱作为唯一登录标识并用于账号验证；密码输入默认隐藏，不写入提示或操作记录。
- 注册需要确认密码一致并同意正式条款；改密时先验证当前账号。
- 主动改密保留已验证当前设备、退出其他设备；忘记密码重置后全部旧登录失效。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误凭据不进入工作区；连续失败按现行安全策略提示验证或稍后重试，不虚构固定等待数值。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：Email verification code

在「提现」中，Email verification code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

背景与用途：在「提现」中，Email verification code用于当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| Email verification code | 当前用途验证码，按现行验证服务校验；错误、过期和超限分别提示。 | 可选；不适用时允许留空。 |

业务规则：

- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-audit-logs"></a>
## 商户操作记录

### 要解决什么问题

追溯当前商户成员对账户和业务所做的操作，了解谁在何时修改了什么。

### 为什么这样设计

商户需要知道谁能访问自己的业务、资料是否准确以及谁做过修改；日常资料和认证资料分清，才能避免误改。

### 谁在什么场景使用

有操作记录查看权限的商户成员。

### 页面包含哪些内容

- 操作列表：操作人、时间、动作、目标及结果
- 查询条件：查找需要核对的操作
- 读取进度：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 读取失败与重试：准确说明当前是否已取得结果，以及用户下一步能做什么。
- 账号操作记录：让授权人员追溯谁在什么时候对什么对象做了什么。
- 查询条件：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 搜索与筛选：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。
- 商户操作记录 · 业务内容：准确说明当前是否已取得结果，以及用户下一步能做什么。

### 用户如何完成业务

- 按条件查找操作并核对结果

### 业务规则与结果

- 操作记录不改变业务状态；敏感密码和密钥不进入普通记录

### 特殊情况

- 无记录、查询无结果和读取失败分别提示。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：读取进度

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：读取失败与重试

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：账号操作记录

让授权人员追溯谁在什么时候对什么对象做了什么。

背景与用途：让授权人员追溯谁在什么时候对什么对象做了什么。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| From | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| To | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| User | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| Module | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 记录时间、操作者、动作、业务对象、所属商户和处理结果。
- 敏感值脱敏，历史记录只读；失败操作与成功操作区分。

操作与交互结果：

- 按人员、时间或动作查找，进入有权访问的相关对象核对。

异常处理：

- 没有记录显示暂无操作；读取失败保留条件并允许重试。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：查询条件

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| From | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| To | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |
| User | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选值：All Users。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 可选值：All Actions。 |

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：From

在「商户操作记录」中，From用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在商户操作记录中能够在「商户操作记录」中，From用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| From | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- From：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：To

在「商户操作记录」中，To用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

背景与用途：这一部分让使用者在商户操作记录中能够在「商户操作记录」中，To用于说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| To | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 可选；不适用时允许留空。 |

业务规则：

- To：说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：User

在「商户操作记录」中，User用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

背景与用途：这一部分让使用者在商户操作记录中能够在「商户操作记录」中，User用于识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| User | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 可选值：All Users。 |

业务规则：

- User：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：操作

在「商户操作记录」中，操作用于针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。

背景与用途：这一部分让使用者在商户操作记录中能够在「商户操作记录」中，操作用于针对这一行记录可执行的动作；点击前检查该记录状态与本人权限，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 可选值：All Actions。 |

业务规则：

- 操作：针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。

操作与交互结果：

- 填写或选择本字段后继续当前表单；字段修改不代表整份业务已经提交。
- 提交时如有错误，在本字段旁显示原因并保留其他已填内容。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：搜索与筛选

缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

背景与用途：缩小当前业务列表或统计的范围，帮助用户找到需要核对的记录。

业务规则：

- 多个不同条件同时生效；未填写的可选条件不限制结果。
- 起止日期使用 Asia/Manila，开始不能晚于结束；金额下限不能超过上限。
- 查询只改变显示范围，不改变订单或资金状态。

操作与交互结果：

- 填写条件后应用，汇总与明细按同一条件刷新；重置恢复默认范围，进入详情后返回保留条件。

异常处理：

- 查询失败保留条件和上次成功结果并注明未更新；无结果提示调整条件，不跳回无关数据。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户操作记录明细表

说明「商户操作记录」中日期、User、操作、Module的用途，便于填写、查找或核对当前记录。

背景与用途：这一部分让使用者在商户操作记录中能够说明「商户操作记录」中日期、User、操作、Module的用途，便于填写、查找或核对当前记录，减少误读和重复操作。

| 页面字段 | 含义 | 取值与使用规则 |
| --- | --- | --- |
| 日期（Date） | 当前业务使用的日期范围；统一使用 Asia/Manila。 | 只读展示；无值时显示无记录或不适用。 |
| User | 识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。 | 只读展示；无值时显示无记录或不适用。 |
| 操作（Action） | 针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。 | 只读展示；无值时显示无记录或不适用。 |
| Module | 说明本项在当前业务对象中的实际信息；保留其原始业务含义，缺失时明确显示无记录，不使用示例值代替。 | 只读展示；无值时显示无记录或不适用。 |

业务规则：

- 日期：当前业务使用的日期范围；统一使用 Asia/Manila。
- User：识别当前业务相关的人员、商户或门店；保持与本条记录归属一致，权限不因显示名称而扩大。
- 操作：针对这一行记录可执行的动作；点击前检查该记录状态与本人权限。
- 每行对应一条独立业务记录；列标题与详情字段使用相同含义。
- 金额、状态、时间和归属商户来自同一记录；不拼接其他订单的值。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 先用本页筛选找到记录，再核对本行编号、金额和状态。
- 点击本行查看进入同一记录详情；返回后保留筛选与页码。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：商户操作记录 · 业务内容

准确说明当前是否已取得结果，以及用户下一步能做什么。

背景与用途：准确说明当前是否已取得结果，以及用户下一步能做什么。

业务规则：

- 正在读取、没有记录、没有权限、业务失败和结果未知分别表达。
- 成功只有在实际业务已完成时展示；审批通过或请求已收到不能当作到账成功。

操作与交互结果：

- 按提示重试读取、修改条件、补充资料或返回列表；资金结果未知时先查询原申请。

异常处理：

- 失败不得显示成零余额、空交易或成功；不使用其他对象替代未找到的记录。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：功能导航

在当前工作区内进入需要办理的业务。

背景与用途：在当前工作区内进入需要办理的业务。

业务规则：

- 商户后台保持当前商户身份；管理后台的跨商户查询仍受角色权限限制。
- 只显示可访问模块，当前模块有明确选中状态；展开菜单不提交业务。

操作与交互结果：

- 点击菜单进入对应页面；离开未保存表单时提醒保存或放弃，取消离开保留输入。

异常处理：

- 目标不可访问时说明原因并保留可返回的导航，不能跳到另一商户替代。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：当前商户

让用户确认现在查看和操作的是哪家商户。

背景与用途：让用户确认现在查看和操作的是哪家商户。

业务规则：

- 展示商户名称、标识及账户状态；门店不是商户身份。
- 可在我的商户中切换本人未停用且状态允许登录的商户；切换后换发会话并刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

操作与交互结果：

- 身份信息随合法工作区变化更新，页面内所有业务数据保持一致。

异常处理：

- 无门店不虚构默认门店；身份读取失败时暂停依赖该身份的资金操作。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

<a id="product-merchant-auth-verification"></a>
## 登录身份验证

### 要解决什么问题

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。

### 为什么这样设计

先确认账号归属再开放业务，避免他人看到商户资料或操作资金；验证失败时仍应让本人知道如何恢复使用。

### 谁在什么场景使用

正在登录的商户成员。

### 页面包含哪些内容

- 邮箱验证码：通过业务邮箱验证身份
- 身份验证器：已绑定用户可使用的验证方式
- 登录身份验证 · 业务内容：在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Verify your identity，用于确认当前业务内容及下一步。
- 登录身份验证 · 业务内容：在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Enter your authenticator code，用于确认当前业务内容及下一步。
- 登录身份验证 · 信息区域：在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示登录身份验证 · 信息区域，用于确认当前业务内容及下一步。

### 用户如何完成业务

- 输入验证码完成验证
- 按可用入口切换验证方式或返回登录

### 业务规则与结果

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区
- 验证码错误或过期应提示重试或重新获取

### 特殊情况

- 凭据或验证码错误时提示重新输入；验证码失效时提示重新获取。
- 验证过程中禁用重复提交；失败后保留重新验证或返回登录的入口。

### 验收看什么结果

- 用户能够识别本页对象、可用功能、业务状态及下一步入口。
- 本页各区块的字段、状态、成功结果和异常结果按下面的独立说明逐项验收。

### 权限与使用条件

- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 认证未完成仍可进入工作区，查看已授权信息、认证进度和缺失资料；受限操作展示具体原因及继续认证入口，不把账户建立当作业务已开通。
- 查看订单、导出、查看钱包和操作资金分别授权；父商户身份不自动取得子商户资金权限。所有记录清楚标出所属商户。

### 区块：登录身份验证 · 业务内容

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Verify your identity，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在登录身份验证中能够在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Verify your identity，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 业务内容

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Masked email，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在登录身份验证中能够在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Masked email，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 填写与确认

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 信息区域

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示登录身份验证 · 信息区域，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在登录身份验证中能够在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示登录身份验证 · 信息区域，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 业务内容

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Enter your authenticator code，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在登录身份验证中能够在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Enter your authenticator code，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 填写与确认

证明当前操作由账号本人发起，避免验证码被用于错误用途。

背景与用途：证明当前操作由账号本人发起，避免验证码被用于错误用途。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 显示脱敏接收邮箱或已绑定验证器提示，验证码只用于当前指定操作。
- 验证码有效期、重发等待和尝试限制沿用现行验证服务策略；页面展示实际剩余时间。
- 验证码验证成功不等于资金业务已完成。

操作与交互结果：

- 输入当前验证码提交；重发时按提示等待；返回可修改允许修改的信息。

异常处理：

- 错误、过期、超限和发送失败分别说明下一步；重发后不能把旧验证码当作仍有效。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 信息区域

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示登录身份验证 · 信息区域，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在登录身份验证中能够在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示登录身份验证 · 信息区域，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

### 区块：登录身份验证 · 办理入口

在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Back to login，用于确认当前业务内容及下一步。

背景与用途：这一部分让使用者在登录身份验证中能够在登录邮箱和密码通过后，完成第二步验证以保护商户账号。 本区域展示Back to login，用于确认当前业务内容及下一步，减少误读和重复操作。

业务规则：

- 门户账号只用邮箱登录，密码后完成独立 Email OTP 或 TOTP；与管理端账号、JWT、OTP/TOTP 和密钥隔离，管理端用户名保持不变。
- 一人可属于多商户，每个商户一条成员关系及一个角色。登录优先选择上次仍可登录的商户，否则按成员 ID 升序选第一家；切换时重新检查商户和成员状态，并换发会话、刷新权限。
- 成员未停用且商户为 PENDING_KYB、ACTIVE 或 FROZEN 时可登录和切换；NOT_ACTIVATION、SUSPENDED、CLOSED 禁止进入和切换。暂停或关闭只使该商户会话失效，不影响同一用户的其他商户。
- 未完成第二步验证不能进入商户工作区

操作与交互结果：

- 查看本区域当前内容；填写项完成后通过对应确认操作保存，取消不改变生效记录。

异常处理：

- 读取失败保留可恢复入口，不显示为成功或假零值。
- 当前对象无权限时不展示敏感字段，保留返回入口。

验收结果：

- 显示字段与当前对象一致；操作结果、失败提示和返回路径满足本区域规则。

## 产品与技术的协作边界

- 产品负责明确用户、业务目标、范围、内容、操作条件及可观察结果。
- 技术团队决定实现方案，并说明可行性、成本和取舍；实现方式变化不自动改变业务结果。
- 已有工程说明、原型代码或示例契约用于理解和追溯，不默认成为本次指定的实现方案。
- 正式费率、额度、时效、客服及协议正文读取生效业务资料；缺少必要配置时按本页明确的不可用行为处理，不使用演示参数替代。

