商家券可核销时间规则说明（coupon_available_time）

更新时间：2025.09.04

一、概述

商家券信息中，coupon_available_time下的各个子参数共同构建了商家券的可核销时间规则，具体可核销时间为各个子参数设置的交集时间，商户在创券、发券时，需计算好商家券可核销的时间范围。

字段	功能	注意事项
available_begin_time ，available_end_time	设置商家券批次的开始，结束时间	开始和结束时间之间的间隔不能超过一年
available_day_after_receive ，wait_days_after_receive	设置商家券的生效天数、等待开始生效的天数	1、批次开始时间前领券，计时从批次生效的第一天开始计算。批次有效期内领券，计时从用户领券当天开始计算。 2、available_day_after_receive可单独使用，而wait_days_after_receive需要与available_day_after_receive一起使用
available_week	设置商家券每周可生效的时间段	1、available_week.week_day可单独使用，而available_week.available_day_time需要与available_week.week_day一起使用 2、时间段的开始时间、结束时间必须同时设置，填写多个时间段时，不同区间请勿重叠
irregulary_avaliable_time	自定义设置商家券可生效的时间段	时间段的开始时间、结束时间必须同时设置，填写多个时间段时，不同区间请勿重叠

本文将介绍各个子参数的规则以及示例。

二、常见场景组合说明

场景	固定字段	组合字段
允许在批次有效期内任意时间点使用券。	available_begin_time available_end_time	无
希望用户领券后尽快使用时，可以添加设置“生效后N天内有效”。		available_day_after_receive
不希望用户领券后立即就能使用时，可以添加设置“领取后N天开始生效”，此时还需同时设置“生效后N天内有效”。		available_day_after_receive wait_days_after_receive
固定每周某些时间段才能使用时，可添加设置“固定周期有效时间段”。例如工作日早餐优惠券，固定每周一至周五早上6-10点使用。		available_week
如果在批次有效期内，存在其他需要自定义的有效时间段，可添加设置“无规律的有效时间段”，最多可设置两个时间段。		irregulary_avaliable_time
以上场景仅作为示例参考，商户可结合自身实际需求进行字段的组合。

三、参数介绍与示例

1、available_begin_time

参数名：开始时间
是否必填：是
参数说明：批次开始时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

2、available_end_time

参数名：结束时间
是否必填：是
参数说明：批次结束时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

注意：批次开始时间与结束时间的间隔不能超过一年。

批次有效期示例：

设置批次的活动时间为2025年8月4日8点到2025年8月13日8点，传参示例如下：

1"coupon_available_time" : {
2    "available_begin_time" : "2025-08-04T08:00:00+08:00",
3    "available_end_time" : "2025-08-13T08:00:00+08:00"
4}

生效时间范围如下图所示，不详细列举年月，日期下方没有写具体时间段的代表全天时间，绿色部分结合日期代表批次生效的时间范围。

只设置了批次有效期的场景下，无论何时领券，批次的有效期就是券可以进行核销的时间范围，即绿色部分。

3、available_day_after_receive

参数名：生效后N天内有效
是否必填：否
参数说明：日期区间内，券生效后N天内有效。例如生效当天内有效填1，生效后2天内有效填2，以此类推……

注意：

1、用户在批次有效期开始前领取商家券，则从批次有效期第1天开始计算天数，用户在批次有效期内领取商家券，则从领取当天开始计算天数，无论用户何时领取商家券，商家券在批次有效期结束后均不可用。

2、可配合wait_days_after_receive一同填写，也可单独填写。单独填写时，有效期内领券后立即生效，生效后x天内有效。

生效后N天内有效示例：

设置批次的活动时间为2025年8月4日8点到2025年8月13日8点，用户领券开始生效后2天内有效，传参示例如下：

1"coupon_available_time" : {
2    "available_begin_time" : "2025-08-04T08:00:00+08:00",
3    "available_end_time" : "2025-08-13T08:00:00+08:00",
4    "available_day_after_receive" : 2
5}

生效时间范围如下图所示，不详细列举年月，日期下方没有写具体时间段的代表全天时间。

