微信支付口径切到线下(2026-09-24)

目标

平台所有商户的微信支付统一按**线下**报备与开通,并把这一套口径做成可配置(保留一行回退)。
决策与代价见 ADR 0005。

落地范围

  • 下发的 5 个值:支付场景 1/2/3、业务开通类型 02、费率 0.30%、
    费率规则号 企业 758/个体户 762/小微 770、进件 scene_type=OFFLINE(另加小微经营类型 MICRO_TYPE_STORE)。
  • 下发侧:业务开通网关(场景配置化、不再下发 online_busi_type)、微信配置网关(fee_type)、
    实名网关与实名查询(pay_scene)、两个进件网关(scene_type)。
  • 判定侧:阶段进度(微信三场景 + 费率 + 业务开通类型,AppID 判定改为跟随配置)、
    MerchantSettlementService 的两个 *Effective 闸门。三者与下发**取同一份配置**。
  • 进件新增:个人主体的**经营详细地址**(迁移 V155 + 请求字段 + 落库 + 商户端表单 + 后台详情展示),
    detail_addr 不再用证件地址顶替;F22 的含义与文案改为「实体门头照」。
  • 文档:docs/huifu/02、05、06、08(含 08 §9 的存量迁移 runbook 与清单 SQL)。

验收

  • 已跑:定向 62~66 项全过;全量 410 项只剩既有失败(3 项基线 + 3 项连 H2 的用例,见
    docs/agents/testing.md)。迁移 V155 在测试库执行成功。
  • 未做(归用户):真实进件与真实支付/退款的通道验收。用户明确要求「不用你来走真实进件流程,
    你改好了到时候我自己来走」。
  • 上线时必做:存量商户按 docs/huifu/08 §9 逐个在控台改口径,并确认人才端 AppID 绑到了那个商户
    实际收款的微信子商户(换场景会重建子商户号)。

遗留(见 issues/)

  • 01 微信侧拒绝真因(bank_message)被丢弃 —— 可观测性缺陷,本次排查的第二个障碍。
  • 02 口径的五个值散在 6 个文件里,收成一个值对象 + 去掉重复的 AppID 扫描。
  • 03 线下报备下**企业**主体要不要门头照/内景照(需汇付确认)。
  • 04 走基本户的两条退款路径没有人工出口(到店消费退款、撤销核销余额不足)。