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

查券和验券

接口说明#

该接口可以查券也可以验券,根据 type 传入不同值实现不同能力
查券信息不收费!查券信息不收费!查券信息不收费!
验券成功才扣费!验券成功才扣费!验券成功才扣费!

注意事项#

需要门店先完成授权,授权成功后(即在授权有效期内)该接口可正常调用获取券数据
获取 access_token 调用 点我生成accessToken

基本信息#

名称描述
HTTP URLhttp://wspacebot.yunfeiwork.com/wspace-openapi/partner/tuangou/receipt/consume?access_token=ACCESS_TOKEN
HTTP MethodPOST

请求参数#

请求头#

参数名参数值必填
content-typeapplication/json是

Body#

参数名类型必填说明
opPoiIdstring否云飞API侧门店ID
dyShopIdstring是抖音来客门店ID
dyAccountIdstring是抖音来客账户ID
platformstring是团购平台:douyin=抖音
businessTypestring是业务类型:DDZH=到店综合、DDCY=到店餐饮

请求示例#

{
    "opPoiId": null,
    "dyShopId": "xxxxx",
    "dyAccountId": "xxxxx",
    "platform": "douyin",
    "businessType": "DDZH"
}

响应参数#

Body#

参数名类型说明
opPoiIdstring云飞API侧的门店ID 是唯一的且固定不变 ,如果你使用来客核销小程序,可以在小程序内查看门店ID
namestring门店名称
addressstring地址
cityNamestring城市
expiresInlong注意:如果字段返回值为空表示该门店还没扫授权码,如果返回有值说明是连锁子门店可共用一个管理员账号的授权,单位:秒
expiresTimedatetime同expiresIn字段

响应示例#

{
    "code": 200,
    "msg": "验证成功",
    "data": {
        "opPoiId": "example",
        "name": "example",
        "address": "example",
        "cityName": "example",
        "expiresIn": 2590896,
        "expiresTime": "2025-04-16 12:32:43"   
    }
}
修改于 2026-06-17 03:55:10
上一页
获取门店团购信息
下一页
按券查询待入账账单
Built with