抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 接入前准备
  • 通用接口
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮在线点单解决方案
  • 门店接单信息设置
  • 点单相关商品发布
  • 点单相关商品查询
  • 在线点单交易能力
  • 通知外部商家创单
  • 「SPI」通知外部商家订单已关闭
  • 「SPI」通知外部商家支付成功
  • 通知外部商家待接单
  • 「SPI」查询外部商家订单
  • 「SPI」退款结果同步外部商家
  • 「OpenAPI」商家接单/拒单
  • 「OpenAPI」商家回传备餐/出餐/取餐信息
  • 「OpenAPI」商家发起退款
  • 「Webhook」通知外部商家履约备餐状态变更
  • 「OpenAp」点单订单查询
  • 点单查询电话
  • 「SPI」用户申请取消点单
  • 商品查询
  • 商家账单明细
  • 随心团解决方案
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

    抖音在某些场景下需要主动查询商家/第三方的订单状态，判断接单结果，进而做下一步订单流转处理。

    基本信息

    Scope
    life.trade.meal_retail_spi_query_order
    权限要求
    ​
    回调场景
    ​

    请求头

      •Content-Type：application/json
      •X-Bytedance-Logid: 请求 logid， 用于问题排查用
      •x-life-clientkey: 服务商应用的 client_key

    请求参数

    名称
    类型
    是否必填
    描述
    示例值
    order_id
    string
    是
    抖音侧订单 ID
    100001
    order_out_id
    string
    是
    外部订单 ID
    200001
    请求示例

    响应参数

    名称
    类型
    是否必填
    描述
    示例值
    data
    struct
    是
    ​
    ​
    - error_code
    int
    是
    错误码，合法范围为 [0,999999]
    0
    - description
    string
    是
    错误信息
    ​
    - order_id
    string
    是
    抖音订单ID
    ​
    - order_out_id
    string
    是
    外部订单ID
    20001
    - order_out_status
    int
    是
    外部订单状态：
      •10 // 订单已创建（支付前创单）
      •20 // 已支付
      •30 // 待接单
      •40 // 已接单
      •50 // 备餐中
      •51 // 已出餐
      •52 // 已取餐
      •101 // 交易关闭（用户已取消、商家已拒单或已退款
      •1 // 交易完成
    101
    - take_code
    string
    否
    取餐号
    9527
    - take_time
    int
    否
    预计取餐时间，秒
    1678858480
    响应示例

    错误码

      •重试（最多 15次）
      ◦创建订单失败（error_code!=0 ）并且 error_code!=100
      ◦服务商返回结果不符合协议，比如字段类型错误
    ​
    error_code
    description
    备注
    0
    ​
    成功
    ​
    ​
    ​
    ​
    ​
    ​