qipai/docs/devlogs/2026-06-20-M05-A-统一支付领域.md

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 接入微信支付预支付、签名、回调验签、主动查单、退款、退款回调和对账。