接口说明
接口名称 | 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
最后编辑:xiaofeng 更新时间:2025-06-05 10:43