9.17-驳回处理闭环与交易体验收口

1. 背景与目标

1.1 业务背景与问题

三端通用

1. 失败/错误原因泄露通道品牌。失败原因、错误原因、驳回原因文本直接透出易宝、易宝国际、yeepay、PingPong 及其大小写变体，能从页面文案推断内部通道路由；此前敏感词过滤只覆盖驳回原因，失败与错误原因未治理。
2. 交易查询无导出、维度不足。三端来帐、付款、提现、换汇四个交易查询均无导出，统计靠截图手抄；来帐无 VA 所属地区，付款/提现无清分方式、汇率、到账银行所在地区、商户费率，对账缺维度。

商户平台

1. 驳回订单不可见、不可处理、无主动提醒。在入金订单看不到被驳回后订单的状态与驳回原因，除来账通知外，被驳回、入账成功、发起退款关键节点均未通知用户。
2. B2B 结汇订单缺申报凭证自助下载。平台已从通道收集「国际收支申报单」（报关明细文件），商户在提现订单明细无法自行下载，只能找运营转发；API 商户也无下载接口。
3. 合同列表缺买方与结汇维度。列表无「买方名称」列与筛选，无法按买方定位合同；「是否结汇」展示与筛选口径需一并回归确认。
4. 合同上传格式受限。仅支持 jpg/jpeg/png/pdf，zip、rar、7z 压缩包要拆包逐份重传。
5. 「我的账户」详情字段不全、复制不便。商户付款/提现填写收款行信息时要从账户详情复制行内容，展示字段缺开户行要素，全部复制也未按显示名输出，核对与填写都费劲。
6. 交易密码输错与锁定的提示不可用。验密输错只提示「密码错误」，不提示还剩几次；连续输错超限后只有笼统锁定提示，没有解锁路径；重置密码后锁定也不自动解除，商户被卡在资金操作外。
7. 退款完成拿不到退款证明。退款到账后商户做账、对账需要退款凭证，页面没有下载入口，只能找运营要。
8. 电商店铺信息录错无法修改、不用了无法删除。店铺列表只支持新增与绑定收款账户，填错只能重建，废弃店铺越积越多。

代理商平台

1. 名下商户驳回不同步。来帐列表看不到驳回状态与原因，业务员无法主动辅导商户补资料。
2. 拓展被默认结算价门禁阻断。出示邀请链接、单机构设结算价、机构服务商注册在「默认结算价未配置」时均被拦。

运营平台

1. 驳回不同步到运营端。「来帐管理」看不到驳回状态与原因，跟进处置要跨系统核对。
2. 费率审核与修改记录字段不全。记录详情缺变更前后值、审核与生效信息等字段，核对要跨页面拼凑。

1.2 目标与成功标准

1.3 不做的影响

不上线：通道品牌继续透出、路由可被推断；申报单仍靠运营转发；驳回仍不可见不可处理，代理/运营无法跟进；拓展继续被门禁拦；关键节点仍无通知；压缩包合同仍要拆包；交易统计仍靠手工；费率核对仍跨页面拼凑；账户信息复制仍费劲、换汇输错密码仍无解锁指引、退款证明仍要找运营、店铺录错仍无法修正。

2. 用户角色与场景

2.1 角色、权限与职责

2.2 核心业务场景

3. 功能范围

3.1 能力清单与发布状态

3.2 In Scope / Out of Scope

3.3 未决项与准入门槛

4. 页面/交互说明

4.1 F-01 通道品牌词过滤（三端全局）

交互：无新增页面；作用于三端已有的原因展示位——来帐/入金、付款、提现、换汇、合同列表的原因列、「查看原因」弹窗、订单详情、结果提示；开放平台对外接口的错误文案同策略过滤。

术语：「失败原因/错误原因/驳回原因」按各页面既有标签展示，不改名；过滤规则一致。

4.2 F-02 B2B 结汇订单下载国际收支申报单（报关明细文件）

入口：商户平台「提现订单」操作列与订单详情，按钮文案「申报单」；付款订单不展示（申报单仅随提现结汇链路收集）。文件业务名称统一「国际收支申报单」，下载文件名「国际收支申报单.pdf」。

