已经跑通美团的团队,接抖音时最省事的想法是「照着改一下接口地址」。能跑通一部分,但会在六处地方卡住,其中三处直接导致核销失败,另外三处会导致数据错。

一、六处差异对照

#维度美团抖音后果
1业务线切分分到店餐饮 / 到店综合,接口前缀不同分到店餐饮 / 到店综合,切分方式与参数不同选错业务线→查不到券
2授权粒度门店级授权授权模型与有效期规则不同粒度对不上→授权表要重设计
3券类型相对统一套餐、代金券、次卡等类型更多假设统一→部分券核不了
4成功判断按返回码需按顶层结果字段判断判错→把失败当成功
5撤销规则有时限时限与可撤销范围不同超时撤销→失败且无法补救
6错误语义一套码体系另一套码体系错误映射错→提示文案驴唇不对马嘴

二、导致核销失败的三处

1. 业务线选错

两个平台都把到店业务分成餐饮与综合两条线。美团的餐饮接口以 ms 开头、综合走团购核销系列;抖音的切分方式不同,参数结构也不同。

判断依据是门店的主营类目,不是门店名字。既有餐饮又有其他服务的混合业态,按主营类目归属,接入前应向平台确认。

2. 授权粒度对不上

美团的授权是门店级。抖音的授权模型与凭据有效期规则不同,如果第一版按「门店ID 作主键」建了授权表,接抖音时会发现粒度不匹配。

3. 券类型假设统一

抖音的团购商品类型比美团更杂。不要假设「所有券都能用同一套参数核销」——次卡、套餐、代金券的参数要求可能不同。

正确做法:验券准备阶段就取回券类型,按类型分支处理,而不是统一走一条路径。

三、导致数据错的三处

4. 成功判断看错了字段

两个平台的返回结构不同。美团的成功判断与抖音不通用,照抄会导致「实际失败但系统记成功」——这是最危险的一类错,因为它不会报错,只会在对账时暴露。

5. 撤销规则不同

撤销有时限,且两个平台的时限与可撤销范围不一样。用美团的时限去套抖音,会出现「以为还能撤,实际已经超时」。

撤销失败要区分「券状态不允许」与「临时错误」,前者不要重试。

6. 错误语义不能直译

两套错误码体系,同一个含义可能用不同的码,同一个码可能对应不同的含义。直接把码透传给用户,等于把内部逻辑暴露给顾客。

正确做法:在适配层把两套码归一成自己的业务错误枚举(券已用 / 券过期 / 不适用本店 / 门店未配置 / 授权失效 / 临时错误),前端只认这套枚举。

四、「一套代码接双平台」怎么分层

可行的结构是三层:

层职责是否随平台变化
业务层预约、落位、权益、对账不变
适配层平台参数映射、成功判断、错误归一每平台一份
调用层HTTP、签名、重试、日志少量差异
  1. 业务层只依赖统一模型:券、门店、操作、结果,不知道平台差异
  2. 适配层每个平台一个实现,把平台特有的参数、返回、错误码翻译成统一模型
  3. 调用层处理签名与重试,能复用就复用
  4. 新增平台时只加一个适配实现,业务层不动

这套分层看起来多写了一层,但第二次接平台时就回本了。如果一开始没分,第二个平台往往会变成「复制一份代码改改」,两套逻辑长期并存。

五、用聚合接口时的差异

走聚合接口时,上述六处差异由服务方在内部消化,你的系统看到的是一套模型:

  • 用平台参数区分(美团 / 点评 / 抖音 / 快手),业务代码不需要分支
  • 成功判断由接口层统一,返回统一的结果结构
  • 错误已归一成业务语义,可直接映射成用户提示
  • 撤销规则差异由接口层处理,你只需知道「能不能撤」
  • 门店映射一次配置,各平台标识分别存放

云飞API 覆盖四个平台(美团、大众点评、抖音、快手)。需要说明的是:接口只解决「券的核销」,业务侧的库存、落位、权益仍要自己做。

常见问题

美团和抖音能共用一个门店ID 吗?

不能。各平台有各自的门店标识体系,必须建映射。

点评的券要单独写一套吗?

不需要。点评用户购买的团购券走美团同一套团购接口,靠返回的渠道字段区分来源。

先接哪个平台比较好?

按你的客户实际卖得多的那个先接。技术上没有依赖关系,但先跑通一个再做适配层,比两个同时开工更容易收敛。