微信支付 2026 年接口变更：合单字段语义调整、退款不再返回卡尾号、旧 IP 5 月 18 日下线

来源：微信支付商户/合作伙伴文档中心更新日志（pay.wechatpay.cn、pay.weixin.qq.com，更新至 2026-09）。以下是需要对接方跟进的变更。

1. 合单支付字段更名（2026-01 起）

涉及《APP/H5/JSAPI/Native/小程序合单下单》《查询合单订单》《关闭合单订单》《合单订单支付成功回调通知》的请求/返回参数：

• sub_orders：子单信息列表 → 商品单信息
• out_trade_no：子单商户订单号 → 商品单商户订单号
• sub_orders.description 长度由 128 改为 127

2. 退款返回字段调整

退款相关接口（申请退款、查询单笔退款、发起异常退款、退款结果通知）的 user_received_account 字段，退款入账账户银行卡展示形式调整：原格式 {银行名称}{卡类型}{卡尾号} 改为 {银行名称}{卡类型}，不再展示卡尾号。

另外，申请退款的 funds_account（退款资金来源）新增枚举，仅对预授权订单退款适用。

3. 微信支付分

• 原字段 materiel_no【物料编码】更名为 materiel_no【物料URL】。
• 请求参数新增 device.start_device_id、device.end_device_id、device.materiel_no。
• 参数取值：参与政策填微信支付运营加参后的 URL，未参与政策填商家自有 URL。

4. 商家转账

• 发起转账、撤销转账、查询转账单、申请/查询电子回单等新增错误码 FREQUENCY_LIMIT_EXCEED、RATELIMIT_EXCEEDED。
• 请求参数新增 user_recv_style。
• 新增鸿蒙 APP 调起用户确认收款接口。

5. 医保支付

返回参数新增 med_ins_fail_reason（医保支付失败原因），并新增《报错排查指引》文档。

6. 网络变更（重要）

微信支付于 2026-04-20 在 DNS 解析中以新 IP 替换旧 IP，2026-05-18 下线旧 IP。涉及域名：

• api.mch.weixin.qq.com、api2.mch.weixin.qq.com、payapp.weixin.qq.com
• pay.weixin.qq.com、action.weixin.qq.com、fraud.mch.weixin.qq.com
• api.wechatpay.cn、api2.wechatpay.cn、payapp.wechatpay.cn
• pay.wechatpay.cn、action.wechatpay.cn、fraud.wechatpay.cn

商户系统出口防火墙若做了域名/IP 白名单，需在变更前确保新 IP 已在白名单内；直接依赖 DNS 解析的商户不受影响。

7. AI 支付

2026-09 上线《AI支付》能力（支付产品）。

文档：
合作伙伴总览：