接入易错点

 公钥切换期间须覆盖全部合单请求

 说明：平台证书切换微信支付公钥按商户号进行，切换过程中所有使用商户号的业务场景和接口都要先支持公钥模式。
正确应该怎么做：① 在商户平台或合作伙伴平台下载微信支付公钥并取得公钥ID；② 为每个合单请求增加请求头 Wechatpay-Serial: <微信支付公钥ID>，不能只修改其他已切换接口；③ 同步让回调按 Wechatpay-Serial 选择公钥或平台证书验签；④ 确认全部合单接口均覆盖后继续灰度。
典型反例：项目内其他接口已切换到公钥，但 /v3/combine-transactions/jsapi 仍遗漏 Wechatpay-Serial 请求头。
见 4012925289-如何从平台证书切换成微信支付公钥、4013038589-微信支付公钥常见问题 

 合单请求仍会按旧签名方式处理，无法完成该接口的公钥切换，支付请求不能按预期完成。

 同一商户多子单须按子单分别展示

 说明：同一商户号可以在 sub_orders 中出现多笔子单；用户可从微信收银台的“订单详情”查看子单信息，同一商户不会按商户号合并展示。
正确应该怎么做：① 按业务订单分别生成独立 sub_orders[].out_trade_no；② 保存下单时的子单清单及金额；③ 前端订单详情按子单逐项展示商品描述和金额，不按商户号汇总；④ 查询和回调也按子单清单进行核对。
典型反例：同一商户的两笔子单在前端仍只展示一个汇总金额，导致用户无法与微信订单详情逐笔对应。
见 4012077221-JSAPI合单支付产品介绍、4013421298-JSAPI合单支付常见问题、4013462212-服务商JSAPI合单支付常见问题 

 微信订单详情与商户系统展示口径不一致，用户无法按子单核对收款方和金额。

 合单子单须全部成功或全部失败

 说明：合单支付不存在一笔子单成功、另一笔子单失败的状态；支付成功时各子单均应为 SUCCESS。
正确应该怎么做：① 用户返回页面后调用查询合单订单接口；② 按 sub_orders[].trade_state 逐笔核对状态；③ 只有全部子单均为 SUCCESS 时按整单支付成功处理，NOTPAY 或 CLOSED 按对应未完成状态处理；④ 未收到支付通知时继续通过查单确认。
典型反例：把不同子单分别作为独立支付结果落账，允许一笔成功、一笔失败后分别完成售后。
见 4013421298-JSAPI合单支付常见问题、4013462212-服务商JSAPI合单支付常见问题、4012078634-JSAPI合单支付开发指引、4012166834-服务商JSAPI合单支付开发指引 

 按部分成功处理会造成订单状态与整单支付结果不一致，影响后续确认收货、退款和资金核对。

 全部子单成功后再顶层读取合单流水号

 说明：合单下的子单全部支付成功后，查询和回调会返回 combine_transaction_id，且两处均为相同的顶层字段。
正确应该怎么做：① 查询时先确认 sub_orders[].trade_state 全部为 SUCCESS；② 再从查询响应顶层读取 combine_transaction_id；③ 回调验签并解密 resource 后，也从解密结果的顶层读取；④ 该字段只用于补充合单流水关联，支付结果仍以子单交易状态为准。
典型反例：在未确认全部子单成功前就要求该字段存在，或从 sub_orders 数组内部读取该字段。
见 4013421222-查询合单订单、4013421231-合单订单支付成功回调通知、4013462164-服务商查询合单订单、4013462175-服务商合单订单支付成功回调通知 

 在错误时点或错误层级读取将无法取得合单流水号，影响基于该流水号的对账关联。

 新增被合单子商户须先申请接收合单权限

 说明：已有服务商合单权限不会自动覆盖后续新增的子商户；新增子商户需要单独具备接收合单权限及对应支付权限。
正确应该怎么做：① 新增子商户前先确认其基础支付权限状态；② 联系对接运营为该子商户申请接收合单权限；③ 确认服务商与子商户授权关系生效后，再将新增 sub_mchid 加入子单；④ 新增前已开通的子商户不受影响。
典型反例：服务商首批申请完成后新增子商户，未补申请接收权限就直接传入新 sub_mchid。
见 4013461849-服务商JSAPI合单支付开发接入准备、4012757938-服务商JSAPI合单下单、4020803742-服务商JSAPI合单支付错误码 

 新增子单返回 NO_AUTH 或 268441788“子商户未授权父商户的产品权限”，新增商户交易无法完成。