关闭交易
接口说明
接口名称 | pay_order_close |
---|---|
接口模式 | 直连 |
异步通知 | 是 |
应用场景
若商户发起过扣款,但超时或因业务原因失败,而交易单状态(txnState)为“WAIT_PAYING-待支付”,此时若商户希望取消订单不再扣款,则需调用本接口关闭交易订单,然后再依次关闭分期单、业务订单。
注意:
- 调用交易关闭接口,超时或系统返回异常时,请调用“查询交易订单”接口确认交易订单状态(txnState)。
- 关闭交易后,渠道不支持再请求扣款。若扣款异常,希望继续扣款,则直接重发扣款即可,无需关闭交易,详见商家扣款接口。
接口参数
- 请求:
说明 | 字段 | 类型 | 条件 | 示例值 | 备注 |
---|---|---|---|---|---|
代理商商户号 | agentMerId | S(16) | 否 | 100003789 | 宝付支付分配的商户号 |
代理商终端号 | agentTerId | S(16) | 否 | 213003567 | 宝付支付分配的终端号 |
交易商户号 | merId | S(16) | 是 | 102002369 | 宝付支付分配的商户号 |
交易终端号 | terId | S(16) | 是 | 100003123 | 宝付支付分配的终端号 |
商户交易订单号 | outTradeNo | 否 | S(32) | 20210315155012 | 商户系统内部交易订单号 |
- 返回
说明 | 字段 | 类型 | 条件 | 示例值 | 备注 |
---|---|---|---|---|---|
代理商商户号 | agentMerId | S(16) | 否 | 100003789 | 宝付支付分配的商户号 |
代理商终端号 | agentTerId | S(16) | 否 | 213003567 | 宝付支付分配的终端号 |
交易商户号 | merId | S(16) | 是 | 102002369 | 宝付支付分配的商户号 |
交易终端号 | terId | S(16) | 是 | 100003123 | 宝付支付分配的终端号 |
宝付交易订单号 | tradeNo | 否 | S(32) | 12312312312 | 宝付交易号 |
商户交易订单号 | outTradeNo | 否 | S(32) | 20210315155012 | 商户系统内部交易订单号 |
业务结果 | resultCode | 是 | S(16) | SUCCESS | SUCCESS:成功,FAIL:失败 |
错误代码 | errCode | 否 | S(32) | 当业务结果FAIL时,返回错误代码 | |
错误描述 | errMsg | 否 | S(128) | 当业务结果为FAIL时,返回错误描述 |
作者:admin 创建时间:2025-03-21 18:43
最后编辑:lilizhi 更新时间:2025-06-17 14:16
最后编辑:lilizhi 更新时间:2025-06-17 14:16