开放平台
行业介绍
KTV行业是口碑本地生活吃喝玩乐中用户“找好玩”的类目。
今天的KTV商家面临着诸多困境。万亿级的泛娱乐市场开启以后，KTV的人口流量红利逐渐被电影产业、游戏产业、旅游度假产业侵蚀， KTV行业可以说是哀鸿遍野，前有KTV鼻祖钱柜在国内关闭13家门店，后有万达旗下的大歌星连锁KTV全面撤场，全国各地KTV纷纷倒闭。转型升级成了KTV的唯一选择，可转型升级又谈何容易！走精品路线？动辄成百上千万的装修成本让人望而却步；搞社交传播？社交传播早已过了红利期，现在一个微博微信半年能攒下5000个粉丝就算相当高效了，更别说用这些粉丝反哺门店生意；附庸团购平台？除去入驻费、推广费、高额的交易抽成，还能剩下多少利润？
口碑旨在用数据和产品帮助线下KTV商家，让KTV没有难做的生意。口碑KTV行业解决方案链接商家和用户，围绕商家，不仅给店铺带来支付宝亿级活跃用户的流量，预订包厢、自助点酒水、在线支付等智慧KTV的解决方案，还提供基于“支付即会员“以及潜客营销的工具。围绕用户，通过主题活动、丰富的内容，培养“上口碑找好玩”的用户心智。
行业特色
口碑的价值：
行业产品功能：
口碑KTV行业与系统商展开以下四个方面的合作，赋能口碑商家：
插件应用案例
开发者可以为商家提供口碑店铺管理、自助点歌/点酒水、在线预订包厢、支付即会员营销等插件的开发。
1. 口碑店铺管理
开发者的商家后台收集商家资料，比如营业执照、门店环境照片、可提供的服务、营业时间等开店基本的信息，获得商家支付宝账号授权后即可通过开店接口创建门店，通过线上门店展示门店环境、地址等信息。
2. 自助点歌/点酒水
KTV的用户主要消费和体验场所是在包厢内，让顾客玩得嗨是KTV留住顾客的经营手段，同时也是拉动酒水的招数。开发者可以为商家提供手机点单功能，提高服务效率。vod系统商可以为商家提供点歌、遥控、互动等丰富的功能，提升顾客的娱乐体验。
3. 在线预订包厢
包厢预订是KTV商家青睐的线上引流锁客的插件，直接为店铺带来订单。开发者可以为商家提供包厢预订服务。
4. 支付即会员CRM
开发者可以基于支付宝的线上用户大数据，为商家提供通过支付沉淀的用户分析用户画像，进行精准营销，商家可以圈定用户发送优惠，优惠投放的渠道可支持口碑首页、行业类目页、店铺详情页、短链接和二维码等。
准入条件
- 有较好的开发能力和地推商务能力，有KTV行业的服务经验；
- 有店铺管理、会员营销、预订、点单等插件应用的实施案例；
- 有意愿与口碑长期合作，后续同意与口碑共享订单数据。
开店接入指南
ISV通过接口帮助商户在口碑完成开店，代运营店铺，获得交易返佣。
详情请参见口碑开店接入指南。
店铺商品发布接入指南
商户如需要在店铺中发布商品或折扣，需要ISV申请营销API接口权限，利用口碑商户活动创建接口发布商品及折扣。
详情请参见营销活动接入指南。
插件接入指南
口碑KTV行业与系统商展开以下合作提供智慧KTV解决方案，直达电梯：
- 自助点酒水/点歌（包厢页）
- 预订包厢
自助点酒水/点歌（包厢页）
插件接入规则
- 口碑设计师给出了包厢页的交互和视觉规范建议，请按版本下载：
豪华版下载豪华版包厢页视觉
极简版下载极简版包厢页视觉 - ISV接入的整体流程详见服务市场管理接入指南。
插件开发流程
使用签约支付宝账号登录open.alipay.com，创建并发布应用，开发流程参考创建应用。
插件开发及验收规则
1. 店铺ID映射：商家订购服务时，支付宝会向服务商应用网关发送订购消息，订单信息里包含商户ID（merchant_pid）和订购的口碑门店ID（shop_id），服务商需建立口碑门店ID（shop_id）与自己系统中店铺ID的关联关系，详见订购通知接口。
2. 用户进入包厢页，有两个入口：
（1） 用户直接用支付宝扫屏幕二维码（豪华版）或者扫桌边二维码（极简版），进入包厢页，如图：
图：屏幕二维码（豪华版）
图：桌边二维码（极简版）
（2） 通过口碑店铺页插件区域“点歌”/“点酒水”插件进入包厢页，点击会传入shop_id和merchant_pid参数，根据传入的shop_id和merchant_pid锁定门店
 |
 |
 |
