# M05-A 统一支付领域

- 日期：2026-06-20
- 起始 commit：`f9ec0af`
- 工程 commit：`6c506ff`
- ENGINEERING_DELTA=YES
- 子阶段状态：DONE，已 push 且 `HEAD == origin/main`

## 工程增量

- 建立支付单、支付尝试、回调、退款单、分账单和分层支付配置模型。
- 支付金额只取订单服务端未付金额，客户端金额字段被严格拒绝。
- 支付创建使用 clientRequestId 幂等，回调使用 provider + callbackId 唯一约束。
- 错误金额回调保存为 REJECTED，不更新支付单、订单金额或状态。
- 成功回调在单事务内更新支付、订单已付金额、PAID 历史和房间预占。
- 支付配置按门店、租户、小程序层级解析，只保存环境变量等凭据引用。
- 测试支付适配器默认关闭，仅非生产环境显式开启后可用。

## 验证

- Windows 后端全量测试和仓库门禁通过。
- WSL MySQL 8.4.9 临时库执行 `up → verify → down → up → verify` 通过。
- 迁移语句：up 75、verify 54、down 69。
- 实测服务端金额、支付单幂等、错误金额回调留档、重复成功回调不重复记账、门店配置优先级和生产环境测试适配器强制关闭。

## 后续

M05-B 接入微信支付预支付、签名、回调验签、主动查单、退款、退款回调和对账。