「小程序券」直播玩法接入指南
一、业务系统介绍
1、业务流程
| 名称 | 说明 |
|---|---|
| 券模板 | 小程序券的结构化信息，包含券名称、券类型、券面值、券使用门槛、库存等信息，通过定义券模版来确定券的玩法。 |
| 券模板库存 | 小程序券在所有渠道下总共可发放的库存数量。 |
| 主播发券发放上限 | 开发者分配给某主播的可发放数量上限，此上限不能超过券模板库存，每个主播都可以被授权不同的上限值。 |
| 发放计划 | 主播在抖音开播端的「小程序券配置页面」中，配置所要发放小程序券模板的库存数量，完成配置时会约定本场直播所发放的数量。 |
| 用户领券 | 抖音用户在直播间领取主播发放的券，同一个用户对同一张券只能领券一次。 |
| 名称 | 描述 | 示例值 |
|---|---|---|
| user_open_id | 用户open_id | Cv4PoJXxxxn63rNu |
| coupon_id | 抖音开平券id | 714860xxxxxxx |
| coupon_meta_id | 抖音开平券模板id | 702345xxxxxxx |
| merchant_meta_no | 商家券模板号 | xxxx |
| talent_open_id | 发券主播open_id | Cv4PoJXxxxn63rNu |
第六步：「核销」券或「撤销核销」券
三、玩法涉及的能力
| 能力包 | 能力模块 | 接口 | HTTP Method | URL 前缀 | HTTP URL | 签名方式 |
|---|---|---|---|---|---|---|
| 小程序券核心能力包 | 券模板管理 | 创建券模板 | POST | https://open.douyin.com/api/promotion/v1/coupon | /create_coupon_meta | 无 |
| 修改券模板 | POST | /update_coupon_meta_param | 无 | |||
| 查询券模板 | POST | /query_coupon_meta | 无 | |||
| 删除券模板 | POST | /delete_coupon_meta | 无 | |||
| 修改券模板库存 | POST | /update_coupon_meta_stock | 无 | |||
| 修改券模板状态 | POST | update_coupon_meta_status | 无 | |||
| 用户券管理 | 用户领券结果回调通知 | POST | - | 签名算法 | ||
| 用户核销券 | POST | /batch_consume_coupon | 无 | |||
| 用户撤销核销券 | POST | /batch_rollback_consume_coupon | 无 | |||
| 查询小程序下用户可用券信息 | POST | /get_coupon_receive_info | 无 | |||
| 小程序券直播能力包 | 主播授权管理 | 主播发券权限配置 | POST | /set_talent_coupon | 无 | |
| 修改主播发券权限 | POST | /update_talent_coupon_status | 无 | |||
| 更新主播发券库存上限 | POST | /update_talent_coupon_stock | 无 | |||
| 查询主播发券配置信息 | POST | /get_talent_coupon | 无 |
四、常见问题
