枚举附录(团购券)

本文件汇总团购券核销接口文档中使用的券状态、业务类型、平台代码及平台撤销规则定义,各接口文档通过引用本文件查阅。

撤销时效限制

各团购平台对核销后可撤销的时间窗口不同,超出时效后撤销将被平台拒绝:

平台代码 平台名称 撤销时效 备注 开发建议
MEI_TUAN 美团餐饮 约 60 天 实际以平台返回为准,隔天可能部分拒绝 窗口充足,按对账节奏处理即可
MEI_TUAN 美团非餐 10 分钟 仅支持逐张撤销,不支持并发 窗口极短,建议核销后立即判断是否需要撤销,超时不可撤
DOU_YIN 抖音 约 50 分钟 一键买单不支持撤销 建议在 50 分钟内完成撤销判断
KUAI_SHOU 快手 约 1 小时 建议在 1 小时内完成撤销判断
JING_DONG 京东 约 2 小时 建议在 2 小时内完成撤销判断
ELEME 淘宝闪购 约 48 小时 窗口充足
GAO_DE 高德 当天 24 点前 隔天不允许撤销 跨天不可撤销,建议当日完成
TAI_LONG 泰隆 约 24 小时 建议在 24 小时内完成撤销判断
ALIPAY_TUANGOU 支付宝神券 约 3 天 窗口充足

说明:美团餐饮与美团非餐的平台代码均为 MEI_TUAN,二者撤销时效不同,以券实际所属品类为准。

开发建议:撤销时效以平台实际返回为准。建议业务侧在核销后保留"核销—撤销"的时间判断,超时后不再重试撤销(将返回失败),改由人工联系平台处理。

单次撤销张数限制

支持部分撤销(一次核销多份券时可只撤销其中部分份数);单次请求可撤销的份数因平台而异,超出限制请分批撤销:

平台代码 平台名称 单次最多可撤份数
MEI_TUAN 美团餐饮 6
MEI_TUAN 美团非餐 1
DOU_YIN 抖音 3
KUAI_SHOU 快手 6
JING_DONG 京东 6
ELEME 淘宝闪购 99
GAO_DE 高德 30
TAI_LONG 泰隆 30
ALIPAY_TUANGOU 支付宝神券 5

美团餐饮与美团非餐的平台代码均为 MEI_TUAN,二者单次可撤份数不同,以券实际所属品类为准。

券状态 status

状态值 说明
INIT 未使用
CONSUMED 已使用/已核销
CANCELLED 已撤销
PROCESSING 处理中
PART_CANCELLED 部分撤销
CANCELLED_FAILED 撤销失败
CONSUME_FAILED 核销失败

券业务类型 bizType

说明
0 普通团购(套餐券)
1 次卡
2 代金券
3 套餐券
4 一键买单

核销订单状态 consumeStatus

撤销核销接口响应中的状态字段(nowStatus 本次撤销状态、status 核销订单总状态):

状态值 说明
CONSUMED 已核销(仍有剩余未撤销)
CANCELLED 已全部撤销
PART_CANCELLED 部分撤销
CANCELLED_FAILED 撤销失败
  • nowStatus:本次撤销状态,取值 CANCELLED(全部成功)/ PART_CANCELLED(部分成功)/ CANCELLED_FAILED(全部失败)
  • status:核销订单总状态,取值 CANCELLED(已全部撤销)/ PART_CANCELLED(部分撤销)/ CONSUMED(仍有剩余未撤销)

平台代码 platform

平台代码 平台名称 业务说明
MEI_TUAN 美团团购 美团餐饮团购、到店综合团购
DOU_YIN 抖音 抖音生活服务团购
KUAI_SHOU 快手 快手本地生活团购
JING_DONG 京东 京东到店团购
ELEME 淘宝闪购 淘宝闪购(原饿了么到店)
GAO_DE 高德 高德地图团购
TAI_LONG 泰隆 泰隆生活团购
ALIPAY_TUANGOU 支付宝 支付宝神券/团购

results matching ""

    No results matching ""