避免浪费大家的宝贵时间,各位开发者对接前请务必先认真仔细阅读一遍文档~
🚩服务零售客户授权#
第一步#
仅支持到店综合(即服务零售)类门店可采取此方式完成授权,此方式暂不支持到店餐饮门店
第二步#
1、如果你只需要核销券码的能力,则授权方式选择:1.服务零售门店同步 ➡️ 2.服务零售(门店)授权 这两步操作完成即可2、未完成门店同步及授权:如果你核销API、订单API、预定API这些能力,则依次完成授权方式:1.服务零售门店同步 ➡️ 2.服务零售(门店)授权 ➡️ 3.服务零售(客户)授权 这三步操作完成即可3、已完成门店同步及授权:如果你需要 订单API 能力,则需要完成 3.服务零售(客户)授权
1.服务零售门店同步#
用于扫码授权后自动同步美团门店至云飞API侧并生成门店(opPoiId),无须再手动提交美团门店信息
partnerState字段格式要求,不能有下划线 _;合作方自定义字段,同步完成时,此值会回值给合作方。主要作用是防止跨站请求伪造(CSRF)攻击;辅助能力用于保持请求和回调之间的状态,可用此参数映射合作方自己的唯一标识
2.服务零售(门店)授权#
完成门店同步后,如果你只需要团购验券核销、撤销券码、预订、评价等接口的权限,可选择此授权 方式完成授权即可
3.服务零售(客户)授权#
partnerState字段格式要求,不能有下划线 _;合作方自定义字段,授权完成时,此值会回值给合作方。主要作用是防止跨站请求伪造(CSRF)攻击;辅助能力用于保持请求和回调之间的状态,可用此参数映射合作方自己的唯一标识
⚠️注意:服务零售(门店)授权 和 服务零售(客户)授权是互相隔离的,互不影响
第三步(敲重点,仔细看完)#
⚠️请使用电脑浏览器打开链接,用美团经营宝app的管理员账号扫码,切记同步门店一定需要管理员账号扫码才能完成,普通账号权限不足无法完成同步
🚩授权URL不是接口地址,打开是一个网页!!如需集成可开发者可自行内嵌至你方系统
接下来就是操作授权步骤,请开发者或商家朋友仔细看完后再进行操作
1.扫码界面 使用美团经营宝app的管理员账号扫码

2.扫码成功界面,注意这个只是扫码成功并不是完成了授权,这个页面不能关闭,关闭授权就中断了

3.扫码后在美团经营宝app内看到的界面,请按照提示操作3.2 服务零售(客户)授权:

4.在美团经营宝app内才做完成后,等待2秒左右浏览器的界面会自动展示授权成功

4.1 如果你只是服务零售门店同步,至此门店同步已完成,可前往 来客核销 小程序查看或调用 已授权门店查询 接口,注意此时只是将门店同步至云飞API侧,还需完成门店授权,门店核销授权 点我查看生成美团门店授权码 使用云飞侧API接口关联美团门店#
第一步#
先确认是否开户,开户前先必须先确认应用类型,区分到店综合(即服务零售)、到店餐饮;查看确认开户应用类型 调用接口需要先完成开户,获取应用配置(appId、appSecret)用于获取调用接口的accessToken 去生成accessToken 第二步#
调 应用绑定美团门店 接口,将美团门店信息提交至云飞侧创建门店,即生成门店ID(opPoiId) 第三步【可选】#
第四步#
第五步【可选】#
若开发者 已经设置门店授权成功回调通知地址,则云飞API侧会在商家完成授权操作后通知你方,你方需要按照回调接口的格式实现接口即可,反之忽略此步骤
使用云飞侧【来客核销】小程序关联美团门店#
如果开发者不想通过接口绑定,也可通过云飞侧【来客核销】小程序提交资料来绑定门店,如下图所示
小程序里面的门店ID就是 opPoiId
