接入准备：
1、提供申请信息格式如下：（根据实际情况修改成自己的信息）
应用名称：云老板
联系人：黄先生
添加微信：hcs2201 快速接入美团团购
2、服务商分配：平台账号、密码，根据下图获取clientId、secret和门店ID
3、支付费用：门店年费（元/店/年，具体详谈），首次接入收取2000元接入费用
4、提供如下信息给服务商审核：
门店名称：
门店ID：
5、最后一步很重要：审核通过后根据需要填写抖音ID、美团ID、快手ID
1、美团ID可不填写
2、抖音ID获取方式，获取授权URL，扫码授权时，有如下界面：
3、快手授权流程：
添加微信：hcs2201 快速接入美团团购
核销流程：
1、获取授权URL，并在浏览器中打开返回的URL，登录第三方团购平台的账号进行授权，注意：只授权一次即可
2、获取券的信息（根据业务需要，可以不调用）
3、核销
============================================================================
通用请求头：
通用参数说明：
获取授权URL
请求地址：
https://openapi.yunlaoban.vip/api/isp/groupBuy/getScopeUrl
请求方式：post
请求参数：
{ "platform": 1, "shopId": 66101806 }
返回参数：
{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "504944724084264960", "result": "https://auth.dylk.com/auth-isv/?client_key=awcgusov3dxxqq×tamp=172818611&solution_key=4&permission_keys=1,2,3,6,10,11,12,14,15,16&out_shop_id=shop_id&charset=UTF-8&extra=02b9640&sign=03b1d6c2070acb7f4445c9d5d1fc8c7f64b58a99a42109f1c3a1457ba38663" }
获取券信息
请求地址：
https://openapi.yunlaoban.vip/api/isp/groupBuy/prepare
请求方式：post
请求参数：
{ "shopId":66101806, "platform":2, "code":"102002867859823" }
返回参数：
{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "519810405934043136", "result": "{\"payAmount\":990,\"ticketName\":\"1小时抵用券\",\"ticketInfo\":\"W6P77qrhYnCMZ/ueaI8A==\",\"ticketData\":\"{\\\"bizType\\\":0,\\\"merchantAmount\\\":\\\"0\\\",\\\"dealId\\\":1354218703,\\\"dealTitle\\\":\\\"自助洗车|普洗25分钟\\\",\\\"dealMarketPrice\\\":17,\\\"count\\\":1,\\\"mobile\\\":\\\"136****7048\\\",\\\"dealPrice\\\":9.9,\\\"receiptCode\\\":\\\"0179890153\\\",\\\"receiptEndDate\\\":1741103999000,\\\"platformAmount\\\":\\\"0\\\",\\\"paymentDetail\\\":[{\\\"amountType\\\":10,\\\"amount\\\":\\\"9.9\\\",\\\"paymentDetailId\\\":\\\"1KM0JJJ4FXU023350102\\\"}],\\\"dealGroupId\\\":1165423548,\\\"tgTimesCardFlag\\\":false}\",\"groupPayType\":1}" }
添加微信：hcs2201 快速接入美团团购
核销
请求地址：
https://openapi.yunlaoban.vip/api/isp/groupBuy/consume
请求方式：post
请求参数：
{ "shopId":66101806, "platform":2, "code":"102002867859823", "ticketInfo": "获取券信息接口返回的ticketInfo" }
成功返回参数：
{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "519813188816998400", "result": "true" }
失败返回参数：
{ "code": "1002029009", "message": "团购券验证失败！此券码已被验证，验证时间：2024-12-05 09:52:02，验证商户：XXX", "msg": "团购券验证失败！此券码已被验证，验证时间：2024-12-05 09:52:02，验证商户：XXX", "traceId": "519813269960003584", "result": null }
撤销验券
请求地址：
https://openapi.yunlaoban.vip/api/isp/groupBuy/revoke
请求方式：post
请求参数：
{ "shopId":66101806, "platform":2, "code":"102002867859823", "ticketInfo": }
成功返回参数：
{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "519813188816998400", "result": "true" }
获取团购信息
请求地址：
https://openapi.yunlaoban.vip/api/isp/groupBuy/queryshopdeal
请求方式：post
请求参数：
{ "shopId": "15312672066", "offset": "1", "limit": "10", "source": "1", "platform": "1" }
成功返回参数：
{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "544565423715127296", "result": "[{\"marketPrice\":138,\"endDate\":\"2026-01-02 00:00:00\",\"dealId\":137281531,\"saleStatus\":2,\"title\":\"【白天档】奢华大包3小时(周一至周四06:00-16:00)\",\"dealType\":1,\"receiptEndDate\":\"2025-03-13 23:59:59\",\"beginDate\":\"2025-01-10 11:02:49\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":88,\"receiptBeginDate\":\"2025-02-11 17:08:34\",\"dealGroupId\":1237040751}]" }
其他接口（接口转发）-暂停使用
为了便于部分二次开发客户，丰富业务功能，将通过此接口转发部分团购平台的API。所有接口的输入参数、返回参数、错误代码，请自己参考官方的文档。
添加微信：hcs2201 快速接入美团团购
请求地址：
https://openapi.yunlaoban.vip/api/isp/groupBuy/forward
请求方式：post
请求参数：
{ "shopId": 1188878, "url": "https://api-open-cater.meituan.com/ddzh/tuangou/deal/queryshopdeal", "platform": 1, "params": { "offset": 1, "limit": 10, "source": 1 } }
返回参数：本接口会将官方API返回的结果原样返回，所以响应的数据结构，请参照官方文档
返回示例：
{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "519913470578135040", "result": "{\"msg\":\"成功\",\"traceId\":\"1343716583765995825\",\"code\":\"OP_SUCCESS\",\"data\":{\"result\":[{\"marketPrice\":1980,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1143170705,\"saleStatus\":2,\"title\":\"【车商专用】超级翻新洗+无死角清洗+全车护理\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2023-06-11 17:53:50\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":1280,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":861507817},{\"marketPrice\":358,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1151071474,\"saleStatus\":2,\"title\":\"[精致洗车]内外深度清洁+漆面强力去污|轿车\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2023-06-21 14:43:16\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":198,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":865325554},{\"marketPrice\":862,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1023332722,\"saleStatus\":2,\"title\":\"【疯抢168单】抛光+打蜡+精洗+雾化\",\"dealType\":1,\"receiptEndDate\":\"2025-02-03 23:59:59\",\"beginDate\":\"2022-11-18 10:49:38\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":368,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":806201775},{\"marketPrice\":30001,\"endDate\":\"2023-10-09 00:00:00\",\"dealId\":1164052787,\"saleStatus\":3,\"title\":\"代金券\",\"dealType\":2,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2023-07-10 10:32:31\",\"saleChannelName\":\"\",\"dealGroupStatus\":2,\"price\":30000,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":870442402},{\"marketPrice\":198,\"endDate\":\"2025-09-13 00:00:00\",\"dealId\":1008414934,\"saleStatus\":2,\"title\":\"[精致洗车]内外深度清洁|轿车\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2022-10-14 17:07:36\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":98,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":799590508},{\"marketPrice\":298,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1147242561,\"saleStatus\":2,\"title\":\"【老客推荐]精洗+水镀膜+雾化杀菌消毒\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2023-06-16 13:20:40\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":128,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":863380578},{\"marketPrice\":594,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1116177318,\"saleStatus\":2,\"title\":\"超值：精洗+打蜡（3M棕榈蜡）+雾化消\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2023-05-05 00:26:12\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":188,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":850033724},{\"marketPrice\":588,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1099788750,\"saleStatus\":2,\"title\":\"空调清洗+精洗+雾化杀菌\",\"dealType\":1,\"receiptEndDate\":\"2025-02-03 23:59:59\",\"beginDate\":\"2023-04-14 11:25:41\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":258,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":843461882},{\"marketPrice\":688,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1023344612,\"saleStatus\":2,\"title\":\"内饰清洁-轿车\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2022-11-18 10:28:00\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":328,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":806217648},{\"marketPrice\":2580,\"endDate\":\"2025-01-07 00:00:00\",\"dealId\":1143239845,\"saleStatus\":2,\"title\":\"【标准九项】超级翻新洗+无死角清洗+抛光镀晶+护理\",\"dealType\":1,\"receiptEndDate\":\"2025-03-05 23:59:59\",\"beginDate\":\"2023-06-11 19:24:18\",\"saleChannelName\":\"不限制\",\"dealGroupStatus\":1,\"price\":1880,\"receiptBeginDate\":\"2024-12-05 16:30:31\",\"dealGroupId\":861529750}]}}" }
添加微信：hcs2201 快速接入美团团购
美团官方文档：
https://developer.meituan.com/docs/api/ddzh-tuangou-receipt-prepare
抖音官方文档：
https://developer.open-douyin.com/docs/resource/zh-CN/local-life/capability/basic/verify-introduce
快手官网文档：
https://open.kwailocallife.com/docs/api?apiName=goodlife.v1.fulfilment.certificate.prepare&version=1
