无限聚核 无限聚核开放平台 API Documentation
API Reference 开发者后台 →
API v2.0 · 服务运行中

无限聚核开放平台
团购核销 API

面向棋牌室、台球厅、健身房、酒店民宿、茶室、练舞房、自助洗车、K歌等无人自助业态，提供美团、抖音团购券核销接口服务。仅需对接 3 个接口，即可实现快速接入，大幅缩短部署周期，团购平台资金快速回流。

美团已接入 抖音已接入 3 个核心接口
进入开发者后台 → 查看 API 文档
API Host https://open.elys.cn

所有接口的请求地址前缀

Content-Type application/json

所有接口请求头统一格式

成功状态码 code: 10000

其他 code 值均为失败

⚠️
重要注意事项
1. API Host: https://open.elys.cn
2. 所有接口请求头: Content-Type: application/json
3. 返回 code: 10000 为成功，其他为失败

快速接入

按业务流程串联 V2 接口即可完成核销能力对接。

1

登录获取 Token

调用 POST /api/hexiao/v2/login，使用邮箱与密码换取 token，后续接口放在 Authorization: Bearer … 中。

2

首次授权（按需）

调用 POST /api/hexiao/v2/get/auth/url，按 platform（1 美团 / 2 抖音）获取对应平台的授权链接，完成授权后再验券。

3

验券 → 核销

先 ddzh-tuangou-receipt-prepare 拿到 ticketInfo，再调用 ddzh-tuangou-receipt-consume 完成核销；查询在售用 ddzh-tuangou-deal-queryshopdeal。

统一返回结构

所有接口遵循同一套外层字段，便于统一处理。

成功时：

JSON
{
  "success": true,
  "code": 10000,
  "message": "success",
  "traceId": null,
  "data": {}
}

失败时常见形式：

JSON
{
  "success": false,
  "code": 10001,
  "message": "错误信息"
}
通用字段说明
字段说明
shopId系统内门店 ID；授权、验券、查团购等均使用。
platform1 美团，2 抖音；可传字符串 "1" / "2"。
ticketInfo字符串，来自「验券前检查」；核销时必须原样传回。

接口详情

以下为 Hexiao V2 全部开放接口说明。

POST /api/hexiao/v2/login 登录 无需 Bearer

使用注册邮箱与密码登录，返回用户信息与会话 token。本接口不需要 Authorization 头。

