麦门券力透视 真实数据 · 全链路实测

麦麦省的券谁都能领,但领了不等于楼下那家店认。本页所有数字来自 2026-10-23 用真实麦当劳 MCP 账号跑完的整条链路,无一处虚构。

一张券要过三道门

同一天、同一账号、北京三里屯 5 家门店的实测漏斗。每过一道门都会安静地少一部分,接口不会主动提示。

5
可领记录
available-coupons
→
5
实际领取(5 个 couponId)
auto-bind-coupons
→
4
进入卡包
query-my-coupons
→
2
当天可核销
query-store-coupons
两处静默损耗:免费脆薯饼领取成功却没进卡包(接口不给原因);另外 2 张券有效期从 10-26 才开始,当天核销不了。

券后实付(calculate-price 真实返回)

金额单位为分,展示时 ÷100。取餐方式返回堂食 / 外带两种。

商品productCode券前券后省状态
麦辣鸡腿汉堡 1440 22.5 元 11.9 元 10.6 元 可核销
王牌炸鸡任选 2 9900016534 23.8 元 19.9 元 3.9 元 可核销
免费脆薯饼 — — — — 领取成功但未进卡包

逐店校验:同一批券,5 家门店都认

北京三里屯周边 5 家门店的 query-store-coupons 返回完全一致——这两张是通用券。矩阵的价值要在有门店限制的券上才显现,但校验逻辑必须先在。

门店距离storeCode当天可用券
麦当劳北京长虹桥餐厅628 m19510662
麦当劳北京团结湖餐厅933 m19500502
麦当劳北京吉市口东路(佳汇中心)餐厅1351 m19510272
麦当劳北京工体北路餐厅1355 m19500852
麦当劳北京东大桥餐厅1397 m19500062

四个接口不会告诉你的事实

「一张券」的唯一标识是 couponId,不是券名

领取返回 5 条记录 = 5 张券、5 个不同 couponId。「11.9 元麦辣鸡腿堡」出现两次是两个不同活动(一批 10-23 截止、一批 10-26 开始)。按券名去重会把两张真券合并成一张。

菜单编码 ≠ 计价编码

券的适用商品 9900016534 不在 query-meals 菜单里,但 calculate-price 照常算出 23.8 → 19.9 元。不能用菜单存在性判断券可不可用。

卡包为空时,按门店查必为空

query-store-coupons 是「已持有 ∩ 该店可核销」,不是「该店全部可用券」。空卡包 + 有效门店 1951066 → 返回 []。必须先领券再查门店。

门店经纬度是废的

5 家店全部返回 longitude: 0.0、latitude: 0.0,唯一有效的是 distance(米)。想拿坐标画地图的写法都会失败。