抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

组合券包SAAS对接方案

收藏
我的收藏

业务介绍

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

接入前准备

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

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

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

开通解决方案及能力

开通流程

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

业务流程

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

对接流程

交易验券时序图

接口清单

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