break
370fd3e67f
4.8 KiB
Purpose
管理实际收款商户、商户池轮询和全局微信授权配置，使新线上支付的收款身份可冻结、历史支付可继续使用其原商户，并避免凭证泄露或无配置时静默回退。
ADDED Requirements
Requirement: 商户与微信授权配置管理
系统 SHALL 将实际收款商户与微信授权配置分离。一个商户 MUST 仅对应 wechat 或 alipay 一种支付方式，并保存名称、支付方式、服务商类型、商户号或应用标识、敏感凭证、状态和备注；微信直连与富友均为微信支付商户。平台最多存在一个启用的微信授权配置，该配置保存 C 端公众号 H5/JSSDK、小程序登录所需参数，C 端微信登录、OpenID 和微信支付 AppID MUST 只读取该配置。
超级管理员和平台用户可创建、编辑、启用、停用商户、商户池和微信授权配置，其他角色无管理入口。被支付单引用的商户 MUST NOT 删除且其支付方式、服务商类型、商户号/应用标识不得修改；未被引用商户仅可移出所有商户池并经二次确认删除。停用只影响新支付单，历史支付的回调、查单和原路退款仍使用该商户当前凭证。管理 API 可向上述已认证管理角色返回完整凭证，但日志、审计快照、错误和普通业务响应 MUST NOT 保存或返回敏感凭证。
Scenario: 受引用商户停用
- WHEN 管理员停用已被支付单命中的商户
- THEN 新支付单不再选择该商户，已命中支付单的回调、查询和原路退款仍按该商户处理
Scenario: 非管理角色读取配置
- WHEN 不具备超级管理员或平台用户身份的账号请求商户或微信授权配置
- THEN 系统拒绝访问且不返回任何凭证或身份字段
Requirement: 商户池唯一性与轮询配置
系统 SHALL 为每种支付方式最多启用一个商户池；停用历史池可保留，但不得同时启用多个同支付方式池。商户池成员支付方式 MUST 与池一致，成员按明确顺序排列；金额/笔数方式必须配置 每轮累计、自然日累计 或 自然月累计 统计周期，时间方式必须配置最小为 1 分钟的数值、单位和起始时间。
金额和笔数轮询只统计已确认支付成功结果，不在预下单时预占，也不因退款回冲。达到阈值的成员在当前周期跳过；所有成员达到阈值时新支付失败。时间轮询自起始时间按固定时段和成员顺序选择，成员停用即时跳下一个可用成员但不重置时段。预下单失败不得自动切换或重试，失败单不计入统计；客户再次发起时重新选择。修改阈值保留当前统计，修改统计周期、金额/笔数方式、时间周期、起始时间或每轮排序按 PRD 规则开启新周期；自然周期排序调整保留未移除成员累计。
Scenario: 并发预下单未预占额度
- WHEN 多个客户并发创建金额或笔数轮询支付单且当前成员尚未达到阈值
- THEN 系统可使这些支付单均命中当前成员，只有后续确认成功的支付才计入累计，已创建支付单不因轮询切换改挂商户
Scenario: 当期没有可用商户
- WHEN 启用商户池中不存在启用且未达阈值的成员，或商户池已停用
- THEN 系统拒绝创建新支付单并提示暂无可用商户，不回退到旧综合支付配置
Requirement: 新支付商户快照与历史兼容
C 端套餐购买、C 端资产钱包充值及代理在线预存款充值 SHALL 按支付方式通过对应启用商户池选择实际商户；后台线下订单和钱包余额支付 MUST NOT 经过商户池。每笔通过商户池创建的支付单 MUST 保存商户 ID、商户名称/支付方式/服务商类型/商户号或应用标识快照、商户池 ID/名称快照及轮询方式快照，但不得复制敏感凭证。支付、回调验签、查单和原路退款读取该实际商户当前凭证；商户退款能力只由服务商类型和退款必需凭证完整性决定，不提供人工开关。
上线迁移 MUST 从当前生效综合支付配置复制完整凭证：创建全局微信授权配置、微信/支付宝商户和各自单成员启用池。凭证不完整的方式不建池；迁移仅在数据库复制敏感数据。新订单必须只走商户池；旧配置和其历史订单不改写，继续服务历史回调、查询和退款。
Scenario: 新支付冻结实际商户
- WHEN 客户以微信或支付宝创建覆盖范围内的新线上支付单
- THEN 系统选择并冻结一个实际商户和商户池路由快照，并使用该商户的服务商凭证发起支付
Scenario: 旧支付单回调
- WHEN 商户池切换后收到未带新商户快照的历史支付单回调
- THEN 系统按既有综合支付配置兼容处理该历史单，不将其改挂到任何新商户