文档中心 > API类目 > 本地生活预订交易

qimen.taobao.life.booking.order.close.notice (本地生活-预订-关单通知)

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"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部