插件点击请求样例，黄色部分为支付宝自动带上的部分：
http://zzcdtc.oicp.net:25345/index.php/Book/Room/company?shop_id=2016041800077000000015345841&merchant_pid=2088802532857530
3. 用户信息授权获取：进入包厢页面，调用用户信息授权获取会员uid等信息，在后续支付时使用，参考获取用户信息
备注：用户信息共享默认给到以下字段：用户UID、昵称、性别、头像、省份、城市。
4. 在线买单：支付发生在两个地方①在线点酒水支付、②直接买单。使用统一收单交易创建接口（alipay.trade.create），用js唤起收银台完成支付，如图：
备注：参数alipay_store_id必须要传入，用于系统商返佣及全场折扣券的核销，该值为支付宝的口碑店铺编号shop_id，在口碑创建门店即生成。
5. 开放平台云监控jsapi接入：从进入包厢页面（包含口碑店铺+扫码入口）开始到离开，对相关页面进行埋点做数据采集，以便从日志分析访问页面的PV/UV，保障应用的可用性。
引入JSAPI：
<script src="https://os.alipayobjects.com/rmsportal/oknmeDPmBzRhliY.js"></script>
流程码定义如下：
| 插件 | 行业流程 | 流程码 | 说明 |
|---|---|---|---|
| 点歌/点酒水 | 进入商户首页 | ktv_start | 必须 |
| 开始点歌 | ktvsong_start | ||
| 点歌完成 | ktvsong_end | ||
| 开始点餐 | ktvfood_start | ||
| 点餐完成 | ktvfood_end |
6. 测试
- ISV可使用服务窗，在服务窗配置插件功能页链接，带上shop_id与merchant_id参数，进行访问测试相关功能，例如：
http://www.test.net/index.php/Book/Room/company?shop_id=2016041800077000000015341234&merchant_pid=2088802532851234 - 可参考开放平台测试账号及门店申请流程申请测试门店。
- 如有疑问请联系技术支持。
7. 验收审核
请ISV逐条检查以下项目，确认后再提交审核。
- 用户端视觉符合口碑UI视觉规范；
- 只包含插件提供的功能，不得包含非口碑官方的商家信息页面、外卖、会员等页面；
- 点击店铺详情页插件按钮直接进入功能页面，不存在中间无关页面；
- 提供功能取消入口，取消后提供再来一单入口；
- 用户提交订单成功后可清晰查看订单详情和所有订单列表页，包含已取消订单；
- 验证已订购插件的门店与ISV后台系统实现映射，确保门店已开通功能，无能存在用户点击插件后无法使用的情况。
预订包厢
插件接入规则
- 口碑设计师给出了包厢预订的交互规范建议，请下载：
包厢预订交互规范 - ISV接入的整体流程详见服务市场管理接入指南。
插件开发流程
使用签约支付宝账号登录open.alipay.com，创建并发布应用，开发流程参考创建应用。
插件开发及验收规则
1. 店铺ID映射：商家订购服务时，支付宝会向服务商应用网关发送订购消息，订单信息里包含商户ID（merchant_pid）和订购的口碑门店ID（shop_id），服务商需建立口碑门店ID（shop_id）与自己系统中店铺ID的关联关系，详见订购通知接口。
2. 根据shop_id展现对应店铺预订页面：用户在店铺商家详情页插件区域点击预订时，跳转客户端访问地址并带上shop_id和merchant_pid参数，根据传入的shop_id和merchant_pid，打开对应店铺的预订页面。例如从口碑店铺“银乐迪（文三店）”点击预订按钮，打开的一定是银乐迪（文三店）的预订页面。
插件点击请求样例，黄色部分为支付宝自动带上的部分：
http://zzcdtc.oicp.net:25345/index.php/Book/Room/company?shop_id=2016041800077000000015345841&merchant_pid=2088802532857530
3. 用户信息授权获取：进入包厢页面，调用用户信息授权获取会员uid等信息，在后续支付时使用，参考获取用户信息
备注：用户信息共享默认给到以下字段：用户UID、昵称、性别、头像、省份、城市。
4. 下单支付：确认预订订单后，提交支付，调用统一收单交易创建接口（alipay.trade.create）创建订单，用js唤起收银台支付。
备注：参数alipay_store_id必须要传入，用于系统商返佣及全场折扣券的核销，该值为支付宝的口碑店铺编号shop_id，在口碑创建门店即生成。
5. 开放平台云监控jsapi接入：从进入预订页面开始到完成预订结束，对相关页面进行埋点做数据采集，以便从日志分析访问页面的PV/UV，保障应用的可用性。
引入JSAPI：
<script src="https://os.alipayobjects.com/rmsportal/oknmeDPmBzRhliY.js"></script>
流程码定义如下：
| 插件 | 业务流程 | 流程码 | 说明 |
|---|---|---|---|
| 在线预订 |
进入商户页面 | booking_start | 必须 |
| 选择活动 | booking_acitvity | ||
| 查看活动详情 | booking_detail | ||
| 提交订单 | booking_order | ||
| 订单支付 | booking_pay | ||
| 订单结束 | booking_end | 必须 |
6. 测试
- ISV可使用服务窗，在服务窗配置插件功能页链接，带上shop_id与merchant_id参数，进行访问测试相关功能，例如：
http://www.test.net/index.php/Book/Room/company?shop_id=2016041800077000000015341234&merchant_pid=2088802532851234 - 可参考开放平台测试账号及门店申请流程申请测试门店。
- 如有疑问请联系技术支持。
7. 验收审核
请ISV逐条检查以下项目，确认后再提交审核。
- 用户端视觉符合口碑UI视觉规范；
- 只包含插件提供的功能，不得包含非口碑官方的商家信息页面、外卖、会员等页面；
- 点击店铺详情页插件按钮直接进入功能页面，不存在中间无关页面；
- 提供功能取消入口，取消后提供再来一单入口；
- 用户提交订单成功后可清晰查看订单详情和所有订单列表页，包含已取消订单；
- 验证已订购插件的门店与ISV后台系统实现映射，确保门店已开通功能，无能存在用户点击插件后无法使用的情况。
本接口及文档资料由口碑提供。您使用本接口，需要遵守开放平台相关协议及口碑要求。
