接入易错点

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

一、合单查单与整单关单

注意事项

说明、正确应该怎么做

不做会怎么样

 合单未支付订单须按原单信息整单关闭

 说明:合单支付未提供单独关闭某个子单的方式,须关闭整个合单订单,且仅对未支付订单操作。
正确应该怎么做:① 先调用查询合单订单接口确认订单仍为 NOTPAY;② 调用关闭合单订单接口 POST /v3/combine-transactions/out-trade-no/{combine_out_trade_no}/close;③ 按下单时的普通商户或服务商接口要求传入 combine_appid 和全部 sub_orders,确保子单数量、商户号及子单订单号等与下单时完全一致;④ 关单成功后按 CLOSED 终态处理。
典型反例:直接复用普通支付单笔关单流程关闭合单中的某个子单,未按合单结构设计整单关闭。
见 4012577452-关闭合单订单、4012761079-关闭合单订单、4012077667-开发指引、4012166832-开发指引 

 无法只关闭指定子单;若关单子单数量或信息与下单时不一致,将返回 INVALID_REQUEST,提示请求关单的子单数或子单信息与下单不一致,整单关单失败。 

二、子商户受理关系与子单参数

注意事项

说明、正确应该怎么做

不做会怎么样

 服务商子单须使用存在受理关系的子商户号

 说明:服务商合单的每个子单 mchid 须填写合单服务商商户号并与 combine_mchid 一致,sub_mchid 须为该服务商进件并归属同一服务商的子商户号;一个服务商合单只能组合本服务商下的特约商户。
正确应该怎么做:① 下单前建立并校验“服务商号 → 子商户号”映射,确认每个 sub_mchid 确由当前服务商进件并归属当前服务商;② 每个子单的 mchid 使用 combine_mchid,sub_mchid 使用校验通过的子商户号;③ 其余子单字段按服务商 APP 合单下单接口填写后提交。
典型反例:仅在业务侧确认已开通合单权限,却未校验每个子商户号是否属于当前服务商。
见 4012758021-APP合单下单、4012166832-开发指引、4013461863-常见问题 

 返回 NO_AUTH,提示「受理关系不存在」,子单无法提交,合单交易失败。 

反馈
目录
置顶