4.3 F-03 合同管理列表字段增强

入口：商户平台「订单 → 合同订单」列表。性质标注：[新增列] 本批次新增展示列；[新增筛选] 本批次新增筛选项；[新增能力] 本批次新功能。

币种/申报模式筛选为 2026-08-31 审计补充项；「业务模式」为商户自身 KYC 属性（每户固定），不列展示。

4.4 F-04 商户平台入金/合同订单驳回展示 + 驳回原因聚合

入口：商户平台「入金订单」「合同订单」列表。

flowchart LR
    START((入金到账))

    START -->|贸易来帐| P[待关联]
    START -->|同名充值/平台收款| S[需补充材料]
    START -->|无需关联| DS[直接成功]

    P -->|提交关联合同| R[审核中]
    S -->|补充材料提交审核| R
    DS -.->|主动关联合同·获取结汇额度| R

    R -->|审核通过·入账| E[已入账]
    R -.->|审核不通过| RJ[驳回]

    RJ -.->|重新提交·按驳回环节| R
    RJ -->|选择退款| RF[退款处理中]
    E -->|退款申请 / 通道退汇| RF
    RF -->|退款完成| RD[已退款]

    style RJ fill:#fdecec,stroke:#e5484d,color:#c53030
    style E fill:#e6f6ef,stroke:#00a870
    style RD fill:#e6f6ef,stroke:#00a870

入金订单完整状态机——三个初始态（待关联/需补充材料/直接成功）同级并列；只有「审核中」会向下一步流转：审核通过即入账，或不通过落驳回；驳回后可重新提交再次进入审核中，也可直接选择退款；最终结果节点两个：「已入账」与「已退款」（绿色）。「入账失败」为通道异常态（联系归属业务员核实），不参与主流程结果；「部分退款」暂不支持，已移除。 合同订单状态机（沿用，本批次不改；驳回后的「重新关联合同」动作发生在入金订单侧，见上图）：

stateDiagram-v2
    direction LR
    state "待提交" as Init
    state "待审核" as Audit
    state "审核通过" as Approved
    state "驳回（Returned）" as Rejected
    state "已完成" as Closed

    [*] --> Init: 创建合同
    Init --> Audit: 提交
    Audit --> Approved: 审核通过
    Audit --> Rejected: 审核不通过
    Rejected --> Audit: 编辑后重新提交（既有）
    Approved --> Closed: 履约完成
    Closed --> [*]

驳回环节的具体处理（「查看原因」弹窗与操作入口共用的环节口径）：

• 资料审核——审核方核对商户提交的补充材料（付款凭证、账户所属证明等）与来账资金的一致性；被驳回后商户在「补充资料」弹窗更新或重传材料并重新提交，重新进入资料审核。
• 合同关联——审核方核对本次提交的每个合同与来账资金的匹配性（金额、买方、贸易背景），一次提交多个合同时逐个出关联结果；被驳回后商户重新打开关联合同弹窗，更换或调整所关联的合同再提交。

4.5 F-05 入金订单驳回状态同步代理商/运营平台（三端贯通）

触发：入金订单被驳回（补充材料/合同关联）并落为「驳回」后，同步至代理商平台与运营平台。

共用规则（两端一致）：

代理商平台「入金交易查询」：

运营平台「来帐管理」：

4.6 F-06 默认结算价不设门禁

4.7 F-07 商户平台首页驳回订单提醒弹窗

入口：商户平台首页，进入自动查询，无独立菜单。

4.8 F-08 交易状态邮件通知（来帐到账 / 驳回 / 入账成功 / 退款）

触发：来帐状态落入四类事件时逐笔触发一次——来帐到账、订单驳回、入账成功、退款（含部分与全额）；同一事件只通知一次。

邮件正文模板（全事件）

① 来帐到账　主题：【御风科技】入金到账通知：{币种} {金额}（单号 {单号}）

尊敬的 {商户名称}： 您有一笔入金已到账，明细如下：

