核销工具小程序（加价版）

我的收藏

业务介绍

抖音小程序核销工具是针对抖音生活服务商家的解决方案，可辅助商家实现“售卖团购券/次卡后，进入抖音小程序核销”的效果，抖音小程序核销工具内可额外实现选规格/加小料/加配菜/预约时间/预定包房/选场次等定制能力，帮助有需要的商家优化核销体验，提升核销效率。

场景简介

除了核销券，还需要在该笔核销单基础上加购/补差价，如用户在抖音买了一杯蜜雪冰城的杨枝甘露团购券，进入蜜雪冰城核销工具除了做选规格（大杯/小杯、冷/热），还要做额外的支付动作，举例如下：

情况1：还需要在杨枝甘露这一兑换单基础上加购小料（珍珠/0卡糖等）

情况2: 不同门店不同价格，如上海地区需要在基础上再补差价2元

名词解释

名词	说明
加价	加价是指除了核销券，还需要在该笔核销单基础上加购/补差价，适用于团购、次卡，餐综行业都可。
不加价	不加价是指只做核销（0元兑换），无加购/补差价诉求，适用于团购、次卡，餐综行业都可；或到家行业通过“先买后约”实现核销（不支持小程序核销时产生额外支付），仅限到家行业（洗护，家政等）；
核销工具小程序	抖音内的线上点单工具小程序，可用于线上核销抖音原生团购券以及加购一定限额内的小料商品的点单下单。
交易系统	小程序行业交易系统，本次核销工具小程序依赖此系统完成下单、支付通知、核销、退款、分账等一系列操作。开发者可先行了解此交易系统
抖音原生团购券	抖音本地生活业务的原生团购券，区别于小程序团购券

接入流程

接入前准备

根据以下文档完成开发者账号开通认证、小程序备案等。

生活服务小程序介绍_生活服务商家应用_抖音开放平台

定向申请条件

联系抖音来客后台业务经理（BD）填写内部申请问卷

小程序赋权+小程序打标签：收到问卷后平台会定期处理，平均处理时长1-3天，处理结果会告知业务经理；

业务对接流时序图

开发步骤

