接入易错点

更新时间: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,提示请求关单的子单数或子单信息与下单不一致,整单关单失败。 

反馈
目录
置顶