接入易错点

更新时间:2026.10.30
||| 安装 Skill

一、参与商户 APPID 绑定

注意事项

说明、正确应该怎么做

不做会怎么样

 合单发起方与所有子单商户须绑定同一APPID

 说明:H5 合单发起方 combine_mchid 和每个子单参与方 sub_orders.mchid 都必须绑定同一个 combine_appid,仅发起方完成绑定不满足合单要求;普通(单笔)支付能成功不代表合单下单也能通过同一校验,新增子单商户号须单独校验其与 combine_appid 的绑定关系。
正确应该怎么做:① 合单发起方和所有子单参与方商户的超级管理员分别登录商户平台,在【产品中心 > APPID授权管理 > +关联AppID > 新增授权】填写同一个 combine_appid 并提交授权绑定申请;② 由该 APPID 的管理员登录公众平台或开放平台,分别确认发起方和所有子单商户号的授权绑定;③ 在各商户的【产品中心 > APPID账号管理 > 我关联的APPID账号】核对绑定结果后再下单;④ 发现子单商户号尚未与该 combine_appid 绑定的,先通过该入口补齐绑定再发起交易。
典型反例:只给合单发起方绑定 combine_appid,子单商户沿用另一个 APPID 或未绑定该 APPID 就发起合单;沿用普通支付已验证过的 appid 与商户号组合直接发起合单支付,未核查新增子单商户号与该 appid 的绑定关系。
见 4015764448-H5合单支付开发接入准备、4012078230-H5合单支付开发指引、4013426141-管理商户号绑定的APPID账号、4012556961-H5合单下单、4013287174-管理商户号绑定的APPID账号 

 合单下单返回 400 APPID_MCHID_NOT_MATCH,提示「appid和mch_id不匹配,请检查后再试」或「AppID和mch_id不匹配」,整笔合单订单无法创建。 

二、主单与子单商户单号生成

注意事项

说明、正确应该怎么做

不做会怎么样

 主单与子单商户单号须分别生成且不得复用

 说明:combine_out_trade_no 属于合单主单维度,sub_orders.out_trade_no 属于各子单维度,应分别生成且不得复用;两类单号均为 6 至 32 个字符,只能使用数字、大小写字母、下划线、短横线、竖线或星号。
正确应该怎么做:① 为合单主单和每个子单分别生成独立商户单号,不使用主单号直接充当子单号;② 保存主单号、子单商户号与子单号的完整对应关系,供查单、关单和回调处理使用;③ 同一笔订单幂等重试时沿用首次单号及原参数;h5_url 超过 5 分钟时使用原下单参数重新获取;仅在订单关闭或需要新建订单时,分别生成新的主单号和子单号。
典型反例:为减少字段数量,直接把 combine_out_trade_no 填入子单 out_trade_no。
见 4012556961-H5合单下单、4012078230-H5合单支付开发指引、4013421126-查询合单订单、4013421130-关闭合单订单、4020800552-H5合单支付错误码 

 复用已占用单号会返回 270333959 或 270333962,提示「商户订单号重复,请检查该单号是否已使用过」;主单与子单混淆也会影响订单定位、查单和对账。 

反馈
目录
置顶