1. 团购核销
云飞API(来客核销)
  • API接口
    • 📱 商务合作
    • 💁 技术支持
    • 接入前准备
      • OpenAPI接口调用约定
      • 申请应用开户
      • 生成accessToken
      • 💰 查询应用余额
    • 团购核销
      • 接入前必看
      • 更新日志
      • 常见问题汇总
      • 门店
        • 应用绑定美团门店
        • 生成美团门店授权码
        • 抖音门店授权步骤
        • 应用绑定抖音门店
        • 已授权门店查询
        • 设置门店授权成功回调通知地址
        • 美团门店授权成功回调
        • 单一门店评论数据查询
      • 商品
        • 获取门店团购信息
      • 团购验券
        • 查券和验券
        • 按券查询待入账账单
  1. 团购核销

常见问题汇总

Q:支持哪些行业?#

接口支持 到店综合(服务零售)、到店餐饮 类的门店均可接入使用
覆盖范围:洗车、棋牌、台球、KTV、自习室、舞蹈室、健身房、宠物(洗宠机、宠物超市等等)、自助打印机设备、扫码器设备等、烘焙行业(面包店)、服务零售行业(超市、租赁业务等)、美业(美甲、美发、美容)、密室、攀岩馆、餐饮门店等等。
🚩若以上没有您的业务范围可 【点我添加商务企业微信】

Q:如何自动区分美团券和抖音券#

美团、大众点评的券码是 <=13 位长度 (注:因服务零售方向美团交易券码发券量逐年增长,现有的十位券码号即将使用耗尽,自2025年7月起,券码位数逐步由原来的10位升级到13位,9月30日之后正式升级为13位券码,为避免对您的业务造成影响,请根据自身系统情况,确认本次位数升级是否产生影响,如影响请在2025年6月30日前自行按期完成改造。如有问题请提交工单或联系您的对接运营,感谢您的支持和配合。)
抖音分两种情况:1、券码扫码识别出来的是 https 的短链接;2、复制的券码是 15 位长度

Q:接口支持抖音识别出的短链核销#

接口支持抖音短链核销,短链传如 receiptCode 字段
注意:短链不能是全小写的,请保持原始短链传入我们接口

Q:美团门店扫授权码后提示失败#

检查提交的门店管理员账号是不是正确的,若不正确重新提交 查看绑定美团门店所需基础资料
确认是否修改过管理员账号的账密,修改账密(账号名或密码)后会导致已授权的门店全部失效,若修改过账号名请主动联系我方技术进行同步

Q:查券和验券接口 verifyCount 字段如何传值#

查券和验券接口传值: type=1 时表示你查券,此时不会执行验券逻辑,入参可以不传 verifyCount,此时接口返回的 verifyCount 表示你有几张券可以验证。
查券和验券接口传值: type=2 时表示你确定要验券,此时会执行验券逻辑,入参传的 verifyCount 表示你要验几张券,这个时候你可以自己传数量,如果你没传默认就是将查券返回的数据量自动填上提交给美团接口完成核销

Q:如何配置Maven拉取#

你可以点我查看settings.xml配置,或者按照以下指南自行配置。
步骤一:设置仓库凭证
请在 settings.xml 文件<servers></servers>中设置以下仓库的访问凭证,通常settings.xml在$HOME/.m2/文件目录下。
<servers>
  <server>
    <id>tuangou-java</id>
    <username>6775f438d497cd558d6307ba</username>
    <password>7x9I6tkB]mKv</password>
  </server>
</servers>
步骤二:配置仓库和包信息
在settings.xml文件<repositories></repositories>节点中加入对应的仓库使用地址。
<repositories>
  <repository>
    <id>tuangou-java</id>
    <url>https://packages.aliyun.com/692c1367ccf3499544d9cf5a/maven/tuangou-java</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>
在你项目的pom.xml文件<denpendencies></denpendencies>节点中加入你要引用的文件信息。
<dependency>
    <groupId>com.yunfeiwork</groupId>
    <artifactId>tuangou-java-partner</artifactId>
    <version>1.0.B</version>
</dependency>
步骤三:拉取
运行以下命令完成jar拉取。
mvn install
修改于 2026-06-17 03:46:44
上一页
更新日志
下一页
应用绑定美团门店
Built with