# 云飞API — 全平台团购券码核销 API

> 官网 https://yunfeiapi.com/ 的 Markdown 版本，供搜索引擎与大语言模型读取。最后更新：2026-11-16

云飞API 由上海云飞网络科技工作室运营，为中小软件企业提供美团、大众点评、抖音、快手四大平台的团购券码核销 API。一套接口统一验券、核销、撤销，接入调试免费，商用按核销成功计费。

- 覆盖平台：美团、大众点评、抖音、快手
- 覆盖行业：6 大行业 30+ 业态
- 服务规模：全国 20000+ 商户
- 性能：平均响应 200ms 以内，99.9% 可用性 SLA
- 计费：低至 0.05 元/券，按核销成功次数扣费

---

## 零、产品线与品牌关系

同一运营主体（上海云飞网络科技工作室）下有两个对外产品：

- **云飞API**（本网站）：面向开发者的团购核销接口，用于把核销能力接入自有系统。
- **来客核销**（微信小程序）：移动端工作台，在微信内核销券码、申请开发者账号、查看应用余额，无需开发即可使用。详见 https://yunfeiapi.com/laike

「来客核销」与字节跳动的「抖音来客」无隶属关系。抖音来客是抖音面向商家的经营平台；来客核销是云飞API 的微信小程序。

---

## 一、核心能力

### 1. 团购券码核销 API

支持美团、大众点评、抖音、快手团购券码的验券与核销，全平台统一接口协议，返回结构一致。

- 统一验券、核销、撤销流程
- 多平台错误码归一处理
- 支持传入扫码得到的原始内容
- 核销成功后返回后续撤销所需的凭证
- 在平台允许的时限内可撤销核销

适用：顾客到店出示券码或扫码，商户系统调用接口完成核销，随后自动发放店内权益。

### 2. 团购产品查询 API

查询美团、抖音、快手平台在售的团购产品信息，支持按门店与商品维度批量获取。

- 按门店批量拉取在售套餐
- 用于团购套餐与店内权益的映射配置
- 支持定时同步，保持套餐信息一致

### 3. 申请应用开户

企业提交资质资料开通核销 API 权限，开户成功后即可对接全平台券码核销接口。

- 提供免费测试额度
- 对接完成后按量充值
- 提供专属技术支持

---

## 一之二、美团核销关键事实

整理自美团技术服务合作中心公开文档，查阅日期 2026-11-16，实际以官方后台为准。

| 事项 | 事实 |
|---|---|
| 业务线 | 服务零售与到店餐饮两套接口互不通用，餐厅不能照搬非餐饮路径 |
| 核销步骤 | 验券准备（只读）→ 验券（写），不能跳步；准备成功不等于已核销 |
| 撤销时限 | 美团约 10 分钟且限当天 / 抖音约 1 小时 / 快手 1 小时 |
| 券码格式 | 12 位数字；配置 bin 码则为 77 前缀 14 位；撤销后码会更换 |
| 保证金 | 服务商侧 10 万元，可退但资金占压 |
| 安全材料 | WAF 必选；等保证明与网络安全保险二选一 |
| 主体要求 | 团购核销仅对接企业主体，个人不开放 |
| 操作限制 | 单次核销上限 99 张；撤销只能逐张 |

---

## 二、接入流程

1. **提交企业资料** — 在线提交资质资料申请应用开户，审核通过后开通接口权限。
2. **获取密钥与文档** — 拿到 API 密钥与完整接口文档，同时获赠免费测试额度。
3. **对接联调上线** — 按文档完成对接与联调，测试额度内可反复验证，完成后再充值。

最快 1 天可完成对接。接口为标准 RESTful 协议，HTTPS 传输，在服务端发起 HTTP 请求即可，现有业务系统与数据库结构无需改动。

---

## 三、收费标准

### 3.1 计费规则

