抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 会员通手机号格式说明&国家区号拆分能力
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购（在线预约）
  • 日历票价格库存属性发布
  • 景区预订信息校验
  • 景区创建订单
  • 景区确认订单
  • 景区退款审核
  • 景区回调审核退款
  • 景区退款结果通知
  • 景区订单状态查询
  • 订单状态查询（SPI）
  • 三方码发布
  • 景区团购三方码方案
  • 景区行业团购|在线预约解决方案
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

    抖音在某些场景下需要主动查询商家/第三方的预约订单核销状态。对接方返回查询订单的核销状态，进而做下一步订单流转处理。
    Scope
    life.capacity.trip_order_query
    权限要求
    景区行业解决方案-景区订单状态查询
    回调场景
    景区查询订单状态
    ​

    请求参数

    参数名称
    参数类型
    是否必填
    是否加密
    参数描述
    order_id
    string
    是
    否
    抖音侧订单 ID
    order_out_id
    string
    否
    否
    第三方订单 ID

    响应字段

    参数名称
    参数类型
    是否必填
    参数描述
    data
    struct
    是
    ​
    - error_code
    int
    是
    错误码
    - description
    string
    是
    错误信息
    - order_out_id
    string
    是
    第三方订单 ID
    - total_voucher_quantity
    int
    是
    第三方凭证总数量
    - used_voucher_quantity
    int
    是
    第三方凭证已使用数量（如果返回结果带 vouchers ，则该字段表示 vouchers 中状态为 1 的数量）
    - vouchers
    list
    否
    凭证列表（部分退需要）
    -- entrance
    struct
    是
    景区的入园项目（若入园凭证是单独的凭证，则使用此字段用来传入园凭证。若不是单独的凭证，可使用自定义项目的字段传入）
    ---project_id
    string
    是
    入园项目的唯一标识,与projects中不能重复（核销时需要）
    ---status
    int
    是
    凭证状态 0 为未使用，1 为已使用状态为1 的票会被核销掉
    --projects
    list<object>
    否
    可自定义的项目（例：景区项目索道A、索道B等）
    ---project_id
    string
    是
    园内项目的唯一标识,与projects中不能重复（核销时需要）
    ---status
    int
    是
    凭证状态;0为未使用，1为已使用状态为1 的票会被核销掉