跳转到内容

订单-验证核销码

POST /app/localLife/storage/order/checkCode
字段 名称 类型 是否必须
order_id 订单ID uint 是
code 核销码 string 是
字段 名称
code 0为成功其余都是失败
data object
msg 提示语

仅商品开启按日期/场次售卖且订单项带 session_id 时执行场次核销校验;未开启按日期/场次售卖的商品保持原有核销行为。订单有场次时,核销当天必须仍存在并允许使用该场次;场次停用或当天被指定删除时会拒绝核销。核销时间还必须落在该场次的 start_time 到 check_deadline_time 之间,超出后会拒绝核销并提示“当前时间不在场次核销时间内”或同义文案。

顾客不可消费日期会在核销时校验,优先级高于指定场次增加/删除规则;命中后直接返回不可用原因。顾客每日消费时段仍按购买须知独立校验,和场次不是同一个限制。完整口径见:日期/场次/票种对接说明。

当前接口成功返回时,data 固定包含 code、effective、message。effective=false 时,message 会返回明确不可核销原因,例如:券码不存在、券码已使用、订单未支付、该日期不可用、当前场次今日不可核销、当前时间不在场次核销时间内。

字段 名称 类型
code 核销码 string
effective 是否有效 bool
message 无效原因;不可消费日期或场次不可核销时返回明确提示 string
{
"code": 0,
"data": {
"code": "YF94593276442918",
"effective": true,
"message": ""
},
"msg": "操作成功"
}

不可核销示例:

{
"code": 0,
"data": {
"code": "YF94593276442918",
"effective": false,
"message": "当前场次今日不可核销"
},
"msg": "操作成功"
}