抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 解决方案场景化拆分公告
  • 到店餐饮解决方案
  • 随心团解决方案
  • 到综行业解决方案
  • 线索管理解决方案
  • 综合到店提货券对接解决方案
  • 到综行业团购解决方案
  • 到综团购预约品解决方案
  • 组合券包SAAS对接方案
  • 航司saas对接解决方案
  • 度假旅行社行业解决方案
  • 景区行业解决方案
  • 酒店行业解决方案
  • 历史版本文档(不推荐)
  • 组合券包SAAS对接方案

    收藏
    我的收藏

    业务介绍

    目前组合券包支持餐饮和综合行业对接,业务介绍与餐饮一样,参考这个文档:组合券包业务介绍
    到综行业saas对接与餐饮行业不同,到综暂不支持saas接口创建商品,具体可以参见下方的接口清单

    接入前准备

    根据以下文档完成开发者账号开通认证、生活服务应用的创建、申请解决方案和能力(参考对接能力)。

    开通认证开发者账号、创建生活服务应用

    •技术服务商:技术服务商接入指南

    开通解决方案及能力

    开通流程

    •登录服务商平台
    •在右上角点击「控制台」,在「我的应用」页面选择「生活服务商家应用」,然后点击目标应用
    •在应用左侧导航栏点击「解决方案」,在「解决方案」页面的「到综行业解决方案」的「操作」列点击「申请开通」或「查看详情」,审核通过后即可调用相关接口。

    业务流程

    注:综合行业组合券包商品暂不支持saas接口创建,只能通过来客创建

    对接流程

    交易验券时序图

    接口清单

    开放能力
    是否必接
    对接接口
    接口说明
    三方码
    必接
    抖音侧调用第三方服务商接口推送用户预下单消息,返回结果。
    必接【更新】
    抖音侧向商家/服务商发起券码申请,务必做到接口幂等,因为会存在网络等原因或超时,抖音会重试发券。
    必接【更新】
    抖音侧先申请服务商发码,如果能同步返回结果则不需要本接口,如果异步返回结果则调用本接口通知抖音。
    必接【更新】
    抖音侧向服务商发起退款申请。
    选接
    审核结果为拒绝时必须告知抖音拒绝原因,若没有原因将会返回报错,拦截本次审核结果
    选接
    用于抖音侧向商家侧同步退款状态信息变更。
    团购核销
    抖音码必接
    【更新】
    抖音团购券码的核销, 需要先调用本接口, 查询订单的券列表,选择要验的券,再调用验券接口,核销券码。
    必接
    用于核销券码,同时适用于抖音团购券码与三方券码,抖音券码的核销需要先调用准备接口,再调用本接口,三方券码的核销直接调用本接口即可。
    必接
    针对“抖音团购券码、三方券码”两种券码误核销之后的撤销操作,订单状态由“已使用”回改为“待使用”,用于验券错误需要撤回验券等场景, 有时间限制,验券超过一个小时就不可再撤销。
    订单查询
    选接【更新】
    通过接口查询指定范围的订单列表及订单详情:
    必接【更新】
    用于用户下单后向商家通知券消息,与订单消息的区别是维度不同,一张订单下面可能会有多张券
    交易退款
    选接【更新】
    支持通过订单id和券id查询售后详情
    团购对账
    必接
    用于生活服务综合行业商家查询账单明细。不同行业返回参数不同,其他行业商家请勿查询此接口。