1. 发起场景 :订单关闭后,我方调用该接口通知合作方订单已关闭。合作方需要关闭自身订单,并释放库存等资源,对该接口做好业务幂等处理。 1.1. 关单场景 :当创建合作方订单后,如出现以下场景,我方会通知订单关闭: 1.1.1. 用户超时未支付; 1.1.2. 商户超时未发货/接单; 1.1.3. 用户快速退款; 1.1.4. 商家/ISV发起退款; 1.1.5. 用户申请退款商家审核通过或审核超时。 2. 预期结果 :合作方关闭该订单,并释放库存等资源。 3. 异常兜底 :我方根据错误码选择重试还是终止。其他异常默认核销失败。 4. 超时时间:5s 5. 注意:超时、网络异常和需要重试的错误码该接口会进行重试,合作方需要注意幂等,幂等字段可以选择我方订单id。不可重试的错误会认为退款失败,此时需要人工介入排查原因
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
tp_order_no | String | 必须 | 123456 | 平台订单号 | |
partner_order_no | String | 必须 | 654321 | 合作方订单号,合作方可根据自身订单号进行业务幂等 | |
cancel_type | String | 必须 | WAIT_PAY_CLOSE | 关单类型,值为 : WAIT_PAY_CLOSE 未支付关单,WAIT_CONFIRM_CLOSE 接单超时,FAST_REFUND_CLOSE 用户快速退,MERCHANT_REFUND_CLOSE 商户退,REFUND_AUDIT_CLOSE 审核退 | |
cancel_reason | String | 必须 | 用户超时未支付 | 关单原因描述 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
success | Boolean | true | 合作方是否收到本次请求 |
biz_result | String | fail | 业务执行结果,success代表成功,fail代表失败 |
biz_error_code | String | ORDER_NOT_EXIST | 业务错误码 |
biz_error_msg | String | 订单不存在 | 业务错误描述 |
data | String | 预留字段 | 具体数据JSON格式,本接口暂时无需该字段 |
{"cancel_reason":"用户超时未支付","partner_order_no":"654321","tp_order_no":"123456","cancel_type":"WAIT_PAY_CLOSE"}
{ "success":true, "biz_result":"fail", "biz_error_code":"ORDER_NOT_EXIST", "biz_error_msg":"订单不存在", "data":"预留字段" }
{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}
错误码 | 错误描述 | 解决方案 |
---|