背景概述
目前美团开放平台对【团购券核销API】入驻门槛极为苛刻,二级等保认证、百万级数据安全审计、企业注册资本限制把绝大多数中小开发者都被挡在了外面。
这就导致了无人棋牌室、无人健身房、无人桌球、无人麻将馆 的预约小程序没法直接核销美团券(这类门店一般还是24h运营的,总不能让人安排客服蹲守)
我们提供成熟的美团券核销接口,成本极低,可以按次消费。
接入方式干净便捷,不侵入业务系统,单纯只做核销
支持连锁品牌、一帐号多店、SaaS系统方便接入
目前3500家无人场馆已经在用我们的接口,一年以来稳定运行,非常靠谱。
主要特点:
零侵入式对接:接口只做核销,干净无侵入,开发者无需改造现有业务系统即可完成接入
多业态支持:支持连锁品牌、一帐号多店、SaaS系统方便接入
成本最低:远低于平台抽佣,重要的是稳定,支持按核销次数付费!
峰值承载:2024年双十一期间成功应对6800QPS的瞬时流量冲击
长期稳定:目前已接入3500家无人棋牌室、无人健身房、无人桌球、无人麻将馆,稳定运行一年
预警系统:预测券码核销趋势,提前预警异常操作
智能路由集群:全国部署的23个BGP节点可智能识别某团服务器区域策略,确保不同大区请求的精准路由
接口设计
1:获取auth token 接口
-
请求方式: POST
-
请求地址: /open/login
-
请求参数:
参数名 | 参数说明 | 备注 |
用户邮箱 | 必填 | |
password | 用户密码 | 必填 |
-
请求示例:
{ "email":"zhangsan@126.com", "password":"1234" }
-
响应参数:
参数名 | 参数说明 | 备注 |
token | 认证token | 用于后续请求头Authorization, 过期时间是1天, 获取多个token互不影响 |
-
响应示例:
{ "code": 10000, "msg": "success", "data": { "id": 9, "phone": "18500511234", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2V123222", "username": "张三" }, "count": 1, "date_time": "2024-12-15 22:08:24" }
2:获取团购券详情接口
-
请求方式: GET
-
请求地址: /open/user/meituan/coupon/detail
-
请求头: Authorization: token
-
⚠️注意 Authorization: token 前面不要带 Bearer
-
请求参数:
参数名 | 参数说明 | 备注 |
store_id | 店铺id | 必填 |
coupon_code | 券码 | 必填 |
-
请求示例:
-
/open/user/meituan/coupon/detail?store_id=1&coupon_code=123456
-
响应参数:
参数名 | 参数说明 | 备注 |
order_id | 订单id | |
sku_id | 商品id | |
price | 订单金额 | |
sku_name | 商品名称 | |
status | 订单状态 | 中文:未使用 和其他 |
status_code | 状态码 | 0未使用 1已使用 |
-
响应示例
{ "code": 10000, "msg": "success", "data": { "order_id": "4971997871483391234", "sku_id": 1206941234, "sku_name": "开业特惠通用畅玩4小时[49.00元][1206941234]", "status": "未使用", "status_code": 0 }, "count": 1, "date_time": "2024-12-16 00:06:04" }
3:核销接口
-
请求方式: POST
-
请求地址: /open/user/meituan/coupon/verify
-
请求头: Authorization: token
-
⚠️注意 Authorization: token 前面不要带 Bearer
-
⚠️注意 业务系统需要对已经核销的券自行记录和拦截; 避免多次核销
-
请求参数:
参数名 | 数据类型 | 参数说明 | 备注 |
store_id | int | 店铺id | 必填 |
coupon_code | string | 券码 | 必填 |
-
请求示例:
{ "store_id":1, "coupon_code":"123456" }
-
响应参数:
参数名 | 参数说明 | 备注 |
verify_message | 核销信息 | 核销失败有原因说明 |
verify_success | 核销状态 | true:成功 false:失败 |
-
响应示例
{ "code": 10000, "msg": "success", "data": { "verify_message": "验证成功", "verify_success": true }, "count": 1, "date_time": "2024-12-16 00:06:04" }