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

qimen.taobao.life.fulfillment.deliver (本地生活-到店-履约推进)

1. 发起场景 :用户支付完成后,如果是外部凭证模式,则我方会调用该接口通知合作方发放凭证。 2. 预期结果 :发码成功返回 success和相应的券码;发码失败返回 fail,并透传相应错误码和错误文案;需要异步发码返回dealing,我方会等待合作方的发货通知。 3. 异常兜底 :默认异步发货。 4. 重试机制 :返回dealing 时,我方将重复发起调用,直到订单失效(超时未发放凭证),默认为 2 小时。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fulfillment_order_no String 必须 12345678 平台履约单号,长度19位,可作为幂等条件
partner_order_no String 必须 123456 合作方订单号,可作为幂等条件
order_no String 可选 12345678 平台订单号,非必传,不推荐使用

响应参数

名称 类型 示例值 描述
success Boolean true 合作方是否收到本次请求,默认为true
biz_result String fail 值枚举,success : 发货成功(接单) fail : 发货失败(拒单) dealing : 发货中(重试发货通知)
biz_error_code String ORDER_NOT_EXIST 业务错误码
biz_error_msg String 订单不存在 业务错误描述
data String { "ticketList" : [ "654321" ] } 具体数据,本接口需要传合作的的券码列表,具体信息入。非必填

请求示例

{"order_no":"12345678","partner_order_no":"123456","fulfillment_order_no":"12345678"}

响应示例

{
    "success":true,
    "biz_result":"fail",
    "biz_error_code":"ORDER_NOT_EXIST",
    "biz_error_msg":"订单不存在",
    "data":"{     \"ticketList\" : [       \"654321\"     ]   }"
}

验签示例

{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部