美团配送 API 开通操作步骤

目标：把现在人工在美团叫骑手的流程，改成小程序订单确认后，由系统自动询价、创建美团配送单，并同步骑手配送状态。

这里要申请的是 “美团配送技术服务合作中心”，不是普通的“美团外卖商家开放平台”。

一、先准备申请资料

正式操作前，先准备好以下信息：

1. 门店及主体资料

美团官方协议说明，申请过程中可能要求提交营业执照、法人或申请人身份证明、授权委托书、开发人员真实身份信息等材料，具体以申请页面和美团工作人员要求为准。

2. 提前整理业务情况

联系客服时需要讲清楚：

餐饮类原则上属于可配送品类，但是否能够接入、所在区域是否覆盖，仍以美团最终审核和合作确认结果为准。

二、先联系美团配送客服确认资格

建议不要一上来就让程序员开发，先确认单门店能否申请 API。

官方联系方式

以上联系方式来自美团配送技术服务合作中心官方页面。

拨打电话后，说明要咨询：

美团配送 API 接入、技术服务合作中心接入，不是普通外卖店铺运营问题。

可以直接对客服这样说

你好，我们是一家轻食单门店，每天大约有 30 个自有渠道订单。

订单主要来自自己的小程序或微信，目前是店员手动在美团叫配送。我们自己有技术开发能力，希望接入美团配送 API，实现系统自动询价、创建配送单、取消配送单和同步骑手状态。

请帮忙确认一下，我们所在城市和门店地址是否支持单门店直接申请美团配送 API，以及需要联系哪位业务经理办理。

必须向客服确认的问题

  1. 所在城市和门店地址是否支持美团配送 API；
  2. 单门店、日均约 30 单能否申请；
  3. 应该注册“企业或单门店客户”还是其他类型；
  4. 当前人工叫配送的账号能否继续使用；
  5. 是否需要重新签订配送合同；
  6. 是否需要预充值；
  7. 配送费如何计算；
  8. 有没有最低单量或月度消费要求；
  9. 能否提供测试账号、测试门店和测试环境；
  10. 是否会安排当地业务经理或技术人员对接；
  11. 需要准备哪些营业资质；
  12. 正式申请入口和当前最新版技术文档在哪里。

美团官方说明，不同城市的配送覆盖范围需要以最终合作确认结果为准，配送费用方案也需要根据实际业务情况与工作人员确认。

联系客服后的记录

记下以下内容：

三、注册美团配送技术服务合作中心

在浏览器搜索并进入：

美团配送技术服务合作中心

进入官方页面后，点击“注册”。

官方注册页面目前提供：

单门店自己使用接口叫配送，通常选择：

我是企业或单门店客户

官方页面确实提供了“企业或单门店客户”注册入口。

注册时注意

  1. 使用店家本人、法人或企业长期使用的手机号注册；
  2. 不要使用临时手机号；
  3. 不建议直接使用外包程序员的手机号注册；
  4. 企业名称要和营业执照一致；
  5. 门店名称、地址要和实际经营地址一致；
  6. 联系人要能够接听美团审核电话；
  7. 邮箱填写长期可用的邮箱；
  8. 注册密码和验证码由店家自己保管。

美团官方规则要求注册和资质信息真实有效，并规定账户、AppKey 和 Secret 不应随意出借、转让或泄露。

四、提交“申请接入”

注册登录后，在管理中心查找类似入口：

具体菜单名称可能随着页面版本调整，以登录后的实际页面为准。

填写申请信息时，可以这样描述业务：

本公司经营轻食餐饮单门店，目前日均约 30 个自有渠道配送订单。订单来自自有微信小程序及私域客户，目前由工作人员人工创建美团配送订单。现申请接入美团配送 API，实现配送能力校验、配送询价、创建配送单、取消配送单、配送状态回调及骑手信息同步，仅用于本公司门店订单配送。

申请类型建议

提交完成后：

美团官方公布的标准接入流程包括：提交接入申请、审核签订协议、完成认证授权、领取 AppKey 和 Secret、进行接口开发。

五、配合审核和签订协议

提交申请后，美团可能通过电话、短信、邮件或业务经理联系。

按要求补充：