蓝色部分代表用户领券的日期，黄色部分代表批次的有效期，粉色部分代表券开始生效后的有效天数，绿色部分的时间段结合日期代表这张券可以进行核销的的时间范围。

场景1：用户在批次开始时间前的日期领券，券的2天生效时间从“批次开始时间”进行计算，即8月3日领券，从8月4日开始计算生效天数，所以8月4日-8月5日为生效日期，结合时间段，则是2025年8月4日 08:00:00 - 2025年8月5日 23:59:59

场景2：用户在批次生效期间内的日期领券，券的2天生效时间从领券当天开始计算，即8月6日领券，就从8月6日开始计算生效天数，所以8月6日-8月7日为生效日期，结合时间段，则是2025年8月6日 00:00:00 - 2025年8月7日 23:59:59

场景3：用户在批次剩余生效时间日期小于2天时领券，券的有效日期不会超过“批次结束时间”，即8月9日领券，只有8月9日为生效日期，结合时间段，则是2025年8月13日 00:00:00 - 2025年8月13日 08:00:00

4、wait_days_after_receive

参数名：领取后N天开始生效
是否必填：否
参数说明：日期区间内，用户领券后需等待N天开始生效。例如领券后当天开始生效则无需填写，领券后第2天开始生效填1，以此类推……

注意：

1、用户在批次有效期开始前领取商家券，则从批次有效期第1天开始计算天数，用户在批次有效期内领取商家券，则从领取当天开始计算天数。无论用户何时领取商家券，商家券在批次有效期结束后均不可用。

2、需配合available_day_after_receive一同填写，不可单独填写。

3、最大不能超过30天

领取后N天开始生效示例：

设置批次的活动时间为2025年8月4日8点到2025年8月13日8点，用户领券2天后开始生效，开始生效后2天内有效，传参示例如下：

1"coupon_available_time" : {
2    "available_begin_time" : "2025-08-04T08:00:00+08:00",
3    "available_end_time" : "2025-08-13T08:00:00+08:00",
4    "available_day_after_receive" : 2,
5    "wait_days_after_receive" : 2
6}

生效时间范围如下图所示，不详细列举年月，日期下方没有写具体时间段的代表全天时间。

蓝色部分代表用户领券的日期，黄色部分代表批次的有效期，灰色部分代表领券后等待券开始生效的天数，粉色部分代表券开始生效后的有效天数，绿色部分的时间段结合日期代表这张券可以进行核销的的时间范围。

场景1：用户在批次开始时间前的日期领券，等待券开始生效的天数从“批次开始时间”进行计算，即8月3日领券，从8月4日开始计算等待生效天数，2天后，券从8月6号开始生效，生效后2天内有效，结合时间段，则是2025年8月6日 00:00:00 - 2025年8月7日 23:59:59

场景2：用户在批次生效期间内的日期领券，等待券开始生效的天数从领券当天进行计算，即8月6日领券，从8月6日开始计算等待生效天数，2天后，券从8月8号开始生效，生效后2天内有效，结合时间段，则是2025年8月8日 00:00:00 - 2025年8月9日 23:59:59

场景3：用户在批次剩余生效时间日期小于2天时来领券，券开始生效的时间晚于“批次结束时间”，券无法使用，因此该场景下建议商户停止发券。即8月12日领券，从8月12日开始计算等待生效天数，2天后，券从8月14号开始生效，此时批次有效期已结束，红色部分为过期无法使用的时间范围。

5、available_week

参数名：固定周期有效时间段
是否必填：否
参数说明：可以设置多个星期下的多个可用时间段，比如每周二10点到18点

available_week.week_day

参数名：可用星期数
是否必填：否
参数说明：0代表周日，1代表周一，以此类推……

可用星期数示例：

设置批次的活动时间为2025年8月4日8点到2025年8月13日8点，固定每周一、周三、周五为生效星期，传参示例如下：

1"coupon_available_time" : {
2    "available_begin_time" : "2025-08-04T08:00:00+08:00",
3    "available_end_time" : "2025-08-13T08:00:00+08:00",
4    "available_week" : {
5          "week_day" : [
6            1,3,5
7          ]
8    }
9}

