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

业务介绍

    1.业务简介

    •方案介绍
抖音生活服务核销工具小程序是针对抖音生活服务商家的解决方案,可辅助商家实现“售卖团购券/次卡后,进入抖音小程序核销”的效果,抖音生活服务核销工具小程序内可额外实现预约时间/预定包房/选场次/加价购买增值服务等定制能力,帮助有需要的商家优化核销体验,提升核销效率。
    •准入标准
抖音生活服务核销工具小程序目前主要适用于综合行业内除购物行业、上门服务行业、摄影行业以外的商家进行申请使用。(电影核销工具小程序暂不支持新增)

    2.客户案例

​
截图展示
亮点
休娱——棋牌
​
支持使用抖音小程序核销工具实现:
    1.✅先买后约
    2.✅选房间、选时段
综合-密室剧本杀-反斗城
​
​
支持使用抖音小程序核销工具实现:
✅预约场次
✅查看拼场信息
✅查看剧本
✅发送订阅消息
​
​
剧场演出
​
支持使用抖音小程序核销工具实现:
    1.✅先买后约
    2.✅选场次、选座位
加油站
​
    1.✅核销时选择油号、枪号
    2.✅额外加价、补差价
共享租车
    1.✅调起二维码扫电动车开锁
    2.✅还车后完成团购券抵扣核销

    2.接入流程

目前抖音生活服务核销工具小程序按照是否需要加价购买其他服务可分为两大类,自研商家及技术服务商均可按照需求进行选择对接。
类型
适配行业
举例说明
准入情况
适配商品类型
接入流程
开发周期
核心差异
只做核销(0元兑换),无加购/补差价诉求
​
综合行业内除购物、上门服务类目外
如用户在抖音买了一张某棋牌室2小时通用团购券,进入商家核销工具小程序进行棋牌室房间以及时间的选择,不做额外的补差价动作
准入
团购、次卡
1-2周
核心接入原生券核销接口:
    1.原生券查询
    2.核销原生券
    3.核销结果通知
除了核销券,还需要在该笔核销单基础上加购/补差价
​
综合行业内除购物、上门服务类目外
​
如用户在抖音买了一张某棋牌室2小时某房型团购券,进入商家核销工具小程序进行棋牌室房间以及时间的选择,希望在用户选择时支持用户做额外补差动作选择更高级别的房型进行消费
准入
​
团购、次卡
​
2-3周
​
核心需要接入核销工具交易系统
    •核销工具交易系统会校验原生券ID,所以只能走我们约定的携带券ID去核销+附带小料的模式下单 如果没有携带券ID(也就是正常模式下单)会被拒绝掉
在抖音来客创建预售券后,消费者在原生选择票档等下单购买;通过isv的小程序能力,支持消费者跳转至小程序进行时间、场次、座位等观演信息的选择并进行预约
剧场、演出行业
用户在抖音购买某剧场的演出观演票,购买后通过核销工具小程序进行剧场座位的选择。
准入
预售券
1-3周
核心需要接入预约jsapi组件、接单等接口

    3.常见问题

    1.券查询相关Q&A

    1.【想查询用户在抖音买的券列表】:
    a.我是通过什么形式来查询用户抖音券列表的?
    i.通过openid和token的形式,调用券查询接口即可抖音开放平台-用户券列表查询
    b.我能通过手机号方式查询用户券列表吗?这样我其他平台的券也可以一起聚合和消费
    i.不建议通过手机号的形式来查询用户的券列表,因为手机号查询会有用户手机号拒绝授权的情况,且不建议做强制手机号授权(有合规风险)
    ii.且就算查询到多平台的券资产,因为在抖音小程序接入了交易系统,我们会校验抖音原生团购券ID,其他平台的券也是没有办法核销的,不建议做展示
    c.那我如果想在其他渠道也展示抖音券的资产怎么办?
    i.如果您一定需要的话,可以在小程序提单页前吊起手机号授权,做多平台资产互通;但是在抖音端券查询时候,建议还是使用openid和token的形式
    2.【只想查询用户在该订单下的券】:
依旧使用抖音开放平台-用户券列表查询,我们会返回给您orderid,若您只想保留某个orderid下对应的券,可以自行过滤一下

    2.商品&门店相关Q&A

    1.抖音来客上的原生团购券和我小程序内的商品如何做关联和对应呢?
    a.在抖音来客后台创建商品的时候,有个字段可以关联第三方商品ID,可以在商品创建环节就将该信息填入,这样在后面调券查询接口的时候,就知道这个券对应商家自己小程序内哪个商品了
    2.抖音的门店(POIID)和商家的门店如何对应?
    a.这个需要商家/开发者自己维护一套对应关系,我们提供了快捷查询某来客账户下依旧认领的POIID信息,可通过此接口相对快速的完成查询,再做线下人工的认领和对应https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/life-service-open-ability/life.capacity/life.capacity.shop/shop.query
    3.次卡和团购券核销的时候有哪些差异点?
    a.可以参考这个文档核销工具次卡
    4.我可以上线“储值卡”核销吗?
    a.储值卡风险太高,且平台能力很难完美适配,不建议做

    3.退款相关Q&A

    1.【用户还未核销】
解读:原生团购券为待使用状态、小程序内还未开始兑换/核销
此时用户可以随时退掉原生团购券
    2.【用户已经核销】
