接口说明

接口名称 order_close
是否幂等
接口模式 直连
异步通知

应用场景

商户通过交易关闭接口可以发起交易关闭,支付成功或已经关闭的订单不允许发起关闭交易请求。此接口目前只支持微信和支付宝,云闪付暂不支持

注意事项

  • 宝付订单号、商户订单号至少选择一个传入,推荐传入宝付订单号,如果同时传入,系统默认使用宝付订单号。
  • 调用交易关闭接口,系统返回异常时,请调用查询接口确认订单状态。
  • 交易关闭接口同步成功代表已经受理成功,并不代表交易已经关闭,交易关闭结果以异步通知结果或者查询结果为准,交易关闭异步通知信息同5.5.1支付结果通知。

接口参数

  • 请求:
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 100000 宝付支付分配的终端号
商户号 merId S(16) 100000 宝付支付分配的商户号
终端号 terId S(16) 100000 宝付支付分配的终端号
宝付订单号 tradeNo S(32) 12312312312 与商户订单号对应的宝付侧唯一订单号,推荐传入此值
商户订单号 outTradeNo S(32) 20210315155012 商户系统内部订单号,同一个商户号下唯一
  • 返回
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId S(16) 100000 宝付支付分配的终端号
商户号 merId S(16) 100000 宝付支付分配的商户号
终端号 terId S(16) 100000 宝付支付分配的终端号
宝付订单号 tradeNo S(32) 12312312312 与商户订单号对应的宝付侧唯一订单号,推荐传入此值
商户订单号 outTradeNo S(32) 20210315155012 商户系统内部订单号,同一个商户号下唯一
业务结果 resultCode S(16) SUCCESS SUCCESS:成功,FAIL:失败
错误代码 errCode S(32) 当业务结果FAIL时,返回错误代码
错误描述 errMsg S(128) 当业务结果为FAIL时,返回错误描述
作者:xiaofeng  创建时间:2025-03-25 15:24
最后编辑:xiaofeng  更新时间:2025-06-05 10:43