文档中心 > 开放平台

插件开发指南

更新时间:2017/06/30 访问次数:50820

ISV可以开发各类功能插件(即服务),例如:店铺管理、商品管理、店铺装修等,发布到服务市场售卖。商户可直接购买符合自己运营需求的插件快速完成业务功能开发。

ISV通过口碑服务市场发布的服务可以收费,具体收费费率以ISV自定义为准。

插件应用案例

行业 可提供插件 插件应用案例
餐饮 点菜、排队、预定、打赏、游戏等 餐饮行业插件应用案例
休闲娱乐 口碑开店、营销活动代运营、支付即会员、会员营销和预约等 休闲娱乐行业插件应用案例
摄影 口碑开店、营销活动代运营、支付即会员、会员营销和预约到店、选套餐、看客片等 摄影行业插件应用案例
亲子 口碑开店、营销活动代运营、支付即会员、场地预订、课程预约、签到等 亲子行业插件应用案例
运动健身 口碑开店、营销活动代运营、支付即会员、场地预订、课程预约、签到等 运动健身行业插件应用案例
洗衣 口碑开店、营销活动代运营、支付即会员、会员营销和预约取衣等 洗衣行业插件应用案例
丽人 口碑开店、支付即会员、手艺人预约等 丽人行业插件应用案例
KTV 口碑店铺管理、自助点歌/点酒水、在线预订包厢、支付即会员营销等 KTV行业插件应用案例

插件接入规则

  1. 口碑设计师给出了插件的视觉规范建议,请下载插件设计规范
  2. 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. 消息触达:预订成功、取消预订应通过服务窗发送消息通知或通过短信发送通知,消息提醒服务可在服务窗后台申请模板消息,请参考服务窗消息通知。消息提醒支持两种接入方式,一种是通过ISV官方服务窗通知(如“华佗驾到”),第二种是在商户自己的服务窗通知(如“华夏良子”服务窗)。ISV应在订单成功页提供关注服务窗的入口以确保用户可以接收到消息提醒
关注服务窗的跳转链接:
alipays://platformapi/startapp?appId=20000047&publicId=服务窗的appid
此处appId为固定值20000047请勿修改

4. 开放平台云监控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

必须

5. 测试

  • ISV可使用服务窗,在服务窗配置插件功能页链接,带上shop_id与merchant_id参数,进行访问测试相关功能,例如:
    http://www.test.net/index.php/Book/Room/company?shop_id=2016041800077000000015341234&merchant_pid=2088802532851234
  • 可参考开放平台测试账号及门店申请流程申请测试门店
  • 如有疑问请联系技术支持。

6. 验收审核

  • 请ISV逐条检查以下项目,确认后再提交审核。
  • 用户端视觉符合口碑UI视觉规范;
  • 只包含插件提供的功能,不得包含非口碑官方的商家信息页面、外卖、会员等页面;
  • 点击店铺详情页插件按钮直接进入功能页面,不存在中间无关页面;
  • 提供功能取消入口,取消后提供再来一单入口;
  • 用户提交订单成功后可清晰查看订单详情和所有订单列表页,包含已取消订单;
  • 验证已订购插件的门店与ISV后台系统实现映射,确保门店已开通功能,不能存在用户点击插件后无法使用的情况。

FAQ

关于此文档暂时还没有FAQ
返回
顶部