需要重点确认合同中的内容：

  1. 配送服务产品；
  2. 配送范围；
  3. 配送计价方式；
  4. 高峰期、天气等加价规则；
  5. 取消订单费用；
  6. 赔付和货损规则；
  7. 充值或账期结算方式；
  8. 发票开具方式；
  9. API 使用范围；
  10. 门店上线条件；
  11. 客服及异常处理方式。

不要在合同和资质审核完成之前，就认为注册账号等于已经获得正式发单权限。

六、获取接口账号和门店信息

审核和合作手续完成后，向美团业务或技术人员索取：

美团官方规则显示，一个应用总账号通常可以获得一套正式 AppKey、Secret，以及一套测试 AppKey、Secret；单个应用账号也可以管理多个门店账号。

安全提醒

AppKey 可以提供给开发人员配置，但 Secret 必须重点保护：

七、把资料交给开发人员

需要交给开发人员的资料包括：

美团提供的资料

门店提供的资料

开发人员应以“美团配送技术服务合作中心”当前的新文档为准。旧的 open/doc 文档页面已经标注“不再维护，请查看新文档”，不要直接根据网上多年前的博客或旧接口文档开发。

八、第一期开发哪些功能

第一期不要直接做完全无人值守，建议先做“店员确认后一键叫美团”。

最低需要实现：

  1. 配送能力校验；
  2. 配送范围查询；
  3. 预发单或配送询价；
  4. 创建配送单；
  5. 查询配送单；
  6. 取消配送单；
  7. 配送状态回调；
  8. 配送异常回调；
  9. 骑手姓名和电话显示；
  10. 配送失败重新尝试；
  11. 人工配送降级入口；
  12. 请求和返回日志。

美团当前开发文档目录包含订单创建、取消订单、查询状态、订单状态回调、异常回调、预发单、配送能力校验、门店配送范围及骑手位置等能力。

九、推荐的实际下单流程

建议第一阶段使用：

顾客提交订单
→ 店家确认订单和收款
→ 店员确认预计出餐时间
→ 系统查询配送费
→ 店员点击“一键叫美团”
→ 系统创建配送单
→ 骑手接单
→ 骑手取货
→ 配送完成

稳定运行后再调整为：

店家确认订单
→ 系统根据备餐时间自动等待
→ 预计出餐前自动叫美团
→ 发单失败时通知店员人工处理

日均 30 单不建议第一天就完全自动发单，应先观察地址准确率、配送费、备餐时间和骑手到店时间。

十、联调测试清单

正式上线前，至少测试：

系统需要避免因为店员连续点击或网络超时而创建两个配送单。

十一、正式上线方式

建议分三步上线。

第一阶段：人工确认、一键发单

店员确认订单后点击“一键叫美团”，系统完成询价和发单。

第二阶段：半自动发单

店员选择预计出餐时间，系统到指定时间自动发单。

第三阶段：自动发单

系统根据商品制作时间、订单时间和配送距离自动决定发单时间。

上线初期必须保留原来的人工叫配送方式。当自动发单失败、运力不足、余额不足或接口异常时，可以立即切换人工处理。

十二、最容易踩的坑

  1. 申请成“美团外卖订单接口”，而不是“美团配送 API”；
  2. 用程序员个人手机号注册店家的正式账号；
  3. 还没确认接入资格就开始完整开发；
  4. 使用网上旧版接口文档；
  5. 没有拿到测试门店 ID 就直接测试正式环境；
  6. 把 Secret 写进小程序前端；
  7. 用户提交订单后立即叫骑手，导致骑手到店但餐还没做好；
  8. 没有处理重复发单；
  9. 没有实现取消配送功能；
  10. 自动发单失败后没有人工处理入口；
  11. 收货地址只有文字，没有准确经纬度；
  12. 没有保存美团请求和返回记录。

最终执行顺序

按照下面的顺序操作：

① 准备营业执照、门店和业务资料
② 拨打 400 055 6100 确认单门店接入资格
③ 获取业务经理或技术人员联系方式
④ 注册美团配送技术服务合作中心
⑤ 选择“企业或单门店客户”
⑥ 提交接入申请
⑦ 配合资质审核
⑧ 确认配送价格和结算方式
⑨ 签订配送合作协议
⑩ 获取测试 AppKey、Secret 和测试门店 ID
⑪ 开发并完成测试订单联调
⑫ 获取正式门店 ID 和正式密钥
⑬ 先上线“一键叫美团”
⑭ 稳定后再开启自动发单