- 按券核销成功扣费，每成功核销一张券扣一次费用。
- 按张券计费，一笔订单含多张券时按张扣费。
- 接入与调试阶段不收取费用。
- 开户赠送免费测试额度，对接完成后再充值。
- 预充值模式，充值档位越高单价越低。
- 不收取接入费、开户费或保证金。
- 充值额度不过期，长期有效。

### 3.2 充值档位

| 充值金额 | 单价（元/券） | 首充赠送 | 可核销次数 |
|---|---|---|---|
| 200 元 | 0.5 | — | 400 张 |
| 500 元 | 0.3 | — | 1,666 张 |
| 800 元 | 0.15 | — | 5,333 张 |
| 1500 元（推荐） | 0.1 | 送 100 元，到账 1600 元 | 16,000 张 |
| 8000 元 | 0.08 | — | 100,000 张 |
| 15000 元 | 0.06 | — | 250,000 张 |

### 3.3 按规模选档建议

- **初创门店 / 流量少**：800 元档，0.15 元/券，可核销约 5300 张券，额度不过期。
- **连锁商户 / 多门店**：1500 元档，0.094 元/券，充 1500 送 100 到账 1600 元，可核销 16000 张券。
- **渠道商 / 大流量**：8000 元档，0.08 元/券，可核销 10 万张券。

---

## 四、接入优势

- **毫秒级核销响应**：全平台统一网关，平均响应 200ms 以内，99.9% 可用性 SLA，支持高并发。
- **零侵入标准接入**：RESTful API 标准对接，无需改动现有系统架构，提供各语言调用示例。
- **全平台全业态**：同时接入美团、大众点评、抖音、快手，覆盖 6 大行业 30+ 细分业态。

---

## 五、行业覆盖

| 行业 | 覆盖业态 |
|---|---|
| 餐饮美食 | 火锅、烧烤、中餐、西餐、日料、自助餐等 |
| 酒店住宿 | 酒店、民宿、度假村、公寓等多类型住宿产品 |
| 旅游景点 | 景区门票、一日游、主题乐园、展览演出等 |
| 休闲娱乐 | KTV、密室逃脱、剧本杀、网吧、桌游、棋牌、台球等 |
| 运动健身 | 健身房、游泳馆、瑜伽馆、球类运动场馆等 |
| 生活服务 | 洗浴足浴、美容SPA美发、洗车保养、家政清洁、宠物服务等 |

## 五之二、行业解决方案

按业态组织的场景化方案，说明每个业态「核销之后接什么」：

| 业态 | 核心能力 | 核销后衔接 | 适用 |
|---|---|---|---|
| 零售团购核销 | 多平台一套接入，统一验券/核销/撤销 | 会员权益、预约占位、门锁开启、设备启动 | 自助洗车、健身房、台球厅、门店 SaaS |
| 餐饮团购核销 | 套餐券接点餐、代金券接结账，凭据可追溯 | 出餐流程、每日对账、撤销处理 | 扫码点餐、餐饮收银、连锁餐饮系统 |
| 体育馆预订 | 核销后读取剩余场次并生成预约 | 预约系统、闸机、签到 | 羽毛球馆、游泳馆、篮球馆、体育中心 |
| 棋牌预订 | 到店即用或先订包间，核销与库存联动 | 包间状态、入场开门 | 棋牌室、茶楼、桌游吧、台球棋牌综合体 |
| KTV 预订 | 现场开台或提前订房，读取实时房态 | 开台入场、点歌系统、包厢设备 | 量贩 KTV、商务 KTV、迷你歌咏亭 |

统一模式：平台负责带来顾客，商户系统保留顾客体验。核销成功后由商户系统继续衔接会员、预约、门禁与设备。

## 五之二、行业解决方案

按业态组织的场景化方案，说明每个业态「核销之后接什么」：

