订单-验证核销码
POST /app/localLife/storage/order/checkCode| 字段 | 名称 | 类型 | 是否必须 |
| order_id | 订单ID | uint | 是 |
| code | 核销码 | string | 是 |
| 字段 | 名称 | |
| code | 0为成功其余都是失败 | |
| data | object | |
| msg | 提示语 |
日期/场次核销补充
Section titled “日期/场次核销补充”仅商品开启按日期/场次售卖且订单项带 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": "操作成功"}