开发顺序	开发能力或接口	是否必接	接口链接或操作配置	描述	注意事项
交易部分	用户抖音券资产查询	必接	查询用户券列表_小程序_抖音开放平台	在小程序内核销后可将原生团购券翻转为“已核销” Open api 根据用户open_id和商户account_id查询该用户在该商户下的抖音团购券列表。	1.核销工具内产生的额外支付（小料/补差价）分账时间默认为核销后D+3 2.小料的加购/补差价参与线上本地生活抽返佣政策，餐饮按照2.5%进行抽取，其他行业详见https://lf26-cdn-tos.draftstatic.com/obj/ies-hotsoon-draft/aweme_open_platform/5773341f-fbcc-484c-9c35-20ce964577da.html 3.核销工具小程序因接入交易系统，所以只能走携带券ID去核销+附带小料的模式下单如果没有携带券ID（也就是正常模式下单）会被拒绝掉，因此开发者需要做好页面隔离，没有券资产的不要看到下单页面；建议小程序主页面为券资产列表页
	适用门店	必接	抖音开放平台-订单可用门店查询	Open api 查询某一个订单在某个poi_id门店是否可用
	设置回调地址	必接	回调地址配置	•行业模板：选择本地生活行业模板 •扩展点：需要实现预下单回调、退款申请回调扩展点。 •消息通知：需要订阅支付通知、退款通知、分账通知、券核销消息通知、券撤销核销消息通知。
	预下单接入（开平不全）两个流程单独文档介绍	必接	预下单	Js api	注意：前端jsAPI下单有版本要求，请注意低版本兼容。具体处理参考预下单接入文档中的详细介绍。
	继续支付	必接	继续支付	Js api 非0元单核销场景下，即核销有小料时，拉起收银台后用户未完成支付，此时生成的待支付订单可以使用此js-api进行继续支付
	用户退款申请	必接	用户退款申请	Js api jsapi接口是提供给用户的退款入口。开发者退款可通过openapi接口发起退款，详见openapi发起退款接口
	支付消息通知	必接	通知支付结果	用户支付完成或用户未支付超时取消，通过支付消息通知给到开发者，即在上面设置回调地址中订阅的支付消息通知。
	券核销消息通知	必接	券核销消息通知	用户支付完成之后，行业交易系统会自动核销下单时携带的原生团购券，并将核销结果以消息通知形式告知开发者。订阅方式和设置回调地址时讲述的一样。	注意：开发者可根据核销结果做相应的处理。如果出现交易系统未成功核销原生券的情况，开发者可在收到消息通知后对此小程序订单做退款处理。
	查询订单	必接	查询订单信息	1.消息通知类(支付通知、核销通知等) 可能存在延时、重复发送、通知失败或漏通知场景，开发者接入时需要做好幂等、查询补偿方案(补偿查询建议分多次 15s 30s 1m 5m 10m ..) 2.核销结果以核销通知消息为准，不能使用支付成功消息。(支付成功了，不一定能核销成功) 具体解决方案: 1.支付成功消息通知延迟时，开发者一定要通过主动请求查询订单状态接口，确认支付结果、流转订单状态。小程序发生取消订单时，通过查询订单接口返回结果是订单支付成功，需要调用抖音侧发起退款接口 2.核销消息通知延迟时，开发者一定要通过主动查询券核销状态 ,确认核销结果，流转订单状态。如果查询结果抖音侧返回是核销失败时，需要调用发起退款接口，进行小料单订单取消
	发起退款	必接	发起退款
	查询券核销状态	必接	查询券核销状态
	分账	必接	发起分账查询分账通知分账结果	交易系统的分账（分账规则、分账接口等）都是针对交易系统下的小程序交易订单，不影响抵扣的原生团购券的分账，原生团购券的分账按照原来的规则进行。	注意：0元单可不发起分账
	撤销核销	必接	撤销核销券码核销通知撤销核销通知
原生接口	券消息通知	选接	券消息通知
C端入口	1.C端入口-跳转地址配置接口 2.C端入口-仅部分UID测试可见接口	必接	设置订单详情页按钮白名单接口设置小程序跳转path	•实现用户点击“去使用”按钮后跳转小程序指定path地址 •实现测试期间仅有部分测试人员的UID可以看到“去使用”入口
测试商品配置	创建来客测试商品	选接	1.综合行业找@陈雅婷开来客的“测试商品创建白名单”，需要提供抖音来客商家主账户id 2.餐饮行业不需要申请该权限；	开白名单后实现效果如下，选择“测试商品”并填写“测试用户UID”，建议创建价格为0.01的测试商品若有正式商品可以参与测试，也可以不创建测试商品，直接配合第2步中的“C端入口-仅部分UID测试可见接口”实现测试
4	更改&查询C端文案	选接	查询商家配置文案设置商家展示信息	该接口主要用来修改商家引导文案、按钮文案、二维码展示方式等配置，如下所示
5	手机号能力接入	选接	获取手机号

自定义能力开发（可申请）

开发者根据实际业务场景选择性接入，若有需要群内联系平台运营。

1、自定义引导文案和按钮

引导文案自定义	引导按钮自定义

2、核销形式选择

1、线上抖音小程序核销与扫码核销并列

（不提需求，默认该形式）

2、强化线上抖音小程序核销引导

（二维码和券码仍然存在，但弱化展示效果）

3、仅展示线上抖音小程序

（不支持展示二维码，且弱化保留券码）

小程序模板授权商家

小程序自测&验收

平台验收会按照商家纬度逐一验收，因此虽然用了模板代开发模式，但是仍需要按照单个appid纬度申请验收和提审

参考平台侧验收标准完成小程序自测

申请验收：

方式一：填写问卷小程序核销工具申请验收入口申请验收，提供小程序appid

