顾客在美团买了 3 份双人套餐,付了一次钱,拿到的是一个订单 —— 但对应的是 3 张券。核销时按订单还是按券,直接决定出餐数量和金额。

一、先搞清楚三层结构

层含义关系
订单顾客一次支付行为一个订单可含多张券
券一张可核销的凭证核销的最小单位
券码券的对外表现可能一券一码,也可能一个码对应多张

二、验券准备阶段就要看清有几张

预核销返回的信息里通常包含该码对应的券数量与明细。确认页必须把这一点展示给顾客和服务员:

  • 「本券含 3 份套餐」而不是只显示套餐名
  • 若支持部分使用,明确提示「可分次使用」还是「必须一次用完」
  • 展示每张券的可核销状态 —— 可能有的已用、有的未用

这一步不做,就会出现服务员核一次、只出一份、顾客投诉「我买了三份」。

三、逐张核销还是整单核销

方式适用风险
逐张核销支持部分使用、或需要分次到店中途失败会造成「核了一半」的不一致状态
整单一次核销一次消费完、不拆分顾客只用一份时无法部分退
按接口支持的粒度以平台实际能力为准不同平台、不同券类型的支持程度不同

选择依据不是技术偏好,而是业务规则:这张券平台允不允许部分使用。允许就必须逐张,不允许则整单更安全。

四、逐张核销时的不一致问题

3 张券,第 1、2 张成功,第 3 张失败。此时系统处于中间状态,必须明确怎么处理:

  1. 记录已成功的张数,不要回滚已成功的(回滚要调撤销接口,可能超出时限)
  2. 对失败的张给出明确提示:「已核销 2 份,第 3 份失败,原因 xxx」
  3. 提供「继续核销剩余」的入口,而不是让服务员重新扫一遍
  4. 若失败原因是券状态问题(已用/已退),直接告知顾客,不要重试
  5. 全部核销完成后才触发出餐,避免出了餐但券没核成功

这条规则值得写进代码注释:出餐动作放在所有券都核销成功之后,不要在循环里每张券都出餐。

五、撤销的边界

  • 撤销通常按券撤销,不是按订单
  • 已出餐的券撤销前要先确认能否追回(餐已吃掉就退不了)
  • 撤销有时限,超过时限只能走退款流程,由平台侧处理
  • 部分撤销后订单状态如何展示,要与财务口径对齐

六、必须做的幂等

多张券的场景下,重复提交的概率显著上升 —— 服务员看到没反应会再点一次,网络重试也会重发。

  • 请求带唯一幂等键(订单号 + 券序号 + 操作类型)
  • 服务端记录幂等键,重复请求直接返回首次结果
  • 若无法确认首次是否成功,先查询核销状态再决定,不要盲目重试
  • 日志里记下每张券的最终状态,出问题能逐张追溯

常见问题

一个券码对应多张券,能一次核完吗?

看平台是否支持整单核销。多数情况下需要按券逐张处理,或者调用带数量的核销接口。以接入时文档为准。

顾客只用了一份,能退另外两份吗?

部分退款属于平台侧的售后流程,核销系统通常只能处理「撤销已核销的券」。未核销的券退款走平台退款,两者不要混。