景区预售券能力

能力背景

通过抖音已有的底层交互的接口体系构建，在此基础上对外开放景区预售券的 openAPI，使更多的 SaaS 服务商、渠道商家能够自行接入，将商户预售商品资源快速接入到抖音。

能力介绍

什么叫景区预售券？

景区预售券是针对景区类商家开放的、支持用户“先买券，后预约入园”，且依靠在线预约能力实现的一种抖音原生商品类型。

用户视角的预售券交易链路说明

用户链路	示意图（非真实信息，仅做示例使用）
用户购买【景区预售券】
用户线上预约【景区预售券】
预约后等待商家确认及收取入园信息
用户自行线上退款链路（未预约随时退）

接入前期准备

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

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

自研：自研商家接入指南

需要申请的能力

在应用详情中，点击解决方案，选择对应的解决方案申请开通。审核时效 3 个工作日。

门店查询 / 三方码 / 团购核销 / 订单查询 / SPU 信息发布 / 商品查询 / 商品发布 / 日历属性发布 / 预订信息查询 /

PS 若预约量级比较大，可单独和对接的业务提出对接预置码

商家/服务商回调地址配置

1. 使用SPI回调

系统已支持线上配置 SPI，技术服务商可线上配置，参考SPI 签名机制

涉及接口：预售券-下单通知、预售券-支付通知、预售券-退款通知、预售券-试预约、预售券-创预约单、预售券-取消预约单、三方码-发放凭证、三方码-凭证回调、三方码-核销、三方码-撤销核销

配置路径：开放平台-服务商平台/开发者平台-控制台-应用详情页-开发设置-SPI 回调

2. 使用webhook推送
   

已支持在开发设置中线上配置 webhook，参考webhook 消息推送

涉及接口：商品审核结果通知

配置路径：开放平台-服务商平台/开发者平台-控制台-应用详情页-开发设置-webhooks

功能流程简介

底层系统交互流程

1. 商品流程

2. 购买预售券
   
   

• 预约流程

• 取消流程

订单状态	取消流程
未预约	用户可发起预售券退款
已预约未核销	用户不可发起退款。 用户可联系抖音客服，抖音客服联系商家协商，商家同意则可取消预约or退款。
已预约已核销	客服无法取消。 商家线下处理。

对接接口

1. 商品接口

接口	接口路径	调用方
创建适用人群	https://open.douyin.com/goodlife/v1/poi/crowd/save/	商家/服务商
创建/更新票种信息-MSPU	https://open.douyin.com/goodlife/v1/goods/spu/save/	商家/服务商
查询商品模版接口	https://open.douyin.com/goodlife/v1/goods/template/get/	商家/服务商
创建/更新商品接口 （预订商品和预售商品）	https://open.douyin.com/goodlife/v1/goods/product/save/	商家/服务商
创建/更新多SKU商品的SKU列表	https://open.douyin.com/goodlife/v1/goods/sku/batch_save/	商家/服务商
查询商品审核数据（含基础信息）	https://open.douyin.com/goodlife/v1/goods/product/draft/get/	商家/服务商
查询商品审核通过的线上数据	https://open.douyin.com/goodlife/v1/goods/product/online/get/	商家/服务商
保存日历库存接口	https://open.douyin.com/goodlife/v1/goods/calendar_stock_group/save/	商家/服务商
保存日历价格接口	https://open.douyin.com/goodlife/v1/goods/calendar_amount_group/save/	商家/服务商
上下架商品	https://open.douyin.com/goodlife/v1/goods/product/operate/	商家/服务商

2.购买预售券接口

接口	接口路径	调用方
下单接口（预售券-SPI）	地址由服务商提供	抖音
支付结果通知（预售券-SPI）	地址由服务商提供	抖音
退款成功状态通知（预售券-SPI）	地址由服务商提供	抖音
创预约单（SPI）	地址由服务商提供	抖音
取消预约单（SPI）	地址由服务商提供	抖音
查询预约单	https://open.douyin.com/goodlife/v1/trade/book/get/	商家/服务商

3.预约接口

接口	接口路径	调用方
发放凭证（同步发券-SPI）	地址由服务商提供	抖音
凭证回调（异步发券）	https://open.douyin.com/goodlife/v1/fulfilment/create/callback/	商家/服务商
核销（验券）	https://open.douyin.com/goodlife/v1/fulfilment/certificate/verify/	商家/服务商
撤销核销	https://open.douyin.com/goodlife/v1/fulfilment/certificate/cancel/	抖音
取消预约单（SPI）	地址由服务商提供	抖音
查询预约单	https://open.douyin.com/goodlife/v1/trade/book/get/	商家/服务商