预约接单超时回调

我的收藏

当预约提交后一定时间后还没收到开发者的接单通知，平台会向开发者发送接单超时回调，开发者需要返回接单结果。

使用限制

无

接口说明

使用该接口前开发者需完成预约回调扩展点配置。

预售券是 24 小时未接单就回调开发者，如果请求开发者失败，会重试 1 天。如果重试 1 天没有获取到接单结果，状态会停留在预约中，抖音侧不会更改预约单状态。

门票是 1 小时未接单就回调开发者，如果请求开发者失败，会重试 1 小时。如果重试 1 小时没有获取到接单结果就会将预约单改为失败状态，并发起退款。

基本信息

名称	描述
HTTP URL	在行业模板配置-服务端扩展点-预约扩展点中指定的回调地址，配置方式参考行业模板配置文档
HTTP Method	POST

请求头

参见通用参数。

请求参数

名称	类型	是否必填	描述	示例值
msg	string	是	预下单相关信息的 json 字符串，详情参见msg字段	详情参见请求示例
type	string	是	枚举值： pre_create_order：预下单回调 pre_create_refund：退款审核回调 query_marketing_info：营销信息查询回调 calculate_price：营销算价回调 book_accept_timeout：预约接单超时回调	"book_accept_timeout"
version	string	是	固定值："2.0"，即回调版本，用于开发者识别回调参数的变更	"2.0"

名称

类型

是否必填

描述

示例值

msg

string

是

预下单相关信息的 json 字符串，详情参见msg字段

详情参见请求示例

type

string

是

枚举值：

pre_create_order：预下单回调

pre_create_refund：退款审核回调

query_marketing_info：营销信息查询回调

calculate_price：营销算价回调

book_accept_timeout：预约接单超时回调

"book_accept_timeout"

version

string

是

固定值："2.0"，即回调版本，用于开发者识别回调参数的变更

"2.0"

请求参数

名称	类型	是否必填	描述
app_id	string	是	小程序appid
order_id	string	是	抖音侧订单号，len <= 64 byte
book_id	string	是	预约单id，len <= 64 byte
out_book_no	string	是	开发者预约单id，len <= 64 byte

请求示例

curl --location --request POST 'https://xxxxxxx.net/api/v2/book_callback?timestamp=1345678901234&nonce=iuy987q4htafreqw'' \
--header 'Content-Type: application/json'
--data-raw='{
  "version": "2.0",
  "msg": "序列化后的json字符串",
  "type": "book_accept_timeout"
}'

msg 内部结构

{
  "order_id": "614167279916",
  "app_id": "xxx",
  "out_book_no": "xxx",
  "book_id": "xxx"
}

响应参数

名称	类型	是否必填	描述
result	int	是	接单结果，1: 成功，2:失败
msg	string	否	结果描述
accept_type	int	否	接单方式，1:电话接单， 2:商家后台接单

响应示例

正常示例

{
    "err_no" : 0,
    "err_tips" : "success",
     "data": {
         "result" : 1，
         "msg" : "xxxxxx",
         "accept_type" : 2,
    }
}

上一篇：查询预约单信息

下一篇：预约取消/完成通知