【2025最新】美团、抖音、快手团购券核销低成本接入方案

核销流程：

1、获取授权URL，并在浏览器中打开返回的URL，登录第三方团购平台的账号进行授权，注意：只授权一次即可

2、获取券的信息（根据业务需要，可以不调用）

3、核销

============================================================================

通用请求头：

Content-Type

固定值：application/json

类型

clientId

String

系统分配的ID

secret

String

系统分配的密钥

通用参数说明：

参数名

类型

说明

platform

Integer

团购平台类型。1-美团/大众点评，2-抖音，3-快手

shopId

Long

门店ID：系统分配

获取授权URL

请求地址

https://XXXXXXXXX/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://xxxxxxx/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}" }

核销

请求地址：

https://XXXXXXXX/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://xxxxxxxxxxxx/api/isp/groupBuy/revoke

请求方式：post

请求参数：

{ "shopId":66101806, "platform":2, "code":"102002867859823", "ticketInfo": }

成功返回参数：

{ "code": "SUCCESS", "message": "OK", "msg": null, "traceId": "519813188816998400", "result": "true" }

获取团购信息

请求地址：

https://xxxxxxxxxxxx/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。所有接口的输入参数、返回参数、错误代码，请自己参考官方的文档。

请求地址：

https://xxxxxxxxxxxx/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

猜你喜欢