1. 接口列表
mcake开放接口在线文档
  • 接口列表
    • 获取访问令牌
      GET
    • 获取门店列表
      GET
    • 获取附近门店
      GET
    • 获取门店详情
      GET
    • 获取服务城市
      GET
    • 获取城市配置
      GET
    • 获取服务范围
      GET
    • 配送范围校验
      GET
    • 查询配送定价
      GET
    • 获取门店菜单
      GET
    • 获取预约日期
      GET
    • 获取预约时段
      GET
    • 获取商品列表
      GET
    • 获取商品详情
      GET
    • 获取商品库存
      GET
    • 预下单验证
      POST
    • 提交订单接口
      POST
    • 查询订单详情
      GET
    • 取消订单申请
      POST
    • 订单退货申请
      POST
    • 订单回调通知
      POST
  1. 接口列表

取消订单申请

测试中
POST
https://tinterface.mcake.com/openapi/store/order/cancel
最后修改时间:2026-06-13 06:27:25

1. 概述#

可通过本接口主动取消已创建的订单。系统根据订单当前状态自动选择取消路径:
待推单(尚未推送美团):本地直接取消,即时生效
已推送美团(待接单 / 待制作 / 制作中):向门店发送取消申请,等待门店确认

2. cancelStatus 枚举#

成功响应中 data.cancelStatus 字段表示取消结果:
值含义说明
cancelled已取消(终态)订单已确认取消,不可恢复
pending等待门店处理取消申请已发送至门店,最终结果以回调通知为准

3. 注意事项#

1.
pending 状态需配合回调通知:当 cancelStatus 为 pending 时,订单最终是否取消成功取决于门店确认,系统会通过 回调通知 推送最终结果(事件 order_cancelled)。
2.
幂等性:对同一订单重复调用取消接口不会报错,系统会返回当前取消状态的最新结果。
3.
并发保护:订单正在被推送美团时(短暂窗口期),取消请求会返回 订单正在处理中,请稍后重试,请稍后重试即可。

请求参数

Query 参数

Header 参数

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://tinterface.mcake.com/openapi/store/order/cancel?orderNo=132606120037436&reason=%E5%8F%96%E6%B6%88%E5%8E%9F%E5%9B%A0' \
--header 'appAuthToken: 891afd66174754b00953646a0b54c707'
响应示例响应示例
成功示例-已取消
{
    "code": 0,
    "msg": "Success",
    "data": {
        "cancelStatus": "cancelled",
        "message": "订单已取消"
    }
}
修改于 2026-06-13 06:27:25
上一页
查询订单详情
下一页
订单退货申请
Built with