1. 🚩关联美团门店
云飞API(来客核销)
  • API接口
    • 📱 商务合作
    • 💁 技术支持
    • 🤖AI快速接入
    • 接入前准备【必看】
      • 🤖 AI 辅助开发指南
      • OpenAPI接口调用约定
      • 申请应用开户【必看】
      • 生成accessToken
      • 💰 查询应用余额
      • 生成accessToken
    • 团购核销
      • 接入前必看
      • 🚩常见问题汇总【必看】
      • 🚩常见响应码表【开发必看】
      • 📖更新日志
      • 门店
        • 已关联门店查询
        • 设置回调通知地址
        • 🚩关联美团门店
          • 0.快速接入美团门店指引【必看】
          • 1.应用绑定美团门店
          • 1.1.设置门店授权成功回调通知地址【可选】
          • 2.生成美团门店授权码【必看】
          • 2.1.美团门店授权成功回调【可选】
          • 美团门店解除授权
          • 美团门店同步结果回调通知
          • 美团服务零售客户授权结果回调通知
          • 查询已授权美团服务零售客户
            POST
        • 🚩关联抖音门店
          • 0.快速接入抖音门店指引【必看】
          • 1.抖音门店授权步骤【必看】
          • 2.应用绑定抖音门店
        • 🚩关联快手门店
          • 1.快手门店授权步骤【必看】
          • 应用绑定快手门店
      • 商品
        • 获取门店团购信息
      • 团购核销API
        • 查券和验券
        • 撤销验券
        • 批量撤销验券
        • 手机号查询可用团购券
        • 团购退款预校验
        • 团购退款申请
        • 团购退款信息查询
        • 团购退款审核
      • 订单服务API
        • 订单券码分摊金额查询
        • 查询团购订单结算扩展明细
  1. 🚩关联美团门店

0.快速接入美团门店指引【必看】

📌
避免浪费大家的宝贵时间,各位开发者对接前请务必先认真仔细阅读一遍文档~

🚩服务零售客户授权#

第一步#

仅支持到店综合(即服务零售)类门店可采取此方式完成授权,此方式暂不支持到店餐饮门店
先确认是否开户( 点我立即申请开户 ),开户前先必须先确认应用类型 ( 点我查看确认开户应用类型 )

第二步#

请选择适合你的授权,请仔细阅读下方关于授权的说明
📌
1、如果你只需要核销券码的能力,则授权方式选择:1.服务零售门店同步 ➡️ 2.服务零售(门店)授权 这两步操作完成即可
2、未完成门店同步及授权:如果你核销API、订单API、预定API这些能力,则依次完成授权方式:1.服务零售门店同步 ➡️ 2.服务零售(门店)授权 ➡️ 3.服务零售(客户)授权 这三步操作完成即可
3、已完成门店同步及授权:如果你需要 订单API 能力,则需要完成 3.服务零售(客户)授权
授权方式请复制下方授权URL到浏览器打开
1.服务零售门店同步http://wspacebot.yunfeiwork.com/wspace-openapi/partner/anon/meituan/sync-shop?appId=替换成你在来客核销小程序里申请的appId&partnerState=合作方传入(可选)
2.服务零售(门店)授权https://wspace.yunfeiwork.com/auth-api/partner/anon/meituan/get-auth-url?appId=替换&opPoiId=替换
3.服务零售(客户)授权http://wspacebot.yunfeiwork.com/wspace-openapi/partner/anon/meituan/ddzhkh-authorize?appId=替换成你在来客核销小程序里申请的appId&partnerState=合作方传入(可选)

1.服务零售门店同步#

用于扫码授权后自动同步美团门店至云飞API侧并生成门店(opPoiId),无须再手动提交美团门店信息
partnerState字段格式要求,不能有下划线 _;合作方自定义字段,同步完成时,此值会回值给合作方。主要作用是防止跨站请求伪造(CSRF)攻击;辅助能力用于保持请求和回调之间的状态,可用此参数映射合作方自己的唯一标识

