顾客在美团买了 3 份双人套餐,付了一次钱,拿到的是一个订单 —— 但对应的是 3 张券。核销时按订单还是按券,直接决定出餐数量和金额。
一、先搞清楚三层结构
| 层 | 含义 | 关系 |
|---|---|---|
| 订单 | 顾客一次支付行为 | 一个订单可含多张券 |
| 券 | 一张可核销的凭证 | 核销的最小单位 |
| 券码 | 券的对外表现 | 可能一券一码,也可能一个码对应多张 |
二、验券准备阶段就要看清有几张
预核销返回的信息里通常包含该码对应的券数量与明细。确认页必须把这一点展示给顾客和服务员:
- 「本券含 3 份套餐」而不是只显示套餐名
- 若支持部分使用,明确提示「可分次使用」还是「必须一次用完」
- 展示每张券的可核销状态 —— 可能有的已用、有的未用
这一步不做,就会出现服务员核一次、只出一份、顾客投诉「我买了三份」。
三、逐张核销还是整单核销
| 方式 | 适用 | 风险 |
|---|---|---|
| 逐张核销 | 支持部分使用、或需要分次到店 | 中途失败会造成「核了一半」的不一致状态 |
| 整单一次核销 | 一次消费完、不拆分 | 顾客只用一份时无法部分退 |
| 按接口支持的粒度 | 以平台实际能力为准 | 不同平台、不同券类型的支持程度不同 |
选择依据不是技术偏好,而是业务规则:这张券平台允不允许部分使用。允许就必须逐张,不允许则整单更安全。
四、逐张核销时的不一致问题
3 张券,第 1、2 张成功,第 3 张失败。此时系统处于中间状态,必须明确怎么处理:
- 记录已成功的张数,不要回滚已成功的(回滚要调撤销接口,可能超出时限)
- 对失败的张给出明确提示:「已核销 2 份,第 3 份失败,原因 xxx」
- 提供「继续核销剩余」的入口,而不是让服务员重新扫一遍
- 若失败原因是券状态问题(已用/已退),直接告知顾客,不要重试
- 全部核销完成后才触发出餐,避免出了餐但券没核成功
这条规则值得写进代码注释:出餐动作放在所有券都核销成功之后,不要在循环里每张券都出餐。
五、撤销的边界
- 撤销通常按券撤销,不是按订单
- 已出餐的券撤销前要先确认能否追回(餐已吃掉就退不了)
- 撤销有时限,超过时限只能走退款流程,由平台侧处理
- 部分撤销后订单状态如何展示,要与财务口径对齐
六、必须做的幂等
多张券的场景下,重复提交的概率显著上升 —— 服务员看到没反应会再点一次,网络重试也会重发。
- 请求带唯一幂等键(订单号 + 券序号 + 操作类型)
- 服务端记录幂等键,重复请求直接返回首次结果
- 若无法确认首次是否成功,先查询核销状态再决定,不要盲目重试
- 日志里记下每张券的最终状态,出问题能逐张追溯
常见问题
一个券码对应多张券,能一次核完吗?
看平台是否支持整单核销。多数情况下需要按券逐张处理,或者调用带数量的核销接口。以接入时文档为准。
顾客只用了一份,能退另外两份吗?
部分退款属于平台侧的售后流程,核销系统通常只能处理「撤销已核销的券」。未核销的券退款走平台退款,两者不要混。