微信支付合单支付文档更新：sub_orders 字段名没变，语义从「子单」改成了「商品单」
微信支付在 2026 年对合单支付、进件、退款等接口做了一批字段调整。多数是长度放宽和枚举新增，但有一处容易踩坑：字段名没变，变的是字段语义描述。
来源：微信支付合作伙伴文档中心更新日志（更新时间 2026-08-26；商户文档中心 2026-09-01）。
一、合单支付字段语义更名（2026-01 起）
涉及以下接口的请求/返回参数：《APP 合单下单》《H5 合单下单》《JSAPI 合单下单》《Native 合单下单》《小程序合单下单》《查询合单订单》《关闭合单订单》《合单订单支付成功回调通知》。
| 字段名 | 原语义 | 新语义 |
|---|---|---|
sub_orders | 子单信息列表 | 商品单信息 |
out_trade_no | 子单商户订单号 | 商品单商户订单号 |
注意：sub_orders、out_trade_no 这两个字段名本身没有变，变的是字段的语义描述。如果代码或文档里按「子单」去理解它，并按子单维度做订单拆分、对账，就容易理解错——它现在描述的是「商品单」。
这类调整属于文档语义澄清导致的认知偏差：JSON 解析不会报错，接口也不会返回任何异常，但业务映射可能出错。可以回过头检查一下字段注释、映射层和账单拆分逻辑里的措辞与维度。
二、2026-03：字段长度与描述调整
《App/H5/JSAPI/Native/小程序合单下单》中：
sub_orders.description字段长度由 128 改为 127；combine_out_trade_no、out_trade_no字段描述去掉@符号。
三、2026-08：地址相关字段长度放宽
与地址相关的进件类接口，一批字段的长度限制放宽：
特约商户进件《提交申请单》
license_address、company_address、id_card_address、id_doc_address 字段长度由 4-128 字符调整为 1-512 字符。
商户开户意愿确认《提交申请单》
company_address、identification_address、ubo_id_doc_address由 4-128 调整为 1-512；channel_id（渠道商户号）最大长度由 9 调整为 32。
平台收付通（商户进件）《提交申请单》
company_address、ubo_id_doc_address 由 4-128 调整为 1-512。
如果之前在前端/后端做了 128 长度校验，需要同步放宽，否则长地址会校验失败。
四、2026-06：退款 user_received_account 不再展示卡尾号
《申请退款》《查询单笔退款（通过商户退款单号）》《发起异常退款》《退款结果通知》返回参数 user_received_account 优化了银行卡展示形式：
原：{银行名称}{卡类型}{卡尾号}
新：{银行名称}{卡类型}
即不再展示卡尾号。若下游按固定格式解析卡尾号，会拿不到。
五、退款资金来源与入账方式新增枚举
- 2026-08《申请退款》请求参数
funds_account（退款资金来源）新增枚举PREPAID：仅对预付订单退款适用，指定从未结算资金出资。 - 退款返回
user_received_account新增入账方式：支持用户分付、微银通退款（2025-12）、小金罐退款（2025-08）。
六、其他
- 商家转账《发起转账》新增
user_recv_style（用户收款样式）选填字段；《商户单号查询授权结果》新增is_display_authorization与package_info。 - 2026-09 支付产品上线《AI 支付》能力；2026-07 上线《医保一码付》。
文档
- 商户文档：https://pay.weixin.qq.com/doc/v3/merchant/4012078749
- 合作伙伴文档中心变更日志：https://pay.weixin.qq.com/docs/partner/changelog/index.html