方式二：群内艾特@张雪莹（餐饮）/@陈雅婷（综合）申请验收，提供小程序appid

常见问题

描述需要开发者注意的常见问题

核销小程序工具能解决哪些问题

餐饮行业

问题类型	抖音核销工具小程序可帮您解决
❌门店排队压力大	✅通过搭建抖音小程序核销工具，消费者在抖音买券以后可以直接在抖音订单中心跳到小程序自助核销，无需到店亮码找店员核销，门店排队压力会被大大分散；店员的精力也被极大释放，可帮助您精简店员人力
❌希望精简店员人力/希望取消POS
❌因“门店缺货”“门店不营业”等问题用户无法前置感知，导致客诉很多	✅通过搭建抖音小程序核销工具，可在小程序内提前展示“门店营业状态”“商品是否售罄”“预计等待时间等”，减少用户到店后没有货、不开门的情况发生，减少客诉量级
❌复杂商品类型核销不顺畅	✅如N选X类型商品，可以通过小程序核销工具顺滑实现选择
❌拿不到会员数据	✅抖音小程序核销工具提供一键授权手机号的能力，用户进入小程序核销的同时可以授权手机号，帮助您打通全渠道会员，实现会员的拉新和数据分析
❌抖音团购券核销率低	✅抖音小程序核销工具可以将整个核销链路缩短，用户全部行为可在抖音顺滑完成，帮助商家提升团购券核销率
❌希望用户可以实现勾选规格（大小杯/辣度/甜度/冰度/锅底等），但当前无法实现	✅抖音小程序核销工具可以自定义核销页面，实现选规格/加小料/加配菜等诉求；也可以在页面定制勾选时间/排队预约/预定包房等工具能力此处额外说明：因平台合规管控等影响，仅可以在页面加小料/配菜，但是不能额外再点一个正价商品；且该页面支持定制工具能力，但是涉及到交易的能力需要额外和平台沟通
❌希望用户可以实现加小料/配菜（加一份珍珠/加一份金针菇），但当前无法实现
❌希望用户可以直接预定到店时间/选座位/预定包房/预定场地等，但当前无法实现

综合行业

	核销工具可解决问题
影院/电影院	1.✅买券后小程序内选座/选影片/选场次 2.✅买券后补差价（特殊档期/特殊影院补差价） 3.✅系统打通 4.✅会员打通
密室/剧本杀/KTV/自助棋牌室	1.✅选场次/预约时间/预约剧本等 2.✅系统打通 3.✅会员打通
到家（保洁、洗衣、维修等）	1.✅提供上门地址、联系电话 2.✅预约上门时间、动态扣减库存 3.✅用户可查询工单进度、服务人员 4.✅系统打通 5.✅会员打通
演出/剧场	1.✅先买后约 2.✅选场次、选座位

核销小工具还有哪些限制？

抖音小程序核销工具仅支持团购券的核销，不支持外卖配送等能力

短期仅可核销“团购券”+“次卡”商品，“代金券”商品需要单独开白，剧场行业可开放“预售券”

微信小程序核销+爆单问题严重商家即将被整治

平台未来将对以下2类商家进行治理，因此该类商家建议尽快搭建抖音小程序核销工具，作为方案替补，提前做好后续规划，减少后续平台整治带来的临时影响

平台将对跳出抖音到端外的商家进行治理，包括但不局限于：

复制券码去微信小程序核销的商家：长线看会将复制券码能力关闭

开通手机号必填组件的商家：长线看不再开通手机号必填白名单，存量也会做调整

同时针对因“缺货”“团购不可用”等问题导致爆单客诉较多的商家，均会进行整治

背景：部分商家因直播等原因，导致订单量超出门店承载能力，导致用户“吃不上”“排队久”“不能用”，最终客诉/退款/差评，后面平台会对该类商家进行治理

建议：建议有该类问题的商家，尽快搭建抖音小程序核销工具，预防“无法感知商品缺货”“无法感知门店是否营业”“无法感知排队进度”等问题，防止被平台治理管控，影响最终经营效果