团购核销能力

我的收藏

业务场景

针对没有自己的券码平台和服务商的商家，对接抖音券，通过和店内 POS 机等核销系统打通来核销团购券，有以下优势：

降低店内收银设备/平台的操作成本，提升商家效率。

核销信息统一到收银系统，无需补录团购订单。

抖音端团购账单并入商家账单，方便商家统一对账。

适用行业

团购核销能力适用于以下行业解决方案。

•

•

•

•

接入前期准备

根据以下文档完成开发者账号开通认证、生活服务应用的创建、申请解决方案和接口权限。

•

技术服务商：技术服务商接入指南

•

自研：自研商家接入指南

需要申请的能力

门店管理、团购核销对账。

门店管理、团购核销对账和团购核销共存于到综行业解决方案、酒店行业预售券解决方案、景区行业解决方案和到店餐饮解决方案中，因此可在解决方案中一并选择并申请开通。

登录服务商平台。

在右上角点击「控制台」，在「我的应用」页面选择「生活服务商家应用」，然后点击目标应用。

在应用左侧导航栏点击「解决方案」，在「解决方案」页面相关行业解决方案的「操作」列点击「查看详情」。

在目标行业解决方案面板中选择「门店管理」、「团购核销」和「团购核销对账」，以及其它所需的能力，点击「申请开通」。

在「填写使用场景」对话框中填写相关能力的使用场景及理由，点击「确定」。

等待平台审核。审核通过后，即可以使用相关能力。

业务流程

整体核销流程

核销次卡说明

（1）创建商品时，商品类型选择次卡，其余配置与团购券一致。

（2）次卡对接时调用接口不变，各接口针对次卡做了适配调整点：

接口	调整说明
验券准备接口	返回中增加 `time_card` 字段（总次数、已使用次数）
验券接口	支持次卡商品一次核销请求核销多份；多次卡商品可以一次请求只核销一份，如果需要一次核销多份，在 list 中传入多个相同 `encrypted_codes`
撤销核销接口	支持次卡商品按次数撤销核销，增加`times_card_cancel_count`和 `cancel_token` 字段

接口列表

能力	接口路径	接口说明
团购核销	验券准备	抖音团购券码核销需要先调用本接口查询订单券列表，选择待核销券后再调用验券接口
	验券	支持抖音团购券码和三方券码核销，抖音券码需先调用准备接口，三方券码可直接调用
	撤销核销	支持抖音团购券码和三方券码的误核销撤销，订单状态由已使用回退为待使用，有效期为核销后1小时
	券状态查询	在核销异常场景下查询抖音团购券码和次卡券状态
	券状态批量查询	批量查询抖音券码和三方券码的状态

测试方案

在线上环境创建投放渠道为“仅直播间可见”的商品，进行下单、核销、退款测试。

FAQ

是否可以支持部分退？

答：一笔订单购买多张券时，未核销的券可以进行退款。

一张券是否可以验证多次？

答：不可以。

一笔订单，最多可以购买几张券？

答：10 张。

一笔订单，是否有多个团购？

答：一笔订单只有 1 个团购，可以购买多份（多张券）。

核销后支持撤销核销吗？

答：支持，1 小时内可以撤销核销，超过 1 小时无法发起撤销核销。