• 入金单号：{单号}
• 付款方：{付款方名称}
• 付款币种/金额：{币种} {金额}
• 到账时间：{到账时间}
• 当前状态：{当前状态}

请按当前状态处理：

• 待关联（贸易来帐）：请登录商户平台「入金订单」及时关联合同；
• 需补充材料（同名充值/平台收款）：请登录「入金订单」补充付款凭证等材料，审核通过后完成入账；
• 直接成功：资金已直接入账，可登录「入金订单」关联合同以获取结汇额度。 如有疑问，请联系您的归属业务员。 —— 御风科技

② 订单驳回　主题：【御风科技】订单驳回通知：{单号}

尊敬的 {商户名称}： 您的一笔入金订单未通过审核、已被驳回，明细如下：

• 入金单号：{单号}
• 驳回环节：{驳回环节：资料审核 / 合同关联}
• 驳回时间：{驳回时间}
• 驳回原因：{驳回原因（已经品牌词过滤）}

请按驳回环节处理：资料审核驳回 → 登录「入金订单」补充资料后重新提交；合同关联驳回 → 重新关联合同。也可在订单列表直接选择退款。处理完成前订单无法继续流转。 —— 御风科技

③ 补充资料审核成功　主题：【御风科技】补充资料审核成功通知：{单号}

尊敬的 {商户名称}： 您为入金订单提交的补充资料已审核通过，资金完成入账，明细如下：

• 入金单号：{单号}
• 入账金额：{币种} {金额}
• 入账时间：{入账时间}

资金已入账；如需办理结汇，可登录商户平台「入金订单」关联合同以获取结汇额度。 —— 御风科技

④ 关联合同审核成功　主题：【御风科技】关联合同审核成功通知：{单号}

尊敬的 {商户名称}： 您为入金订单关联合同的申请已审核通过，资金完成入账，明细如下：

• 入金单号：{单号}
• 关联合同：{合同编号}
• 入账金额：{币种} {金额}
• 入账时间：{入账时间}

可登录商户平台「入金订单」查看详情并下载相关凭证。 —— 御风科技

⑤ 退款　主题：【御风科技】退款通知：{单号}

尊敬的 {商户名称}： 您的一笔入金订单已发起退款，明细如下：

• 入金单号：{单号}
• 退款金额：{币种} {金额}
• 退款时间：{退款时间}

退款将原路退回付款方账户，到账时间以付款银行为准。可登录商户平台「入金订单」查看退款进度。 —— 御风科技

4.9 F-09 合同文件上传支持 zip、rar、7z

入口：商户平台全部合同上传位——合同创建「交易合同」「CI&PI 发票」，入金「关联合同」「补充资料」附件位。

4.10 F-10 交易查询导出与字段增强

范围：商户平台、代理商平台、运营平台三端的四个交易查询——入金交易、付款、提现、换汇。

4.11 F-11 费率审核、修改记录展示全部字段

入口：代理商平台与运营平台费率审核、修改记录页（列表 + 详情）。

记录表存在上述清单之外的业务字段时一并展示，不做白名单裁剪。

4.12 F-12 我的账户详情优化

商户端「账户 → 我的账户」——新展示字段：

全部复制：所有内容包括参数名均使用显示名（英文）。 单行复制：保持原逻辑，仅复制值内容。

4.13 F-13 交易密码错误提示与锁定解锁优化

入口：商户平台资金操作验密环节（进入付款/提现/换汇页面时校验交易密码）与「我的 → 账号与安全 → 重置交易密码」。进入页面即验密、默认密码校验与引导弹窗均为既有实现，本批次不改；本节只覆盖以下新增三点。

4.14 F-14 退款证明文件下载

入口：商户平台「入金订单」列表操作列与订单详情，按钮文案「退款证明」。文件业务名称「退款证明」，下载文件名「退款证明.pdf」。

4.15 F-15 电商店铺数据维护（修改、删除）

入口：商户平台「账户 → 电商店铺」列表操作列，「编辑」「删除」按钮（与既有「绑定账号」并列）。

5. 字段说明

5.1 关键业务字段