生效时间范围如下图所示，不详细列举年月，日期下方没有写具体时间段的代表全天时间。

黄色部分代表批次的有效期，紫色部分代表固定周期有效时间段，绿色部分的时间段结合日期代表这张券可以进行核销的的时间范围。

没有设置“领取后N天开始生效”和“生效后N天内有效”的场景下，无论何时领券，券可以进行核销的时间范围都固定为绿色部分。

available_week.available_day_time

参数名：当天可用时间段
是否必填：否
参数说明：在available_week.week_day的有效时间基础上，设置具体生效的时间段，可以填写多个时间段，最多不超过2个。

available_day_time的子参数：

available_day_time.begin_time
参数名：当天可用开始时间
是否必填：否
参数说明：当天可用开始时间，单位秒，1代表当天0点0分1秒
available_day_time.end_time
参数名：当天可用结束时间
是否必填：否
参数说明：当天可用结束时间，单位秒，86399代表当天23点59分59秒

注意：

1、当填写available_day_time时，week_day必填。

2、begin_time与end_time必须同时填写。填写多个时间段时，不同区间请勿重叠。

当天可用时间段示例：

设置批次的活动时间为2025年8月4日8点到2025年8月13日8点，固定周期有效时间段为周一、周三、周五6点到12点，传参示例如下：

1"coupon_available_time" : {
2    "available_begin_time" : "2025-08-04T08:00:00+08:00",
3    "available_end_time" : "2025-08-13T08:00:00+08:00",
4    "available_week" : {
5          "week_day" : [
6              1,3,5
7          ],
8          "available_day_time" : [
9              {
10                "begin_time" : 21600,
11                "end_time" : 43200
12              }
13          ]
14    }
15}

生效时间范围如下图所示，不详细列举年月，日期下方没有写具体时间段的代表全天时间，黄色部分代表批次的有效期，绿色部分的时间段结合日期代表这张券的生效的时间范围。

黄色部分代表批次的有效期，紫色部分代表固定周期有效时间段，绿色部分的时间段结合日期代表这张券可以进行核销的的时间范围。

没有设置“领取后N天开始生效”和“生效后N天内有效”的场景下，无论何时领券，券可以进行核销的时间范围都固定为绿色部分。

6、irregulary_avaliable_time

参数名：无规律的有效时间段
是否必填：否
参数说明：无规律的有效时间，多个无规律时间段

irregulary_avaliable_time.begin_time

参数名：开始时间
是否必填：否
参数说明：开始时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

irregulary_avaliable_time.end_time

参数名：结束时间
是否必填：否
参数说明：结束时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

注意：begin_time与end_time必须同时填写。填写多个时间段时，不同区间请勿重叠。

无规律的有效时间段示例：

设置批次的活动时间为2025年8月4日8点到2025年8月13日8点，无规律的有效时间段分别为2025年8月4日10点到2025年8月8日12点、2025年8月11日10点到2025年8月13日12点，传参示例如下：

1"coupon_available_time" : {
2    "available_begin_time" : "2025-08-04T08:00:00+08:00",
3    "available_end_time" : "2025-08-13T08:00:00+08:00",
4    "irregulary_avaliable_time" : [
5          {
6            "begin_time" : "2025-08-04T10:00:00+08:00",
7            "end_time" : "2025-08-08T012:00:00+08:00"
8          },
9          {
10            "begin_time" : "2025-08-11T10:00:00+08:00",
11            "end_time" : "2025-08-13T012:00:00+08:00"
12          }
13    ]
14}

生效时间范围如下图所示，不详细列举年月，日期下方没有写具体时间段的代表全天时间。

黄色部分代表批次的有效期，橙色部分代表无规律的有效时间段，绿色部分的时间段结合日期代表这张券可以进行核销的的时间范围。

没有设置“领取后N天开始生效”和“生效后N天内有效”的场景下，无论何时领券，券可以进行核销的时间范围都固定为绿色部分。

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服