抖音来客OTA对接指南

本文档用于指导技术和运营人员完成票务系统与抖音生活服务平台的对接、商品发布及核销流程。

第一步：抖音开放平台配置

此步骤主要是在抖音的开发者后台完成应用创建和接口权限的开通。

在抖音来客和抖音开放平台完成注册。
登录抖音开放平台，在“应用中心”开通“生活服务”应用。
进入应用详情，点击“开通解决方案”。
勾选开通所需的能力，核心是“团购（三方码）”相关的权限。提交后等待平台审核。

在应用后台设置“三方码回调地址”，将以下地址中的https://系统域名替换为您自己的票务系统域名，并填写到对应输入框中。配置回调地址

# 预下单回调
https://系统域名/ticket/api/dylife/Create

# 支付成功发码回调
https://系统域名/ticket/api/dylife/Pay

# 订单状态查询回调
https://系统域名/ticket/api/dylife/query

# 退款审核回调
https://系统域名/ticket/api/dylife/Refund

# 退款结果通知回调
https://系统域名/ticket/api/dylife/RefundResult

第二步：票务与来客后台配置

此步骤涉及票务系统后台和抖音来客后台，目的是将两边的商品和订单打通。

1. 配置票务系统

在票务系统后台的抖音来客对接配置页面，按实际情况填写开放平台提供的各项参数。

关于“接口验收用例” 此部分配置是为了帮助您快速通过抖音官方的接口上线审核。您需要根据抖音提供的用例，创建专用的测试门票并在此处进行关联，一个用例对应一个门票，不可重复使用。

2. 抖音来客后台配置

绑定应用： 在抖音来客后台，将第一步中创建的开放平台应用进行绑定。
发布商品： 在“商品管理”中，点击“发布商品”。
选择类型： 商品类型选择“团购券”。
填写商品信息： 这是最关键的一步，请务必确保信息填写正确。
- 销售属性： 必须与票务系统中对应门票的属性完全一致。
- 凭证发放： 选择“商家发放凭证”。
- 券码服务商： 选择您在第一步中创建的应用。
- 商家平台商品ID： 填写该门票在票务系统中的唯一编码/ID。
```
**注意：** 用于对接的门票，必须先在票务系统的“售票设置”中，为其勾选“抖音来客”这个销售渠道。
```
提交审核： 填完所有信息后，提交发布，等待平台审核。

第三步：用户购买与核销

用户购买： 商品审核通过上架后，用户即可在抖音App中浏览并购买该门票。
订单同步： 用户支付成功后，订单会自动同步到票务系统中。
到场核销： 用户到达景区后，打开抖音App中的订单详情，出示凭证二维码。景区闸机或手持检票机直接扫描此二维码即可完成核销。核销状态会自动同步回抖音平台。
```
**核销前提：** 请确保已在票务系统的“检票设置”中，为相应的检票设备（如闸机）授权，允许其核销抖音渠道的门票。
```

抖音来客OTA设置