请求参数
参数类型必填说明
emailstring是登录邮箱
passwordstring是登录密码
请求示例
JSON
{
  "email": "user@example.com",
  "password": "123456"
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "success",
  "data": {
    "user": {
      "id": 9,
      "name": "示例用户",
      "email": "user@example.com",
      "phoneNumber": "13800000000"
    },
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}
POST /api/hexiao/v2/get/auth/url 美团 抖音 获取授权链接 通用

需登录态。按 platform 返回对应平台的授权 URL，用于开店宝 / 抖音来客等授权流程。

请求头
HTTP
Authorization: Bearer <token>
请求参数
参数类型必填说明
shopIdnumber | string是门店 ID
platformnumber | string是1 美团，2 抖音；可传字符串 "1" / "2"
请求示例
JSON
{
  "shopId": 123,
  "platform": 1
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "OK",
  "traceId": "691400000000000001",
  "data": "https://example.com/auth?token=example"
}
POST /api/hexiao/v2/store/create 创建门店 通用

创建主门店或子门店。传入 shopId 时表示在已有门店下创建子门店；adminUserId 可选，缺省为当前用户。

请求头
HTTP
Authorization: Bearer <token>
请求参数
参数类型必填说明
shopNamestring是门店名称
shopIdnumber | string否有则表示子门店
adminUserIdnumber | string否归属管理员 ID
请求示例（主门店）
JSON
{
  "shopName": "示例门店",
  "adminUserId": 9
}
请求示例（子门店）
JSON
{
  "shopName": "示例子门店",
  "shopId": 123,
  "adminUserId": 9
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "success",
  "data": {
    "shopId": 10001,
    "name": "示例门店",
    "shopKey": "ABCDEF",
    "providerShopId": 2000001
  }
}
POST /api/hexiao/v2/store/delete 删除门店 通用

删除指定门店；需具备对应门店访问权限。

请求头
HTTP
Authorization: Bearer <token>
请求参数
参数类型必填说明
shopIdnumber | string是门店 ID
adminUserIdnumber | string否操作者；缺省为当前用户
请求示例
JSON
{
  "shopId": 10001,
  "adminUserId": 9
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "删除成功",
  "data": {
    "shopId": 10001
  }
}
POST /api/hexiao/v2/ddzh-tuangou-receipt-prepare 验券前检查 预检

传门店、平台与券码，返回票价信息与 ticketInfo。美团/抖音对外统一结构；ticketData 部分平台可能为空字符串。

请求头
HTTP
Authorization: Bearer <token>
请求参数
参数类型必填说明
shopIdnumber | string是门店 ID
platformnumber | string是1 美团，2 抖音
codestring是券码
请求示例
JSON
{
  "shopId": 123,
  "platform": 2,
  "code": "0106803637807"
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "success",
  "traceId": "2026040518025671DC47D0CC1663E68012",
  "data": {
    "payAmount": 7990,
    "shopId": "7441782134131394611",
    "ticketName": "【不限时段】畅玩5小时",
    "ticketInfo": "{\"verifyToken\":\"edcfd7a8-...\"}",
    "ticketData": "",
    "groupPayType": 1
  }
}
POST /api/hexiao/v2/ddzh-tuangou-receipt-consume 确认核销 核销
⚠️
ticketInfo 必须与验券前检查返回完全一致。

返回数组，每一元素为一次核销结果。

请求头
HTTP
Authorization: Bearer <token>
请求参数
参数类型必填说明
shopIdnumber | string是门店 ID
platformnumber | string是1 / 2
ticketInfostring是预检返回
codestring是券码
numnumber | string否核销数量，默认 1
请求示例
JSON
{
  "shopId": 123,
  "platform": 2,
  "ticketInfo": "...",
  "code": "0106803637807",
  "num": 1
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "履约成功",
  "traceId": "20260405180323EAC4753A33B03DFA328B",
  "data": [
    {
      "bizType": 0,
      "dealTitle": "【不限时段】畅玩5小时",
      "receiptCode": "180886072740962",
      "dealPrice": 79.9,
      "orderId": "1093364371426903131"
    }
  ]
}
POST /api/hexiao/v2/ddzh-tuangou-deal-queryshopdeal 查询门店团购商品 在售

分页查询门店在售团购，美团与抖音统一 Deal 列表结构。

请求头
HTTP
Authorization: Bearer <token>
请求参数
参数类型必填说明
shopIdnumber | string是门店 ID
platformnumber | string是1 / 2
offsetnumber | string否页码，默认 1
limitnumber | string否每页条数，默认 10
sourcenumber | string否业务来源，默认 1
请求示例
JSON
{
  "shopId": 123,
  "platform": 2,
  "offset": "1",
  "limit": "10",
  "source": "1"
}
响应示例
Response
{
  "success": true,
  "code": 10000,
  "message": "success",
  "traceId": "202604051814407E5A0C7AC78468AD445D",
  "data": [
    {
      "dealId": "1816849307970587",
      "title": "【不限时段】畅玩5小时",
      "price": 79.9,
      "marketPrice": 92,
      "saleChannelName": "抖音"
    }
  ]
}

推荐调用顺序

按场景串联接口，减少无效重试。

A

核销流程

1）login 取 Token → 2）如需首次授权，调用 meituan/get/auth/url（按 platform 获取美团 / 抖音授权链接）→ 3）receipt-prepare 取 ticketInfo → 4）receipt-consume 完成核销。

B

查询在售

1）login → 2）ddzh-tuangou-deal-queryshopdeal 拉取门店团购列表。

常见问题

排错时可按下列项自查。

登录失败

检查邮箱、密码是否正确，请求体是否为合法 JSON。

提示缺少登录态

确认请求头已带 Authorization: Bearer <token>（登录接口除外）。

ticketInfo 从哪里来

仅由「验券前检查」返回，核销时原样传入，勿自行改写。

返回「门店不存在」

核对 shopId，并确认当前用户对门店有访问权限。

返回「未找到可用的服务商门店映射」

检查门店是否完成对应平台配置、授权或初始化。