| 业态 | 核心能力 | 核销后衔接 | 适用 |
|---|---|---|---|
| 零售团购核销 | 多平台一套接入，统一验券/核销/撤销 | 会员权益、预约占位、门锁开启、设备启动 | 自助洗车、健身房、台球厅、门店 SaaS |
| 餐饮团购核销 | 套餐券接点餐、代金券接结账，凭据可追溯 | 出餐流程、每日对账、撤销处理 | 扫码点餐、餐饮收银、连锁餐饮系统 |
| 体育馆预订 | 核销后读取剩余场次并生成预约 | 预约系统、闸机、签到 | 羽毛球馆、游泳馆、篮球馆、体育中心 |
| 棋牌预订 | 到店即用或先订包间，核销与库存联动 | 包间状态、入场开门 | 棋牌室、茶楼、桌游吧、台球棋牌综合体 |
| KTV 预订 | 现场开台或提前订房，读取实时房态 | 开台入场、点歌系统、包厢设备 | 量贩 KTV、商务 KTV、迷你歌咏亭 |

统一模式：平台负责带来顾客，商户系统保留顾客体验。核销成功后由商户系统继续衔接会员、预约、门禁与设备。

---

## 五之三、接入指南（长尾问答）

每篇回答一个具体问题，可按需引用。

