抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮团购退款
  • 餐饮订座
  • 券资产转移
  • 异步领券结果回调
  • 通知服务商加锁
  • 通知服务商解锁
  • 通知送礼领券
  • 餐饮评价
  • 餐饮门店管理(连锁门店)
  • POI 匹配/申诉(连锁门店)
  • POI 信息报错(连锁门店)
  • 门店申诉(连锁门店)
  • 商家账单明细(餐饮行业)
  • 三方码发布
  • 订单查询
  • 餐饮在线点单解决方案
  • 随心团解决方案
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明

    通知服务商加锁

    请求参数

    参数名称
    参数类型
    是否必填
    参数描述
    备注
    request_id
    string
    必填
    本次请求id
    order_id
    string
    必填
    抖音侧的订单号
    reason_code
    int64
    必填
      加解锁原因
      1001 送礼锁定
      1002 超时未领取解锁
      1003 领券解锁
      1004 取消赠送解锁
      1005 锁定超时尝试解锁
      1006 三方发码超时解锁 0730新增
      1007 三方领取失败解锁 0730新增
      1099 其他
    reason_msg
    string
    可选
      加解锁原因描述
    lock_infos
    array
    必填
      批量操作的券码列表
    .certificate_id
    string
    必填
      抖音侧券码id
    .code
    string
    必填
      服务商侧码
    .lock_scene
    int64
    必填
      加解锁场景
      送礼: 1000

    请求示例

    { "request_id":"11111222222", //本次请求id "order_id":"11111", "reason_code":1, //变更原因code 透传变更原因 1001 送礼锁定 1002 超时未领取解锁 1003 领券解锁 1004 取消赠送解锁 1005 锁定超时尝试解锁 1099 其他 "reason_msg":"", "lock_infos":[ { "certificate_id":"1111111", //券码id "code":"三方服务商三方码", "lock_scene":1000 , //锁定场景 送礼 } ] }

    响应参数

    参数名称
    参数类型
    是否必填
    参数描述
    备注
    data
    object
    必填
      这是一个批量接口,服务商需要保证接口操作数据原子性
    .error_code
    int64
    必填
      错误码 0 认为接口成功
    .description
    string
    必填
    .result
    int64
    必填
      加锁结果, 1-成功 2-失败
      必须是全部成功或者全部失败,不接受部分成功或失败,如果失败,可将每个券码错误原因放到certificates列表中。
    .certificates
    array
    可选
      返回列表
    ..certificate_id
    string
    必填
      抖音侧券码id
    ..error_code
    int64
    必填
      该券码的错误原因
    ..description
    string
    必填
      该券码的错误描述

    响应示例

    { "data": { "error_code": 0, "description": "success", "result":2, "certificates": [ { "certificate_id": "111", "error_code": 0, "description": "11111fwef" } ] } }