2.服务零售(门店)授权#

完成门店同步后,如果你只需要团购验券核销、撤销券码、预订、评价等接口的权限,可选择此授权方式完成授权即可
注意:opPoiId是云飞API侧生成门店ID

3.服务零售(客户)授权#

以下是官方相关说明文档
partnerState字段格式要求,不能有下划线 _;合作方自定义字段,授权完成时,此值会回值给合作方。主要作用是防止跨站请求伪造(CSRF)攻击;辅助能力用于保持请求和回调之间的状态,可用此参数映射合作方自己的唯一标识
如果你想获取更多的接口权限,例如 订单服务API、商品服务API、商家券API、通用预约API 等接口的使用权限你可以选择此授权方式
⚠️注意:服务零售(门店)授权 和 服务零售(客户)授权是互相隔离的,互不影响
扫码授权说明:https://developer.meituan.com/docs/biz/biz_2023243_0b27b26a-0026-40fa-90f1-c56e8f3167d0
scope参数说明:https://developer.meituan.com/docs/biz/biz_2023243_3ad0b0e7-01d4-40a8-8a3f-2e6f6ae32f23

第三步(敲重点,仔细看完)#

⚠️请使用电脑浏览器打开链接,用美团经营宝app的管理员账号扫码,切记同步门店一定需要管理员账号扫码才能完成,普通账号权限不足无法完成同步
🚩授权URL不是接口地址,打开是一个网页!!如需集成可开发者可自行内嵌至你方系统
接下来就是操作授权步骤,请开发者或商家朋友仔细看完后再进行操作
1.扫码界面 使用美团经营宝app的管理员账号扫码
ddzhkh_1.png
2.扫码成功界面,注意这个只是扫码成功并不是完成了授权,这个页面不能关闭,关闭授权就中断了
ddzhkh_2.png
3.扫码后在美团经营宝app内看到的界面,请按照提示操作
3.1 服务零售(门店)授权: 点我查看生成美团门店授权码
3.2 服务零售(客户)授权:
image.png
4.在美团经营宝app内才做完成后,等待2秒左右浏览器的界面会自动展示授权成功
ddzhkh_3.png
4.1 如果你只是服务零售门店同步,至此门店同步已完成,可前往 来客核销 小程序查看或调用 已授权门店查询 接口,注意此时只是将门店同步至云飞API侧,还需完成门店授权,门店核销授权 点我查看生成美团门店授权码

使用云飞侧API接口关联美团门店#

第一步#

先确认是否开户,开户前先必须先确认应用类型,区分到店综合(即服务零售)、到店餐饮;查看确认开户应用类型
调用接口需要先完成开户,获取应用配置(appId、appSecret)用于获取调用接口的accessToken 去生成accessToken

第二步#

调 应用绑定美团门店 接口,将美团门店信息提交至云飞侧创建门店,即生成门店ID(opPoiId)

第三步【可选】#

调 设置门店授权成功回调通知地址 此接口可选,如果你需要云飞API通知你商家已完成授权,则提交你方通知地址,反之可忽略此步骤,你方可调用 已授权门店 接口来查看商家是否完成授权

第四步#

去 生成美团门店授权码,注意这里不是接口,是一个授权码的网页链接

第五步【可选】#

若开发者已经设置门店授权成功回调通知地址,则云飞API侧会在商家完成授权操作后通知你方,你方需要按照回调接口的格式实现接口即可,反之忽略此步骤

使用云飞侧【来客核销】小程序关联美团门店#

📌
如果开发者不想通过接口绑定,也可通过云飞侧【来客核销】小程序提交资料来绑定门店,如下图所示
image.png
小程序里面的门店ID就是 opPoiId
image.png
修改于 2026-11-03 07:54:52
上一页
设置回调通知地址
下一页
1.应用绑定美团门店
Built with