| 主题 | 分类 | 一句话结论 |
|---|---|---|
| [美团团购核销接口怎么申请](https://yunfeiapi.com/articles/meituan-groupbuy-api-application) | 申请与资质 | 先决定自己申请还是接第三方，再准备材料。两条路径的资质门槛、时间成本与后续运维负担完全不同，选错会白走一遍流程。 |
| [团购核销接口多少钱](https://yunfeiapi.com/articles/groupbuy-api-cost) | 费用与保证金 | 问「多少钱」得到的答案往往是单价，但真正决定成本的是保证金占压、测评费用与两套适配层的长期维护。这篇把隐形成本摊开。 |
| [接团购核销需要二级等保吗](https://yunfeiapi.com/articles/groupbuy-api-mlps-requirement) | 申请与资质 | 等保不是必答题，而是一道选择题 —— 官方要求是「等保证明或网络安全保险」二选一，前提是 WAF 已具备。走第三方接口时这道题直接不成立。 |
| [美团 10 万保证金是什么](https://yunfeiapi.com/articles/meituan-100k-deposit) | 费用与保证金 | 保证金不是费用，是占压。它可退，但在退之前一直占着你的现金流 —— 这和小团队对「钱」的直觉不一样。 |
| [快手团购核销怎么接](https://yunfeiapi.com/articles/kuaishou-groupbuy-api) | 开发实战 | 快手是四大平台里资料最少的一个。这篇把平台码模式的必接接口、幂等机制与撤销规则讲清楚，并对照美团、抖音说明哪里不能复用代码。 |
| [团购券核销错了能撤销吗](https://yunfeiapi.com/articles/groupbuy-redemption-revoke) | 开发实战 | 能撤，但有时限，而且三个平台时限不一样。超时之后平台侧就关掉了这条路，只能线下退给顾客 —— 所以撤销凭证必须在核销成功的那一刻就存下来。 |
| [美团验券准备和验券的区别](https://yunfeiapi.com/articles/meituan-verify-prepare-vs-consume) | 开发实战 | 很多人把这两个当成一个接口的两个名字，结果卡在「查不到券」或者「核了但没权益」。它们一个只读、一个写，顺序不能颠倒，返回的东西也不能丢。 |
| [美团券码格式与 77 前缀](https://yunfeiapi.com/articles/meituan-coupon-code-format) | 开发实战 | 券码不是统一 12 位。有些商家返回 14 位、带 77 前缀 —— 这跟商家配置有关，不是接口异常。按 12 位硬校验会把正常券判成非法。 |
| [美团核销返回异常排查](https://yunfeiapi.com/articles/meituan-redeem-response-anomaly) | 开发实战 | 这四个现象看起来都像接口坏了，其实都有明确解释。搞清楚属于哪一类，能省掉几小时的无效排查。 |
| [自助洗车店怎么接团购核销](https://yunfeiapi.com/articles/self-car-wash-groupbuy-redemption) | 行业落地 | 顾客扫码验券后机器没启动，是自助洗车最典型的投诉。根因几乎都是把「核销成功」和「设备启动」写进了同一个逻辑里 —— 这两件事中间还隔着两层。 |
| [24 小时自助健身房怎么接团购](https://yunfeiapi.com/articles/24h-gym-groupbuy-access-control) | 行业落地 | 健身房的团购券分体验券和次卡，核销逻辑完全不同。更麻烦的是门禁：如果门禁直接读券状态，券一退款顾客就进不来了——哪怕他还有 20 次没用。 |
| [自助台球厅怎么接团购](https://yunfeiapi.com/articles/billiards-hall-groupbuy-open-table) | 行业落地 | 台球厅的团购通常绑时长，但真实使用几乎总会超时。核销只解决「这张券能用」，超时、锁台、临时续费都要靠本地系统——这部分平台接口管不了。 |
| [羽毛球馆怎么接团购](https://yunfeiapi.com/articles/badminton-court-groupbuy-booking) | 行业落地 | 场馆类团购和零售最大的不同：顾客买了券还得挑时间。如果先核销再让他去预约，一旦没场地就得退款——正确顺序是先占场、后核销。 |
| [美团与点评门店ID怎么查](https://yunfeiapi.com/articles/meituan-dianping-shop-id-lookup) | 开发实战 | 门店ID填错是接入阶段最高频的配置问题，表现是「券查得到但核销失败」或者「提示门店不匹配」。九成的填错都能归到五种情况里，其中一种是把 32 位的北极星门店串当成了美团门店ID。 |
| [微信小程序接入团购核销](https://yunfeiapi.com/articles/wechat-miniapp-groupbuy-redemption) | 开发实战 | 小程序端不碰密钥、不碰平台凭据，只跟自己的服务端说话。这个边界一旦划清，后面九成的问题都不会发生。 |
| [美团核销错误排查](https://yunfeiapi.com/articles/meituan-redeem-error-codes) | 开发实战 | 同一个错误码可能对应好几种原因，同一个原因也可能返回不同的码。按来源分类比背码表有效得多。 |
| [抖音团购核销接口怎么申请](https://yunfeiapi.com/articles/douyin-groupbuy-api-application) | 申请与资质 | 已经接了美团，不代表抖音能用同一套代码。主体、授权、接口命名三处都不一样，其中门店授权模式差别最大。 |
| [团购核销门店授权](https://yunfeiapi.com/articles/groupbuy-shop-authorization) | 开发实战 | 授权不是技术单方面能完成的动作 —— 它需要商家账号确认。把这一点想清楚，流程设计才不会卡在「为什么调不通」。 |
| [餐饮团购核销接口怎么接](https://yunfeiapi.com/articles/dining-groupbuy-redemption-api) | 行业落地 | 拿自助洗车那套接口去接餐厅，第一行就通不过 —— 餐饮走的是另一条业务线，接口前缀都不同。 |
| [多张团购券怎么核销](https://yunfeiapi.com/articles/multiple-coupons-one-redemption) | 开发实战 | 「订单」和「券」不是一对一。搞不清这层关系，就会出现「核销成功了但只出了一份餐」。 |
| [团购核销怎么对账](https://yunfeiapi.com/articles/groupbuy-redemption-reconciliation) | 费用与保证金 | 「核销成功」只说明券被用了，不说明钱对得上。三方口径不一致时，差异往往出在退款、撤销与代金券实收。 |
| [团购核销接口幂等设计](https://yunfeiapi.com/articles/groupbuy-redemption-idempotency) | 开发实战 | 超时不等于失败。请求可能已经在平台生效了，只是响应没回来 —— 这是重复核销最主要的来源。 |
| [团购核销接口怎么选](https://yunfeiapi.com/articles/groupbuy-api-selection) | 费用与保证金 | 三条路都能核销，但代价差得很远。选错的成本通常不是钱，是三个月后发现要推倒重来。 |
| [没有营业执照能接团购核销吗](https://yunfeiapi.com/articles/no-license-groupbuy-redemption) | 申请与资质 | 平台侧的答案是明确的：需要对公主体。但对个人开发者和小团队，仍有几条路可走 —— 只是每条路的限制不同。 |
| [SaaS 多商户团购核销](https://yunfeiapi.com/articles/saas-multi-merchant-groupbuy) | 行业落地 | 一家店接核销和一百家店接核销，差别不在代码量，在于授权、映射和计费三件事的结构对不对。 |
| [团购核销结果回调与事件推送](https://yunfeiapi.com/articles/groupbuy-redemption-callback) | 开发实战 | 回调不是「比同步返回更高级」的东西。它解决的是线下核销、异步处理这类同步返回覆盖不到的场景。 |
| [北极星开放平台迁移](https://yunfeiapi.com/articles/beijixing-open-platform-migration) | 开发实战 | 如果你的系统是几年前接的，代码里调的是 tuangou.receipt.prepare、库里存着 session 和 open_shop_uuid —— 这三样都得换。 |
| [抖音团购核销资质要求](https://yunfeiapi.com/articles/douyin-qualification-requirements) | 申请与资质 | 四项条件全部落在同一家公司身上。其中一项只能等，补不了材料 —— 先看清是哪一项，再决定备料顺序。 |
| [顾客自助查券核销](https://yunfeiapi.com/articles/customer-self-redemption-miniapp) | 开发实战 | 店员核销只要有门店授权就够；顾客自己核销，还要顾客先授权你查他的券。这一层不加，接口根本调不通。 |
| [场馆类业态接团购核销](https://yunfeiapi.com/articles/venue-multiplatform-groupbuy) | 行业落地 | 场馆卖的不是「一次进门」，而是「某个时段的某个位置」。核销只是开始，真正的难点是券与场次的映射。 |
| [美团与抖音核销接口差异](https://yunfeiapi.com/articles/meituan-douyin-redeem-difference) | 开发实战 | 把美团的实现改个域名就去接抖音，是接入期最常见的返工来源。六处差异里，有三处会直接导致核销失败。 |
| [代金券的实收金额怎么算](https://yunfeiapi.com/articles/dining-voucher-settlement-amount) | 行业落地 | 「核销成功」只说明券被用了。至于这笔该给商家多少钱，是另外四个数在决定 —— 而这四个数最容易被当成同一个。 |
| [扫码点餐怎么接团购核销](https://yunfeiapi.com/articles/scan-to-order-groupbuy-redemption) | 行业落地 | 顾客扫桌台码点餐，付钱时才想起自己有团购券 —— 这时候让他退出小程序去别处核销，单就丢了。 |

---

## 六、常见问题

### 云飞API支持哪些平台的团购券码核销？

目前已支持美团、大众点评、抖音、快手四大主流本地生活平台的团购券码核销接口，通过统一 API 网关实现一站式对接，无需分别接入各平台。

### 团购券码核销 API 的接入流程是怎样的？

接入流程分三步：① 提交企业资料申请应用开户；② 获取 API 密钥和接口文档；③ 根据文档完成对接调试。接入和调试阶段不收取任何费用，最快 1 天完成对接。

### 核销接口的响应速度和稳定性如何？

提供 99.9% 可用性 SLA 保证，平均响应时间在 200ms 以内，支持高并发请求，已稳定服务全国超过 20000 家商户。

### 支持哪些行业的团购券核销？

覆盖餐饮美食、酒店住宿、旅游景点、休闲娱乐（KTV、密室逃脱、剧本杀等）、运动健身、生活服务（美容美发、洗浴足浴、宠物服务等）六大行业，超过 30 种细分业态。

### 接入核销 API 需要多少费用？

接入接口不收费。正式商用后按核销券码成功计费，低至 0.05 元/券，充值档位越高单价越低。开户赠送免费测试额度。

### 接入需要改造现有系统吗？

不需要。接口为标准 RESTful 协议，在服务端发起 HTTP 请求即可，现有业务系统与数据库结构无需改动。核销成功后由商户系统继续衔接会员权益、预约、开门或设备启动等环节。

### 是否支持撤销核销？

支持。在平台允许的时限内可撤销已核销的券码，需使用核销时返回的凭证发起撤销请求。

### 充值的额度会过期吗？

不会。充值额度长期有效，不设有效期，不因时间推移清零。额度耗尽后可自行决定是否继续充值，未续充不影响已购额度的使用。

### 开户需要交开户费或保证金吗？

不需要。云飞API 不收取接入费、开户费与保证金，注册、申请应用、获取密钥均不产生费用，仅在实际核销成功后按次扣费。平台对开发者收取的 10 万元保证金由云飞API 统一承担，接入方不必缴纳，也无需冻结资金。

### 接入你们的接口，我们还需要自己做二级等保吗？

不需要。平台侧的技术对接与安全合规责任由云飞API 作为接口服务方承担；接入方的系统只是接口调用方，不直接与平台侧接口对接，因此不必为这类业务单独做等级保护测评。这对中小软件团队意味着省下一笔测评成本与数周整改周期。若招标或客户要求提供合规材料，可配合出具接口服务说明与安全责任划分说明。

### 团队规模小，能接得动吗？

可以。接口为标准 HTTP 协议，只提供验券、核销、撤销等必要能力，半天即可完成首次跑通。同时提供 AI 辅助接入：把接口文档交给 AI 编程工具，可直接生成带签名与重试逻辑的调用代码，最快 5 分钟拿到第一个成功响应。调试阶段不收费，跑通后再决定是否充值。

---

## 七、关于我们

上海云飞网络科技工作室成立于 2019 年，专注软件开发与行业解决方案，自研本地生活 SaaS 系统，为餐饮、休闲娱乐、运动健身等行业提供团购核销与门店数字化服务。

持续在同一个方向上迭代：把平台流量与商户自有业务系统之间的那一层，做薄、做稳、做透明。

### 发展历程

- **2019** — 上海云飞网络科技工作室成立，专注企业级软件开发与系统集成服务。
- **2021** — 自研本地生活 SaaS 系统，为餐饮、休闲娱乐等行业提供全场景团购核销解决方案。
- **2023** — 服务全国 20000+ 商户，覆盖美团、大众点评、抖音等多平台券码核销场景。
- **2024** — 推出云飞API统一核销网关，支持美团、抖音、快手全平台团购验券 API 一站式接入。
- **2025** — 持续迭代核销接口产品，致力于成为本地生活领域领先的第三方 API 服务提供商。

---

## 八、联系我们

- 商务合作邮箱：aoyanfei@yunfeiwork.com
- 商务合作电话：18201986514
- 企业微信：访问官网扫描二维码添加商务经理
- 运营主体：上海云飞网络科技工作室（上海）
- 备案号：沪ICP备2023040075号-6

### 相关链接

- 官网首页：https://yunfeiapi.com/
- 收费标准：https://yunfeiapi.com/pricing
- 美团核销专题：https://yunfeiapi.com/meituan
- 餐饮核销专题：https://yunfeiapi.com/dining
- 常见问题：https://yunfeiapi.com/faq
- 接口文档：https://gitee.com/yunfeiwork/tuangou-java/wikis/Home
- 文档中心：https://doc.yunfeiapi.com/
- 技术支持：https://doc.yunfeiapi.com/9034139m0
- SDK 与示例：https://gitee.com/yunfeiwork/tuangou-java
- 共享空间 SaaS：https://wspace.yunfeiwork.com/
- 面向 AI 的摘要：https://yunfeiapi.com/llms.txt
