案例微信支付 2026 更新日志：合单支付字段改名、退款不再返回卡尾号，这些改动要动代码

2026-09-10 21:04:04

微信支付 2026 更新日志：合单支付字段改名、退款不再返回卡尾号，这些改动要动代码

更新日志：

两项能力刚上线，接口文档细节以实际文档为准。

【微信支付分】更新《创建支付分订单》《完结支付分订单》《修改订单金额》，原字段 materiel_no【物料编码】更名为 materiel_no【物料URL】。字段名没变，改的是中文含义，但如果有代码或配置按"物料编码"语义存值、做校验白名单，需要跟着改成 URL 语义。
【商家转账】更新《商户单号查询授权结果》：请求参数新增 is_display_authorization【是否展示用户授权信息】选填字段，返回参数新增 package_info【跳转授权信息页的 package 信息】选填字段。
【退款】更新《申请退款》《查询单笔退款（通过商户退款单号）》《发起异常退款》《退款结果通知》返回参数 user_received_account，优化退款入账账户银行卡展示形式：原银行卡返回格式 {银行名称}{卡类型}{卡尾号} 调整为 {银行名称}{卡类型}，不再展示卡尾号。凡是按旧格式做正则解析、字符串截取卡尾号、把卡尾号写进对账文件或退款详情页的地方，都要改。

【医保支付】更新《使用商户订单号查看下单结果》《医保自费混合收款下单》《使用医保自费混合订单号查看下单结果》，返回参数新增 med_ins_fail_reason（医保支付失败原因）选填字段。
【商家转账】更新《发起转账》，请求参数新增 user_recv_style（用户收款样式）选填字段。

【合单支付】更新《APP 合单下单》《H5 合单下单》《JSAPI 合单下单》《Native 合单下单》《小程序合单下单》：sub_orders.description 字段长度由 128 改为 127；combine_out_trade_no、out_trade_no 字段描述去掉 @ 符号。

【合单支付】更新《APP 合单下单》《H5 合单下单》《JSAPI 合单下单》《Native 合单下单》《小程序合单下单》《查询合单订单》《关闭合单订单》《合单订单支付成功回调通知》请求/返回参数，将原字段 sub_orders（子单信息列表）更名为 sub_orders（商品单信息），原字段 out_trade_no（子单商户订单号）更名为 out_trade_no（商品单商户订单号）。JSON 字段名不变，改的是文档描述与内部命名；如果用代码生成工具从文档描述生成模型类名、注释或字段常量，需要重新生成一遍。

其余同月改动：

【商户被管控能力及原因查询】recover_way 新增枚举值 CONTACT_APPROPRIATE_AUTHORITY_FOR_CONSULTATION。
【退款】user_received_account 新增退款入账账户方式：支持用户分付、微银通退款；后续新增支持小金罐退款。
【商家转账】《订单失败原因说明》新增转账失败原因：MCH_CANCEL - 商户撤销付款。失败原因分支里没覆盖这个值的话，会走到默认兜底逻辑。
【商家转账】《发起转账》《撤销转账》《商户单号查询转账单》《微信单号查询转账单》《商户单号申请电子回单》《商户单号查询电子回单》《微信单号申请电子回单》《微信单号查询电子回单》新增错误码：FREQUENCY_LIMIT_EXCEED、RATELIMIT_EXCEEDED。这两个是频控/限流类错误，重试策略里要单独处理，别按普通业务失败直接返回给用户。
【代金券】《查询代金券详情》《根据商户号查用户的券》应答参数 status 新增枚举值 RECOVER：已回收。
【微信支付分停车】《扣费受理》请求参数 currency（货币类型）调整为非必填。
【特约商户进件】《提交申请单》修改枚举值与字段描述；bank_address_code 改为选填。
【平台收付通（商户提现）】上线《商户提现状态变更》能力。

2026-05/06：特约商户进件与商户进件的《图片上传》接口更名为《文件上传》，涉及"图片上传 API"的字段描述同步调整为"文件上传 API"。接口路径与参数不变，但按名称做接口映射或日志检索的地方要对齐新名称。
商户进件《通过业务申请编号查询申请状态》《通过申请单 ID 查询申请状态》返回参数新增 wxpay_sign_required。
2026-03：商户开户意愿确认《获取商户开户意愿确认状态》请求参数 sub_mchid 字符长度由 9 调整为 32；《提交申请单》ubo_info_list 字段即将下线，无需传入。sub_mchid 长度改到 32 之后，本地校验和数据库字段长度如果还按 9 位限制，会直接拦掉请求或写库截断。

总的检查方向集中在三处：字段中文含义与长度限制（合单支付、支付分、开户意愿确认）、返回格式变化（退款银行卡、user_received_account 入账方式）、新增枚举与错误码（商家转账失败原因与限流错误、代金券状态、被管控原因）。

复制全文生成海报微信支付支付对接接口 API