5.2 选项与字典

研发口径索引：驳回原因/时间的存储字段、导出任务方式属关联研发设计，不改变本正文业务结论；仅当其影响用户可见结果时以本正文口径为准。

6. 业务状态与服务支撑

6.1 业务状态

入金订单全状态（三端统一 9 值，R-36）：

驳回不是终态：重新操作后沿既有流程流转——贸易来帐重新关联合同（进入审核中）；同名充值/平台收款回「需补充材料」重新补充（提交后进入「审核中」，审核通过即入账，入账后可再关联合同）；再被驳回则回「驳回」并新增一条记录（R-29）；驳回后也可直接选择退款（进入退款处理中，退款完成为「已退款」）。状态变更同时触发邮件通知（F-08）。 驳回不拆分：驳回为单一状态，环节与原因差异由驳回记录（时间/环节/原因）承载，操作入口按最新环节给出（R-30）。

入金订单（待关联 / 需补充材料 / 审核中 …）
   │ 资料审核不通过 / 合同关联被驳回
   ▼
驳回（可处理态，记录：驳回时间 + 驳回环节 + 驳回原因[已过滤]）
   ├─→ 商户平台列表：「驳回」(红) +「查看原因」聚合弹窗 + 按环节操作入口
   ├─→ 商户平台首页：自动查询 → 弹窗提醒（F-07）
   ├─→ 代理商平台 / 运营平台：来帐列表同状态 + 原因弹窗（R-39 一致性）
   └─→ 交易状态邮件通知：商户 + 归属业务员（F-08，事件=订单驳回）
   出口：重新提交回「审核中」（资料审核驳回经「需补充材料」）；或直接选择退款 → 退款处理中 → 已退款

合同订单状态（沿用）：待提交 / 待审核 / 审核通过 / 驳回（Returned）/ 已完成；驳回后既有动作：可编辑并重新提交，或重新关联合同。首页提醒对合同驳回与列表同口径。

B2B 申报单文件（F-02，仅提现订单）：入口按 R-09 展示；结汇成功即可点击下载——点击后查询是否已生成，未生成时提示「申报单尚未生成，请稍后再试」；已生成时触发下载文件。

交易状态邮件事件（F-08）：入金到账 / 订单驳回 / 补充资料审核成功 / 关联合同审核成功 / 退款，逐事件一次。

默认结算价配置状态（F-06）：已配置 / 未配置，仅作「机构拓展」页展示，不拦截任何动作。

交易密码锁定状态（F-13）：正常 ⇄ 已锁定——连续输错达上限进入锁定（阈值沿用系统既有口径）；重置交易密码成功即解除锁定并清零错误计数，无需等待或人工处理；锁定仅影响付款/提现/换汇的验密环节，不影响登录。

退款证明文件（F-14）：入口按 R-81 展示；点击时查询生成状态——已生成 → 下载「退款证明.pdf」；未生成 → 提示「退款证明生成中，请稍后重试」，不改订单状态。

电商店铺（F-15）：编辑保存即时生效；删除仅限未被合同关联的店铺，二次确认后逻辑删除并解除绑定收款账户，操作留痕。

6.2 关联研发设计

• 品牌词过滤词库存储与维护、过滤执行位置（服务端返回前）。
• 申报单下载契约（受控下载）、开放平台下载契约。
• 驳回记录（时间/环节/原因）数据结构与聚合查询；三端同步机制（最终一致保障，R-39）。
• 交易查询导出任务方式与单次上限；压缩包上传服务端校验。
• 交易状态邮件通道接入、模板渲染、双收件人发送与重试。
• 我的账户详情字段返回与展示契约（非必填字段有值才显示、Sort Code 按账户所属国家判定）。
• 交易密码错误计数、锁定与重置解锁联动。
• 退款证明文件生成、存储与受控下载契约。
• 电商店铺编辑保存、删除约束（合同关联校验）、逻辑删除与留痕。

7. 异常/边界/权限

8. 验收标准

格式：前置 → 动作 → 预期，可执行可核对。原型锚点为对应页面/mock 场景。