解读:用户已经在小程序完成核销(点单/选座/其他核销行为),此时原生团购券已经为“已完成”状态
    a.用户侧情况:
    i.原生团购单:无退款入口了
    ii.小程序单:需要明确使用前/预约后(若有)/使用后各环节的退款规则,不得只写过期退、随时退。具体规范参照:https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/operation/industry-norm/lifeservice/updatedmaterialuploadspecificationsforlifeserviceminiprogram
    b.开发者侧:
    i.情况1:用户核销1H以内
    1.小程序单+原生团购单都要退:可以直接通过接入openapi发起小程序单的退款(退的是小程序内额外加的钱),小程序退款成功后,抖音平台会自动撤销核销原生团购单(来客创建的那张券会从已使用——>待使用),撤销消息通知可通过这个接口查询撤销核销消息通知文档
    2.只想退原生团购单:可以直接调用openapi接口撤销原生团购单,小程序单的状态自己处理即可(小程序的小料单不感知撤销的订单状态)
    ii.情况2:用户核销1H以外
    1.此时开发者就算发起了小程序单的退款,平台也帮助开发者发起了原生团购的撤销核销,但是会撤销核销失败,因为原生团购有1H外无法撤销的限制,那么此时用户如果还想退款,需要引导用户去找抖音客服退,抖音客服退款成功商家侧会有通知
    c.来客撤销核销:开发者需要监听原生券消息,防止无感知

    4.分账相关Q&A

    1.原生团购券的分账和小程序支付金额的分账是同一套体系吗?/我可以直接用我来客的分账体系保持不动吗?
    a.不是的,原生团购券的分账是用来客的那套分账体系,小程序内因为加购(如茶饮的加小料、影院的补差价)产生的金额需要用小程序的分账体系,也就是说,如果在小程序内核销原生团购券后有额外的支付产生,那么分账就会走2套体系
    2.小程序的分账是什么模式
    a.小程序分账是担保支付模式,详细介绍在这,支持“支付宝支付”、“抖音支付”、“微信支付”3种支付方式,如果开通支付宝/微信,相当于在抖音后台填写进件信息后,抖音替商家在微信/支付宝侧开通商户号,后面小程序的钱会在订单核销后D3内分账到客户的该商户号内,商户可在抖音后台操作提现等等,但是整个流程都是在抖音完成的,不涉及去微信/支付宝后台
    3.小程序的分账支持全部分账到一个总账户,再有商家自己线下分给其他方吗?
    a.支持的,那就只进件一个总商户号即可
    4.小程序的钱支持给服务商角色分账吗?
    a.支持的,分账的时候平台不感知角色,服务商如果想参与分账,可以直接参与进件开通商户号,每一笔订单分账的时候往该商户号下分钱即可
    5.我有什么办法可以节省小程序分账的成本吗?
    a.方案1:小程序内不涉及任何额外的加购,走纯兑换的逻辑(0元单),这样只需进件一个默认商户号即可
    b.方案2:若一定需要小程序额外支付,且门店数过多,可以走上方的接口进件/页面进件的形式,一定程度上可以节省一定进件成本
    c.方案3: 若一定需要小程序额外支付,且很多门店已经在抖音来客端进件过了,那可以直接将抖音来客的资质迁移过来,再额外补充支付宝账号等几个信息即可(此部分只适用于已经在来客开过户的门店),详细可见生活服务小程序-开通商户号
    6.分账有上限吗?
    a.微信仅限30%分账。支付宝和抖音支付100%分账
    7.我可以开通自动提现吗?
    a.可以,找平台开通白名单
    8.小程序内产生的交易佣金如何抽取?
    a.统一按照生活服务业务的抽返佣规则抽取( 和原生团购券的规则也是一样的)详情可根据具体类目咨询来客客服
    b.该抽佣规则的数字包含了渠道支付费(千6)
    9.小程序的分账明细如何获得?
    a.登录抖音开放平台,进入小程序控制台支付部分查询明细

    5.入口相关Q&A

    1.原生团购订单详情页“去使用”的入口是怎么打开的?
    a.是平台配置的,需要商家先按照标准链路开发并自测后提交平台验收,验收通过后平台配置上线的,届时需要给平台accoutid(来客ID)、小程序appid
    2.多个来客可以配置跳转1个小程序吗?
    a.可以支持多对一

    6.测试相关Q&A

    1.小程序正式上线前我怎么测试呢?
    a.我们提供了“去使用”入口仅部分UID可见的逻辑,可以在正式上线前配置上部分UID的测试名单,没问题后再打开,可联系对应运营同学
    2.我是ISV技术服务商,我没有抖音来客怎么办?
    a.目前平台侧暂时没有提供好的抖音来客测试账号流程,建议找一个合作的商家,使用商家的来客
    3.我是商家,我小程序已经正式上线了,可是我后面还要做迭代,我的测试环节和正式环境怎么办?
    a.可以申请2个小程序,但是2个小程序都是正式环境(目前沙盒环境无法调通交易相关),一个用来测试一个用来上线
    4.整体的测试上线流程是?
    a.开发者完成小程序开发和自测——>来客端准备一个测试商品/正式商品——>开通“去使用”入口仅部分UID可见——>测试整体流程没问题后找平台开全量入口

    7.其他Q&A

    1.群里没有人及时回复怎么办?
    2.可以支持跨单核销吗?
    a.目前核销工具核销环节会校验原生团购券ID,因此不支持跨单核销,举个例子:
    i.一个订单买了2张杨枝甘露券,进入小程序核销时。可以同时核销2张券
    ii.一个订单买了1张杨枝甘露券、一个订单买了1张芋泥波波券,进入小程序核销时,需要分开核销