商品券可核销时间规则说明(coupon_available_period)
更新时间:2025.11.24
|
一、概述
商品券信息中,coupon_available_period下的各个子参数共同构建了商品券的可核销时间规则,具体可核销时间为各个子参数设置的交集时间,商户在创券、发券时,需计算好商品券可核销的时间范围。
字段 | 功能 | 注意事项 |
|---|---|---|
available_begin_time | 设置商品券批次的开始时间 | 批次开始和结束时间的间隔不能超过一年 |
available_end_time | 设置商品券批次的结束时间 | 批次开始和结束时间的间隔不能超过一年 |
wait_days_after_receive | 设置商品券领券后需等待生效的天数 | 1、批次开始时间前领券,计时从批次生效的第一天开始计算。批次有效期内领券,计时从用户领券当天开始计算 2、wait_days_after_receive需要与available_days一起使用 |
available_days | 设置商品券生效后可使用的天数 | 1、生效后可使用的天数范围若超过批次结束时间,则券的有效期截止到批次结束时间。 2、available_days可单独使用,也可以与wait_days_after_receive一起使用。 |
weekly_available_period | 设置商品券每周可生效的时间段 | 1、weekly_available_period.day_list可单独使用,而weekly_available_period.day_period_list需要与weekly_available_period.day_list一起使用 2、时间段的开始时间、结束时间必须同时设置,填写多个时间段时,不同区间请勿重叠 |
irregular_available_period_list | 自定义设置商品券可生效的时间段 | 时间段的开始时间、结束时间必须同时设置,填写多个时间段时,不同区间请勿重叠 |
二、常见场景组合说明
场景 | 所需字段 | 参数设置举例 | 说明 |
|---|---|---|---|
在批次有效期内,用户可以在任意时间点使用券。 | available_begin_time | "coupon_available_period" : { | 用户领券之后在批次有效期(2025年8月4日8点到2025年8月13日8点)的任意时间点都可以使用。 |
在批次有效期内,用户领券后立即可用,且券有效期是N天。 | available_begin_time | "coupon_available_period" : { | 用户领券之后3天内在批次有效期(2025年8月4日8点到2025年8月13日8点)的任意时间点都可以使用。 |
在批次有效期内,用户领券后需要等待N天才可以用券,且券有效期是N天。 | available_begin_time | "coupon_available_period" : { | 用户领券之后需要等待2天才可以使用券,当券可以使用时,用户可在3天内在批次有效期(2025年8月4日8点到2025年8月13日8点)的任意时间点可以使用。 |
在批次有效期内,每周设定的星期可以用券。 | available_begin_time | "coupon_available_period" : { | 用户领券之后在批次有效期内(2025年8月4日8点到2025年8月13日8点),每个周一、周五全天的任意时间点可以使用。 |
在批次有效期内,每周设定的星期以及对应时间段可以用券。 | available_begin_time | "coupon_available_period" : { | 用户领券之后在批次有效期内(2025年8月4日8点到2025年8月13日8点),每个周一、周五的8点到10点之间的任意时间点可以使用。 |
在批次有效期内,指定可以用券的时间段。 | available_begin_time | "coupon_available_period" : { | 用户领券之后在批次有效期内(2025年8月4日8点到2025年8月13日8点),指定的2025年8月4日8点到2025年8月6日8点、2025年8月10日8点到2025年8月13日8点之间的任意时间点可以使用。 |
以上场景仅作为示例参考,商户可结合自身实际需求进行字段的组合。 | |||

