mirror of
https://gitee.com/binary/weixin-java-tools.git
synced 2026-03-10 00:13:40 +08:00
🆕 #2018 【微信支付】增加营销代金券接口和营销专用图片上传接口
Co-authored-by: 黄星 <huang.xing@aquilaflycloud.com>
This commit is contained in:
thinsstar
@@ -0,0 +1,70 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 设置消息通知地址
|
||||
* <pre>
|
||||
* 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_12.shtml
|
||||
* </pre>
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class FavorCallbacksSaveRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 1L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商户号
|
||||
* 变量名：mchid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 微信支付商户号。
|
||||
* 示例值：9856888
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "mchid")
|
||||
private String mchid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：通知url地址
|
||||
* 变量名：notify_url
|
||||
* 是否必填：是
|
||||
* 类型：string[1,256]
|
||||
* 描述：
|
||||
* 支付通知商户url地址。
|
||||
* 示例值：https://pay.weixin.qq.com
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "notify_url")
|
||||
private String notifyUrl;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：回调开关
|
||||
* 变量名：switch
|
||||
* 是否必填：否
|
||||
* 类型：bool
|
||||
* 描述：
|
||||
* 如果商户不需要再接收营销事件通知，可通过该开关关闭。枚举值：
|
||||
* true：开启推送
|
||||
* false：停止推送
|
||||
* 示例值：true
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "switch")
|
||||
private Boolean switchBool;
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
/**
|
||||
* 设置消息通知地址返回结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorCallbacksSaveResult {
|
||||
|
||||
public static FavorCallbacksSaveResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorCallbacksSaveResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 修改时间
|
||||
* <p>
|
||||
* 修改时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("update_time")
|
||||
private String updateTime;
|
||||
|
||||
/**
|
||||
* 通知地址
|
||||
* <p>
|
||||
* 通知地址
|
||||
* 示例值：api.weixin.qq.com
|
||||
*/
|
||||
@SerializedName("notify_url")
|
||||
private String notifyUrl;
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 发放代金券
|
||||
* <pre>
|
||||
* 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_2.shtml
|
||||
* </pre>
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class FavorCouponsCreateRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 1L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次号
|
||||
* 变量名：stock_id
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 微信为每个批次分配的唯一id。
|
||||
* 校验规则：必须为代金券（全场券或单品券）批次号，不支持立减与折扣。
|
||||
* 示例值：9856000
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_id")
|
||||
private String stockId;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商户单据号
|
||||
* 变量名：out_request_no
|
||||
* 是否必填：是
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 商户此次发放凭据号（格式：商户id+日期+流水号），可包含英文字母，数字，|，_，*，-等内容，不允许出现其他不合法符号，商户侧需保持唯一性。
|
||||
* 示例值： 89560002019101000121
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "out_request_no")
|
||||
private String outRequestNo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：公众账号ID
|
||||
* 变量名：appid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 微信为发券方商户分配的公众账号ID，接口传入的所有appid应该为公众号的appid或者小程序的appid（在mp.weixin.qq.com申请的），不能为APP的appid（在open.weixin.qq.com申请的）。。
|
||||
* 校验规则：
|
||||
* 1、该appid需要与接口传入中的openid有对应关系；
|
||||
* 2、该appid需要与调用接口的商户号（即请求头中的商户号）有绑定关系，若未绑定，可参考该指引完成绑定（商家商户号与AppID账号关联管理）
|
||||
* 示例值：wx233544546545989
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "appid")
|
||||
private String appid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：创建批次的商户号
|
||||
* 变量名：stock_creator_mchid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次创建方商户号。
|
||||
* 示例值：8956000
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_creator_mchid")
|
||||
private String stockCreatorMchid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：指定面额发券，面额
|
||||
* 变量名：coupon_value
|
||||
* 是否必填：否
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 指定面额发券场景，券面额，其他场景不需要填，单位：分。
|
||||
* 校验规则：仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息。
|
||||
* 示例值：100
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "coupon_value")
|
||||
private Integer couponValue;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：指定面额发券，券门槛
|
||||
* 变量名：coupon_minimum
|
||||
* 是否必填：是
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 指定面额发券批次门槛，其他场景不需要，单位：分。
|
||||
* 校验规则：仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息。
|
||||
* 示例值：100
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "coupon_minimum")
|
||||
private Integer couponMinimum;
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
/**
|
||||
* 发放代金券返回结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorCouponsCreateResult {
|
||||
|
||||
public static FavorCouponsCreateResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorCouponsCreateResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 代金券id
|
||||
* <p>
|
||||
* 发放给用户的代金券id。
|
||||
* 示例值：9867041
|
||||
*/
|
||||
@SerializedName("coupon_id")
|
||||
private String couponId;
|
||||
}
|
||||
@@ -0,0 +1,199 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 查询代金券详情结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorCouponsGetResult {
|
||||
|
||||
public static FavorCouponsGetResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorCouponsGetResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建批次的商户号
|
||||
* <p>
|
||||
* 批次创建方商户号
|
||||
* 示例值：9800064
|
||||
*/
|
||||
@SerializedName("stock_creator_mchid")
|
||||
private String stockCreatorMchid;
|
||||
|
||||
/**
|
||||
* 批次号
|
||||
* <p>
|
||||
* 微信为每个代金券批次分配的唯一id。
|
||||
* 示例值：9865888
|
||||
*/
|
||||
@SerializedName("stock_id")
|
||||
private String stockId;
|
||||
|
||||
/**
|
||||
* 代金券id
|
||||
* <p>
|
||||
* 微信为代金券唯一分配的id。
|
||||
* 示例值：98674556
|
||||
*/
|
||||
@SerializedName("coupon_id")
|
||||
private String couponId;
|
||||
|
||||
/**
|
||||
* 单品优惠特定信息
|
||||
* <p>
|
||||
* 单品优惠特定信息
|
||||
*/
|
||||
@SerializedName("cut_to_message")
|
||||
private CutToMessage cutToMessage;
|
||||
|
||||
/**
|
||||
* 代金券名称
|
||||
* <p>
|
||||
* 代金券名称
|
||||
* 示例值：微信支付代金券
|
||||
*/
|
||||
@SerializedName("coupon_name")
|
||||
private String couponName;
|
||||
|
||||
/**
|
||||
* 代金券状态
|
||||
* <p>
|
||||
* 代金券状态：
|
||||
* SENDED：可用
|
||||
* USED：已实扣
|
||||
* EXPIRED：已过期
|
||||
* 示例值：EXPIRED
|
||||
*/
|
||||
@SerializedName("status")
|
||||
private String status;
|
||||
|
||||
/**
|
||||
* 使用说明
|
||||
* <p>
|
||||
* 代金券描述说明字段。
|
||||
* 示例值：微信支付营销
|
||||
*/
|
||||
@SerializedName("description")
|
||||
private String description;
|
||||
|
||||
/**
|
||||
* 领券时间
|
||||
* <p>
|
||||
* 领券时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值: 2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("create_time")
|
||||
private String createTime;
|
||||
|
||||
/**
|
||||
* 券类型
|
||||
* <p>
|
||||
* 券类型：
|
||||
* NORMAL：满减券
|
||||
* CUT_TO：减至券
|
||||
* 示例值：CUT_TO
|
||||
*/
|
||||
@SerializedName("coupon_type")
|
||||
private String couponType;
|
||||
|
||||
/**
|
||||
* 是否无资金流
|
||||
* <p>
|
||||
* 枚举值：
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：true
|
||||
*/
|
||||
@SerializedName("no_cash")
|
||||
private Boolean noCash;
|
||||
|
||||
/**
|
||||
* 可用开始时间
|
||||
* <p>
|
||||
* 可用开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值: 2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("available_begin_time")
|
||||
private String availableBeginTime;
|
||||
|
||||
/**
|
||||
* 可用结束时间
|
||||
* <p>
|
||||
* 可用结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值: 2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("available_end_time")
|
||||
private String availableEndTime;
|
||||
|
||||
/**
|
||||
* 是否单品优惠
|
||||
* <p>
|
||||
* 枚举值：
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：true
|
||||
*/
|
||||
@SerializedName("singleitem")
|
||||
private Boolean singleitem;
|
||||
|
||||
/**
|
||||
* 满减券信息
|
||||
* <p>
|
||||
* 普通满减券面额、门槛信息。
|
||||
*/
|
||||
@SerializedName("normal_coupon_information")
|
||||
private NormalCouponInformation normalCouponInformation;
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class CutToMessage implements Serializable {
|
||||
/**
|
||||
* 可用优惠的商品最高单价
|
||||
* <p>
|
||||
* 可用优惠的商品最高单价，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "single_price_max")
|
||||
private Integer singlePriceMax;
|
||||
|
||||
/**
|
||||
* 减至后的优惠单价
|
||||
* <p>
|
||||
* 减至后的优惠单价，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "cut_to_price")
|
||||
private Integer cutToPrice;
|
||||
}
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class NormalCouponInformation implements Serializable {
|
||||
/**
|
||||
* 面额
|
||||
* <p>
|
||||
* 面额，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "coupon_amount")
|
||||
private Integer couponAmount;
|
||||
|
||||
/**
|
||||
* 门槛
|
||||
* <p>
|
||||
* 使用券金额门槛，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "transaction_minimum")
|
||||
private Integer transactionMinimum;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,155 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 根据商户号查用户的券
|
||||
* <pre>
|
||||
* 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_9.shtml
|
||||
* </pre>
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class FavorCouponsQueryRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 1L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：用户标识
|
||||
* 变量名：openid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 用户在商户appid 下的唯一标识。
|
||||
* 示例值：2323dfsdf342342
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "openid")
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：公众账号ID
|
||||
* 变量名：appid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 微信为发券方商户分配的公众账号ID，接口传入的所有appid应该为公众号的appid（在mp.weixin.qq.com申请的），不能为APP的appid（在open.weixin.qq.com申请的）。
|
||||
* 示例值：wx233544546545989
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "appid")
|
||||
private String appid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次号
|
||||
* 变量名：stock_id
|
||||
* 是否必填：否
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次号，是否指定批次号查询，填写available_mchid，该字段不生效。
|
||||
* 示例值：9865000
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_id")
|
||||
private String stockId;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：券状态
|
||||
* 变量名：status
|
||||
* 是否必填：否
|
||||
* 类型：string[1,6]
|
||||
* 描述：
|
||||
* 代金券状态：
|
||||
* SENDED：可用
|
||||
* USED：已实扣
|
||||
* 填写available_mchid，该字段不生效。
|
||||
* 示例值：USED
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "status")
|
||||
private String status;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：创建批次的商户号
|
||||
* 变量名：creator_mchid
|
||||
* 是否必填：否
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次创建方商户号。
|
||||
* 示例值：9865002
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "creator_mchid")
|
||||
private String creatorMchid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次发放商户号
|
||||
* 变量名：sender_mchid
|
||||
* 是否必填：否
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次创建方商户号。
|
||||
* 示例值：9865002
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "sender_mchid")
|
||||
private String senderMchid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：可用商户号
|
||||
* 变量名：available_mchid
|
||||
* 是否必填：否
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次创建方商户号。
|
||||
* 示例值：9865002
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "available_mchid")
|
||||
private String availableMchid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：分页页码
|
||||
* 变量名：offset
|
||||
* 是否必填：是
|
||||
* 类型：uint32
|
||||
* 描述：
|
||||
* 页码从0开始，默认第0页。
|
||||
* 示例值：1
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "offset")
|
||||
private Integer offset;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：分页大小
|
||||
* 变量名：limit
|
||||
* 是否必填：是
|
||||
* 类型：uint32
|
||||
* 描述：
|
||||
* 分页大小，最大10。
|
||||
* 示例值：8
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "limit")
|
||||
private Integer limit;
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 条件查询代金券批次列表结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorCouponsQueryResult {
|
||||
|
||||
public static FavorCouponsQueryResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorCouponsQueryResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 查询结果总数
|
||||
* <p>
|
||||
* 查询结果总数
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName("total_count")
|
||||
private Integer totalCount;
|
||||
|
||||
/**
|
||||
* 批次详情
|
||||
* <p>
|
||||
* 批次详情
|
||||
*/
|
||||
@SerializedName("data")
|
||||
private List<FavorCouponsGetResult> data;
|
||||
|
||||
/**
|
||||
* 分页大小
|
||||
* <p>
|
||||
* 分页大小
|
||||
* 示例值：10
|
||||
*/
|
||||
@SerializedName("limit")
|
||||
private Integer limit;
|
||||
|
||||
/**
|
||||
* 分页页码
|
||||
* <p>
|
||||
* 分页页码
|
||||
* 示例值：10
|
||||
*/
|
||||
@SerializedName("offset")
|
||||
private Integer offset;
|
||||
}
|
||||
@@ -0,0 +1,736 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.github.binarywang.wxpay.bean.marketing.enums.BackgroundColorEnum;
|
||||
import com.github.binarywang.wxpay.bean.marketing.enums.StockTypeEnum;
|
||||
import com.github.binarywang.wxpay.bean.marketing.enums.TradeTypeEnum;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 创建代金券批次
|
||||
* <pre>
|
||||
* 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_1.shtml
|
||||
* </pre>
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class FavorStocksCreateRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 1L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次名称
|
||||
* 变量名：stock_name
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次名称
|
||||
* 校验规则：
|
||||
* 1、批次名称最多9个中文汉字
|
||||
* 2、批次名称最多20个字母
|
||||
* 3、批次名称中不能包含不当内容和特殊字符 _ , ; |
|
||||
* 示例值：微信支付代金券批次
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_name")
|
||||
private String stockName;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次备注
|
||||
* 变量名：comment
|
||||
* 是否必填：否
|
||||
* 类型：string[1,60]
|
||||
* 描述：
|
||||
* 仅制券商户可见，用于自定义信息。
|
||||
* 校验规则：批次备注最多60个UTF8字符数
|
||||
* 示例值：零售批次
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "comment")
|
||||
private String comment;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：归属商户号
|
||||
* 变量名：belong_merchant
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次归属商户号
|
||||
* 该字段暂未开放
|
||||
* 示例值：98568865
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "belong_merchant")
|
||||
private String belongMerchant;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：可用时间-开始时间
|
||||
* 变量名：available_begin_time
|
||||
* 是否必填：是
|
||||
* 类型：string[1,32]
|
||||
* 描述：
|
||||
* 批次开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 校验规则：
|
||||
* 1、开始时间不可早于当前时间
|
||||
* 2、不能创建365天后开始的批次
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "available_begin_time")
|
||||
private String availableBeginTime;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：可用时间-结束时间
|
||||
* 变量名：available_end_time
|
||||
* 是否必填：是
|
||||
* 类型：string[1,32]
|
||||
* 描述：
|
||||
* 批次结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 校验规则：
|
||||
* 1、结束时间需晚于开始时间
|
||||
* 2、可用时间最长为90天
|
||||
* 3、有效时间间隔最短为1s
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "available_end_time")
|
||||
private String availableEndTime;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：发放规则
|
||||
* 变量名：stock_use_rule
|
||||
* 是否必填：是
|
||||
* 类型：object
|
||||
* 描述：批次使用规则
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_use_rule")
|
||||
private StockUseRule stockUseRule;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：样式设置
|
||||
* 变量名：pattern_info
|
||||
* 是否必填：否
|
||||
* 类型：object
|
||||
* 描述：代金券详情页
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "pattern_info")
|
||||
private PatternInfo patternInfo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：核销规则
|
||||
* 变量名：coupon_use_rule
|
||||
* 是否必填：是
|
||||
* 类型：object
|
||||
* 描述：核销规则
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "coupon_use_rule")
|
||||
private CouponUseRule couponUseRule;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：营销经费
|
||||
* 变量名：no_cash
|
||||
* 是否必填：是
|
||||
* 类型：bool
|
||||
* 描述：
|
||||
* 营销经费。枚举值：
|
||||
* true：免充值
|
||||
* false：预充值
|
||||
* 1、免充值：制券方无需提前充值资金，用户核销代金券时，直接从订单原价中扣除优惠减价金额，最终只将用户实际支付的金额结算给核销商户，商户实收少于订单原价。
|
||||
* 2、预充值：制券方需将优惠预算提前充值到微信支付商户可用余额中，用户核销代金券时，系统从制券方商户可用余额中扣除优惠减价部分对应的资金，连同用户实际支付的资金，一并结算给核销商户，不影响实收。
|
||||
* 示例值：false
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "no_cash")
|
||||
private Boolean noCash;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次类型
|
||||
* 变量名：stock_type
|
||||
* 是否必填：是
|
||||
* 类型：string[1,16]
|
||||
* 描述：
|
||||
* 批次类型，仅支持：
|
||||
* NORMAL：固定面额满减券批次
|
||||
* 示例值：NORMAL
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_type")
|
||||
private StockTypeEnum stockType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商户单据号
|
||||
* 变量名：out_request_no
|
||||
* 是否必填：是
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 商户创建批次凭据号（格式：商户id+日期+流水号），可包含英文字母，数字，|，_，*，-等内容，不允许出现其他不合法符号，商户侧需保持商户单据号全局唯一。
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "out_request_no")
|
||||
private String outRequestNo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：扩展属性
|
||||
* 变量名：ext_info
|
||||
* 是否必填：否
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 扩展属性字段，按json格式，如无需要则不填写。
|
||||
* 示例值：{'exinfo1':'1234','exinfo2':'3456'}
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "ext_info")
|
||||
private String extInfo;
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class StockUseRule implements Serializable {
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：发放总上限
|
||||
* 变量名：max_coupons
|
||||
* 是否必填：是
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 最大发券数
|
||||
* 校验规则：
|
||||
* 1、发放总个数最少5个
|
||||
* 2、发放总个数最多1000万个
|
||||
* 示例值：100
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "max_coupons")
|
||||
private Integer maxCoupons;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：总预算
|
||||
* 变量名：max_amount
|
||||
* 是否必填：是
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 最大发券预算，当营销经费no_cash选择预充值false时，激活批次时会从制券商户的余额中扣除预算，请保证账户金额充足，单位：分
|
||||
* max_amount需要等于coupon_amount（面额） * max_coupons（发放总上限）
|
||||
* 校验规则：批次总预算最多1亿元
|
||||
* 示例值：5000
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "max_amount")
|
||||
private Integer maxAmount;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：单天预算发放上限
|
||||
* 变量名：max_amount_by_day
|
||||
* 是否必填：否
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 设置此字段，允许指定单天最大发券预算，单位：分。
|
||||
* 校验规则：不能大于总预算
|
||||
* 示例值：400
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "max_amount_by_day")
|
||||
private Integer maxAmountByDay;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：单个用户可领个数
|
||||
* 变量名：max_coupons_per_user
|
||||
* 是否必填：是
|
||||
* 类型：uint32
|
||||
* 描述：
|
||||
* 活动期间每个用户可领个数，当开启了自然人限领时，多个微信号同属于一个身份证时，视为同一用户。
|
||||
* 校验规则：
|
||||
* 1、不能大于发放总个数
|
||||
* 2、最少为1个，最多为60个
|
||||
* 示例值：3
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "max_coupons_per_user")
|
||||
private Integer maxCouponsPerUser;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：是否开启自然人限制
|
||||
* 变量名：natural_person_limit
|
||||
* 是否必填：是
|
||||
* 类型：bool
|
||||
* 描述：
|
||||
* 当开启了自然人限领时，多个微信号同属于一个身份证时，视为同一用户，枚举值
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：false
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "natural_person_limit")
|
||||
private Boolean naturalPersonLimit;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：是否开启防刷拦截
|
||||
* 变量名：prevent_api_abuse
|
||||
* 是否必填：是
|
||||
* 类型：bool
|
||||
* 描述：
|
||||
* 若开启防刷拦截，当用户命中恶意、小号、机器、羊毛党、黑产等风险行为时，无法成功发放代金券。
|
||||
* 枚举值
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：false
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "prevent_api_abuse")
|
||||
private Boolean preventApiAbuse;
|
||||
}
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class PatternInfo implements Serializable {
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：使用说明
|
||||
* 变量名：description
|
||||
* 是否必填：是
|
||||
* 类型：string[1,3000]
|
||||
* 描述：
|
||||
* 用于说明详细的活动规则，会展示在代金券详情页。
|
||||
* 校验规则：最多1000个UTF8字符
|
||||
* 示例值：微信支付营销代金券
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "description")
|
||||
private String description;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：商户logo
|
||||
* 变量名：merchant_logo
|
||||
* 是否必填：否
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 商户logo ，仅支持通过《图片上传API》接口获取的图片URL地址。
|
||||
* 1、商户logo大小需为120像素*120像素。
|
||||
* 2、支持JPG/JPEG/PNG格式，且图片小于1M。
|
||||
* 3、最多128个UTF8字符
|
||||
* 示例值：https://qpic.cn/xxx
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "merchant_logo")
|
||||
private String merchantLogo;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：品牌名称
|
||||
* 变量名：merchant_name
|
||||
* 是否必填：否
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 品牌名称，展示在用户卡包
|
||||
* 校验规则：
|
||||
* 1、最多12个中文汉字
|
||||
* 2、最多36个英文字符
|
||||
* 示例值：微信支付
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "merchant_name")
|
||||
private String merchantName;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：背景颜色
|
||||
* 变量名：background_color
|
||||
* 是否必填：否
|
||||
* 类型：string[1,15]
|
||||
* 描述：
|
||||
* 券的背景颜色，可设置10种颜色，色值请参考卡券背景颜色图。颜色取值为颜色图中的颜色名称。可选枚举字段不用则不传，不可以传空值
|
||||
* 示例值：COLOR020
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "background_color")
|
||||
private BackgroundColorEnum backgroundColor;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：券详情图片
|
||||
* 变量名：coupon_image
|
||||
* 是否必填：是
|
||||
* 类型：string[1,128]
|
||||
* 描述：
|
||||
* 券详情图片， 850像素*350像素，且图片大小不超过2M，支持JPG/PNG格式，仅支持通过《图片上传API》接口获取的图片URL地址。。
|
||||
* 示例值：https://qpic.cn/xxx
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "coupon_image")
|
||||
private Boolean couponImage;
|
||||
}
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class CouponUseRule implements Serializable {
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：券生效时间
|
||||
* 变量名：coupon_available_time
|
||||
* 是否必填：否
|
||||
* 类型：object
|
||||
* 描述：
|
||||
* 允许指定券的特殊生效时间规则。
|
||||
* 该字段暂未开放
|
||||
* </pre>
|
||||
*/
|
||||
// @SerializedName(value = "coupon_available_time")
|
||||
// private CouponAvailableTime couponAvailableTime;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：固定面额满减券使用规则
|
||||
* 变量名：fixed_normal_coupon
|
||||
* 是否必填：否
|
||||
* 类型：object
|
||||
* 描述：
|
||||
* stock_type为NORMAL时必填。
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "fixed_normal_coupon")
|
||||
private FixedNormalCoupon fixedNormalCoupon;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：订单优惠标记
|
||||
* 变量名：goods_tag
|
||||
* 是否必填：否
|
||||
* 类型：array
|
||||
* 描述：
|
||||
* 订单优惠标记，按json格式。
|
||||
* 商户下单时需要传入相同的标记(goods_tag)，用户同时符合其他规则才能享受优惠
|
||||
* 校验规则：
|
||||
* 1、最多允许录入50个
|
||||
* 2、每个订单优惠标记支持字母/数字/下划线，不超过128个UTF8字符。
|
||||
* 示例值：["123321","456654"]
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "goods_tag")
|
||||
private List<String> goodsTag;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：指定付款方式
|
||||
* 变量名：limit_pay
|
||||
* 是否必填：否
|
||||
* 类型：array[1,1]
|
||||
* 描述：
|
||||
* 指定付款方式的交易可核销/使用代金券，可指定零钱付款、指定银行卡付款，需填入支付方式编码， 不在此列表中的银行卡，暂不支持此功能。
|
||||
* 校验规则：条目个数限制为【1，1】。
|
||||
* 示例值：ICBC_CREDIT
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "limit_pay")
|
||||
private List<String> limitPay;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：指定银行卡BIN
|
||||
* 变量名：limit_card
|
||||
* 是否必填：否
|
||||
* 类型：object
|
||||
* 描述：
|
||||
* 指定银行卡bin付款的交易可核销/使用代金券，当批次限定了指定银行卡时方可生效
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "limit_card")
|
||||
private LimitCard limitCard;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：支付方式
|
||||
* 变量名：trade_type
|
||||
* 是否必填：否
|
||||
* 类型：array
|
||||
* 描述：
|
||||
* 允许指定支付方式的交易才可核销/使用代金券，不填则默认“不限”。
|
||||
* 枚举值：
|
||||
* MICROAPP：小程序支付
|
||||
* APPPAY：APP支付
|
||||
* PPAY：免密支付
|
||||
* CARD：刷卡支付
|
||||
* FACE：人脸支付
|
||||
* OTHER：其他支付
|
||||
* 示例值：["MICROAPP","APPPAY"]
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "trade_type")
|
||||
private List<TradeTypeEnum> tradeType;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：是否可叠加其他优惠
|
||||
* 变量名：combine_use
|
||||
* 是否必填：否
|
||||
* 类型：bool
|
||||
* 描述：
|
||||
* 允许指定本优惠是否可以和本商户号创建的其他券同时使用，不填则默认允许同时使用。枚举值：
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：false
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "combine_use")
|
||||
private Boolean combineUse;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：可核销商品编码
|
||||
* 变量名：available_items
|
||||
* 是否必填：否
|
||||
* 类型：array
|
||||
* 描述：
|
||||
* 包含指定SKU商品编码的交易才可核销/使用代金券：活动商户在交易下单时，需传入用户购买的所有SKU商品编码，当命中代金券中设置的商品编码时可享受优惠。
|
||||
* 校验规则：
|
||||
* 1、单个商品编码的字符长度为【1，128】
|
||||
* 2、条目个数限制为【1，50】
|
||||
* 示例值：['123321','456654']
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "available_items")
|
||||
private List<String> availableItems;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：不可核销商品编码
|
||||
* 变量名：unavailable_items
|
||||
* 是否必填：否
|
||||
* 类型：array
|
||||
* 描述：
|
||||
* 该字段暂未开放
|
||||
* 包含指定SKU商品编码的交易不可核销/使用代金券。
|
||||
* 校验规则：
|
||||
* 1、单个商品编码的字符长度为【1，128】
|
||||
* 2、条目个数限制为【1，50】
|
||||
* 示例值：['789987','56765']
|
||||
* </pre>
|
||||
*/
|
||||
// @SerializedName(value = "unavailable_items")
|
||||
// private List<String> unavailableItems;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：可用商户号
|
||||
* 变量名：available_merchants
|
||||
* 是否必填：是
|
||||
* 类型：array
|
||||
* 描述：
|
||||
* 可用商户的交易才可核销/使用代金券。当营销经费no_cash=false时，可用商户允许填入任何类型的特约商户或普通商户
|
||||
* 当营销经费no_cash=ture时，分为以下几种情况：
|
||||
* 1、创建商户是普通商户或服务商特约商户(子商户)：可添加本商户号或同品牌商户。
|
||||
* 说明：若可用商户中，有特约商户(子商户)，那么特约商户自己发起的交易、以及服务商帮特约商户发起的交易，都可以使用代金券。
|
||||
* 2、创建商户是普通服务商：可添加已授权的子商户，详见《申请免充值代金券产品权限》。
|
||||
* 说明：特约商户如果有多个服务商，那么服务商为他发起的交易，只要完成了免充值授权，都可以使用代金券；特约商户自己发起的交易不可以使用代金券。
|
||||
* 3、创建商户是渠道商、银行服务商或从业机构：可直接添加旗下任意子商户，不需要子商户授权。
|
||||
* 示例值：['9856000','9856111']
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "available_merchants")
|
||||
private List<String> availableMerchants;
|
||||
}
|
||||
|
||||
// @Data
|
||||
// @NoArgsConstructor
|
||||
// public static class CouponAvailableTime implements Serializable {
|
||||
// /**
|
||||
// * <pre>
|
||||
// * 字段名：固定时间段可用
|
||||
// * 变量名：fix_available_time
|
||||
// * 是否必填：否
|
||||
// * 类型：object
|
||||
// * 描述：
|
||||
// * 允许指定券在特殊时间段生效。当设置固定时间段可用时不可设置领取后N天有效
|
||||
// * 该字段暂未开放
|
||||
// * </pre>
|
||||
// */
|
||||
// @SerializedName(value = "fix_available_time")
|
||||
// private FixAvailableTime fixAvailableTime;
|
||||
//
|
||||
// /**
|
||||
// * <pre>
|
||||
// * 字段名：领取后N天有效
|
||||
// * 变量名：second_day_available
|
||||
// * 是否必填：否
|
||||
// * 类型：bool
|
||||
// * 描述：
|
||||
// * 领取后，券的开始时间为领券后第二天，如7月1日领券，那么在7月2日00:00:00开始。
|
||||
// * 当设置领取后N天有效时，不可设置固定时间段可用。
|
||||
// * 枚举值：
|
||||
// * true：是
|
||||
// * false：否
|
||||
// * 该字段暂未开放
|
||||
// * 示例值：false
|
||||
// * </pre>
|
||||
// */
|
||||
// @SerializedName(value = "second_day_available")
|
||||
// private Boolean secondDayAvailable;
|
||||
//
|
||||
// /**
|
||||
// * <pre>
|
||||
// * 字段名：领取后有效时间
|
||||
// * 变量名：available_time_after_receive
|
||||
// * 是否必填：否
|
||||
// * 类型：uint32
|
||||
// * 描述：
|
||||
// * 领取后，券的结束时间为领取N天后，如设置领取后7天有效，那么7月1日领券，在7月7日23:59:59失效（在可用时间内计算失效时间，若券还未到领取后N天，但是已经到了可用结束时间，那么也会过期）
|
||||
// * 领取后有效时间，单位：分钟。
|
||||
// * 该字段暂未开放
|
||||
// * 示例值：1440
|
||||
// * </pre>
|
||||
// */
|
||||
// @SerializedName(value = "available_time_after_receive")
|
||||
// private Integer availableTimeAfterReceive;
|
||||
// }
|
||||
//
|
||||
// @Data
|
||||
// @NoArgsConstructor
|
||||
// public static class FixAvailableTime implements Serializable {
|
||||
// /**
|
||||
// * <pre>
|
||||
// * 字段名：可用星期数
|
||||
// * 变量名：available_week_day
|
||||
// * 是否必填：否
|
||||
// * 类型：uint32
|
||||
// * 描述：
|
||||
// * 允许指定每周固定星期数生效，0代表周日生效，1代表周一生效，以此类推；不填则代表在可用时间内周一至周日都生效。
|
||||
// * 该字段暂未开放
|
||||
// * 示例值：1，2
|
||||
// * </pre>
|
||||
// */
|
||||
// @SerializedName(value = "available_week_day")
|
||||
// private Integer availableWeekDay;
|
||||
//
|
||||
// /**
|
||||
// * <pre>
|
||||
// * 字段名：当天开始时间
|
||||
// * 变量名：begin_time
|
||||
// * 是否必填：否
|
||||
// * 类型：uint32
|
||||
// * 描述：
|
||||
// * 允许指定特殊生效星期数中的具体生效的时间段。
|
||||
// * 当天开始时间，单位：秒。
|
||||
// * 该字段暂未开放
|
||||
// * 示例值：0
|
||||
// * </pre>
|
||||
// */
|
||||
// @SerializedName(value = "begin_time")
|
||||
// private Integer beginTime;
|
||||
//
|
||||
// /**
|
||||
// * <pre>
|
||||
// * 字段名：当天结束时间
|
||||
// * 变量名：end_time
|
||||
// * 是否必填：否
|
||||
// * 类型：uint32
|
||||
// * 描述：
|
||||
// * 允许指定特殊生效星期数中的具体生效的时间段。
|
||||
// * 当天结束时间，单位：秒，默认为23点59分59秒。
|
||||
// * 该字段暂未开放
|
||||
// * 示例值：3600
|
||||
// * </pre>
|
||||
// */
|
||||
// @SerializedName(value = "end_time")
|
||||
// private Integer endTime;
|
||||
// }
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class FixedNormalCoupon implements Serializable {
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：面额
|
||||
* 变量名：fixed_normal_coupon
|
||||
* 是否必填：是
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 面额，单位：分。
|
||||
* 校验规则：
|
||||
* 1、必须为整数
|
||||
* 2、必须大于1分且小于等于1000元
|
||||
* 示例值：100
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "coupon_amount")
|
||||
private Integer couponAmount;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：门槛
|
||||
* 变量名：transaction_minimum
|
||||
* 是否必填：是
|
||||
* 类型：uint64
|
||||
* 描述：
|
||||
* 使用券金额门槛，单位：分。
|
||||
* 若指定可核销商品编码，门槛则为可核销商品部分的消费金额，而不是订单的消费金额。
|
||||
* 校验规则：使用门槛必须大于优惠金额
|
||||
* 示例值：100
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "transaction_minimum")
|
||||
private Integer transactionMinimum;
|
||||
}
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class LimitCard implements Serializable {
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：银行卡名称
|
||||
* 变量名：name
|
||||
* 是否必填：否
|
||||
* 类型：string[1,4]
|
||||
* 描述：
|
||||
* 将在微信支付收银台向用户展示，最多4个中文汉字
|
||||
* 示例值：精粹白金
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "name")
|
||||
private String name;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：指定卡BIN
|
||||
* 变量名：bin
|
||||
* 是否必填：否
|
||||
* 类型：array
|
||||
* 描述：
|
||||
* 使用指定卡BIN的银行卡支付方可享受优惠，按json格式
|
||||
* 特殊规则：单个卡BIN的字符长度为【6,9】,条目个数限制为【1,10】。
|
||||
* 示例值：['62123456','62123457']
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "bin")
|
||||
private List<String> bin;
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
/**
|
||||
* 创建代金券批次返回结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksCreateResult {
|
||||
|
||||
public static FavorStocksCreateResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksCreateResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 批次号
|
||||
* <p>
|
||||
* 微信为每个代金券批次分配的唯一ID。
|
||||
* 示例值：98065001
|
||||
*/
|
||||
@SerializedName("stock_id")
|
||||
private String stockId;
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
/**
|
||||
* 获取下载结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksFlowGetResult {
|
||||
|
||||
public static FavorStocksFlowGetResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksFlowGetResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 下载链接
|
||||
* <p>
|
||||
* 流水文件下载链接，30s内有效。
|
||||
* 示例值：download://example.csv
|
||||
*/
|
||||
@SerializedName("url")
|
||||
private String url;
|
||||
|
||||
/**
|
||||
* 安全校验码
|
||||
* <p>
|
||||
* 文件内容的哈希值，防止篡改。
|
||||
* 示例值：8ae0eb442c408d2e90d669d6f4ad6b7e6e049d6f
|
||||
*/
|
||||
@SerializedName("hash_value")
|
||||
private String hashValue;
|
||||
|
||||
/**
|
||||
* 哈希算法类型
|
||||
* <p>
|
||||
* 哈希算法类型，目前只支持SHA1。
|
||||
* 示例值：SHA1
|
||||
*/
|
||||
@SerializedName("hash_type")
|
||||
private String hashType;
|
||||
}
|
||||
@@ -0,0 +1,319 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 查询批次详情结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksGetResult {
|
||||
|
||||
public static FavorStocksGetResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksGetResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 批次号
|
||||
* <p>
|
||||
* 微信为每个代金券批次分配的唯一id。
|
||||
* 示例值：9836588
|
||||
*/
|
||||
@SerializedName("stock_id")
|
||||
private String stockId;
|
||||
|
||||
/**
|
||||
* 创建批次的商户号
|
||||
* <p>
|
||||
* 批次创建方商户号。
|
||||
* 示例值：123456
|
||||
*/
|
||||
@SerializedName("stock_creator_mchid")
|
||||
private String stockCreatorMchid;
|
||||
|
||||
/**
|
||||
* 批次名称
|
||||
* <p>
|
||||
* 批次名称
|
||||
* 示例值：微信支付批次
|
||||
*/
|
||||
@SerializedName("stock_name")
|
||||
private String stockName;
|
||||
|
||||
/**
|
||||
* 批次状态
|
||||
* <p>
|
||||
* 批次状态
|
||||
* 枚举值：
|
||||
* unactivated：未激活
|
||||
* audit：审核中
|
||||
* running：运行中
|
||||
* stoped：已停止
|
||||
* paused：暂停发放
|
||||
* 示例值：paused
|
||||
*/
|
||||
@SerializedName("status")
|
||||
private String status;
|
||||
|
||||
/**
|
||||
* 创建时间
|
||||
* <p>
|
||||
* 批次创建时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("create_time")
|
||||
private String create_time;
|
||||
|
||||
/**
|
||||
* 使用说明
|
||||
* <p>
|
||||
* 批次描述信息
|
||||
* 示例值：微信支付营销
|
||||
*/
|
||||
@SerializedName("description")
|
||||
private String description;
|
||||
|
||||
/**
|
||||
* 满减券批次使用规则
|
||||
* <p>
|
||||
* 普通发券批次特定信息。
|
||||
* 示例值：1900000109
|
||||
*/
|
||||
@SerializedName("stock_use_rule")
|
||||
private StockUseRule stockUseRule;
|
||||
|
||||
/**
|
||||
* 可用开始时间
|
||||
* <p>
|
||||
* 可用开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("available_begin_time")
|
||||
private String availableBeginTime;
|
||||
|
||||
/**
|
||||
* 可用结束时间
|
||||
* <p>
|
||||
* 可用结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("available_end_time")
|
||||
private String availableEndTime;
|
||||
|
||||
/**
|
||||
* 已发券数量
|
||||
* <p>
|
||||
* 已发券数量
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName("distributed_coupons")
|
||||
private Integer distributedCoupons;
|
||||
|
||||
/**
|
||||
* 是否无资金流
|
||||
* <p>
|
||||
* 是否无资金流。
|
||||
* ture：是
|
||||
* false：否
|
||||
* 示例值：true
|
||||
*/
|
||||
@SerializedName("no_cash")
|
||||
private Boolean noCash;
|
||||
|
||||
/**
|
||||
* 激活批次的时间
|
||||
* <p>
|
||||
* 批次激活开启时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("start_time")
|
||||
private String startTime;
|
||||
|
||||
/**
|
||||
* 终止批次的时间
|
||||
* <p>
|
||||
* 批次永久停止时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("stop_time")
|
||||
private String stopTime;
|
||||
|
||||
/**
|
||||
* 单品优惠特定信息
|
||||
* <p>
|
||||
* 单品优惠特定信息
|
||||
*/
|
||||
@SerializedName("cut_to_message")
|
||||
private CutToMessage cutToMessage;
|
||||
|
||||
/**
|
||||
* 是否单品优惠
|
||||
* <p>
|
||||
* 枚举值：
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：true
|
||||
*/
|
||||
@SerializedName("singleitem")
|
||||
private Boolean singleitem;
|
||||
|
||||
/**
|
||||
* 批次类型
|
||||
* <p>
|
||||
* 批次类型， 枚举值：
|
||||
* NORMAL：代金券批次
|
||||
* DISCOUNT_CUT：立减与折扣
|
||||
* OTHER：其他
|
||||
* 示例值：NORMAL
|
||||
*/
|
||||
@SerializedName("stock_type")
|
||||
private String stockType;
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class CutToMessage implements Serializable {
|
||||
/**
|
||||
* 可用优惠的商品最高单价
|
||||
* <p>
|
||||
* 可用优惠的商品最高单价，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "single_price_max")
|
||||
private Integer singlePriceMax;
|
||||
|
||||
/**
|
||||
* 减至后的优惠单价
|
||||
* <p>
|
||||
* 减至后的优惠单价，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "cut_to_price")
|
||||
private Integer cutToPrice;
|
||||
}
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class StockUseRule implements Serializable {
|
||||
/**
|
||||
* 发放总上限
|
||||
* <p>
|
||||
* 最大发券数
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "max_coupons")
|
||||
private Integer maxCoupons;
|
||||
|
||||
/**
|
||||
* 总预算
|
||||
* <p>
|
||||
* 总消耗金额，单位：分。
|
||||
* 示例值：5000
|
||||
*/
|
||||
@SerializedName(value = "max_amount")
|
||||
private Integer maxAmount;
|
||||
|
||||
/**
|
||||
* 单天发放上限金额
|
||||
* <p>
|
||||
* 单天最高消耗金额，单位：分。
|
||||
* 示例值：400
|
||||
*/
|
||||
@SerializedName(value = "max_amount_by_day")
|
||||
private Integer maxAmountByDay;
|
||||
|
||||
/**
|
||||
* 固定面额批次特定信息
|
||||
* <p>
|
||||
* 固定面额发券批次特定信息。
|
||||
*/
|
||||
@SerializedName(value = "fixed_normal_coupon")
|
||||
private FixedNormalCoupon fixedNormalCoupon;
|
||||
|
||||
/**
|
||||
* 单个用户可领个数
|
||||
* <p>
|
||||
* 单个用户可领个数，每个用户最多100张券
|
||||
* 示例值：3
|
||||
*/
|
||||
@SerializedName(value = "max_coupons_per_user")
|
||||
private Integer maxCouponsPerUser;
|
||||
|
||||
/**
|
||||
* 券类型
|
||||
* <p>
|
||||
* 枚举值：
|
||||
* NORMAL：满减券
|
||||
* CUT_TO：减至券
|
||||
* 示例值：NORMAL
|
||||
*/
|
||||
@SerializedName(value = "coupon_type")
|
||||
private String couponType;
|
||||
|
||||
/**
|
||||
* 订单优惠标记
|
||||
* <p>
|
||||
* 订单优惠标记
|
||||
* 特殊规则：单个优惠标记的字符长度为【1，128】,条目个数限制为【1，50】。
|
||||
* 示例值：{'123456','23456'}
|
||||
*/
|
||||
@SerializedName(value = "goods_tag")
|
||||
private List<String> goodsTag;
|
||||
|
||||
/**
|
||||
* 支付方式
|
||||
* <p>
|
||||
* 默认不限制
|
||||
* 枚举值：
|
||||
* MICROAPP：小程序支付
|
||||
* APPPAY：APP支付
|
||||
* PPAY：免密支付
|
||||
* CARD：付款码支付
|
||||
* FACE：人脸支付
|
||||
* OTHER：（公众号、扫码等）
|
||||
* 示例值：MICROAPP
|
||||
*/
|
||||
@SerializedName(value = "trade_type")
|
||||
private List<String> tradeType;
|
||||
|
||||
/**
|
||||
* 是否可叠加其他优惠
|
||||
* <p>
|
||||
* 枚举值：
|
||||
* true：是
|
||||
* false：否
|
||||
* 示例值：true
|
||||
*/
|
||||
@SerializedName(value = "combine_use")
|
||||
private Boolean combineUse;
|
||||
}
|
||||
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
public static class FixedNormalCoupon implements Serializable {
|
||||
/**
|
||||
* 面额
|
||||
* <p>
|
||||
* 面额，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "coupon_amount")
|
||||
private Integer couponAmount;
|
||||
|
||||
/**
|
||||
* 门槛
|
||||
* <p>
|
||||
* 使用券金额门槛，单位：分。
|
||||
* 示例值：100
|
||||
*/
|
||||
@SerializedName(value = "transaction_minimum")
|
||||
private Integer transactionMinimum;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 查询批次可以单品结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksItemsGetResult {
|
||||
|
||||
public static FavorStocksItemsGetResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksItemsGetResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 可用单品编码总数
|
||||
* <p>
|
||||
* 可用单品编码总数。
|
||||
* 示例值: 200
|
||||
*/
|
||||
@SerializedName("total_count")
|
||||
private Integer totalCount;
|
||||
|
||||
/**
|
||||
* 可用单品编码
|
||||
* <p>
|
||||
* 可用单品编码
|
||||
* 特殊规则：单个商品编码的字符长度为【1，128】,条目个数限制为【1，50】。
|
||||
* 示例值:1232001
|
||||
*/
|
||||
@SerializedName("data")
|
||||
private List<String> data;
|
||||
|
||||
/**
|
||||
* 分页大小
|
||||
* <p>
|
||||
* 分页大小，最大10。
|
||||
* 示例值：8
|
||||
*/
|
||||
@SerializedName("limit")
|
||||
private Integer limit;
|
||||
|
||||
/**
|
||||
* 分页页码
|
||||
* <p>
|
||||
* 页码从0开始，默认第0页。
|
||||
* 示例值：1
|
||||
*/
|
||||
@SerializedName("offset")
|
||||
private Integer offset;
|
||||
|
||||
/**
|
||||
* 批次号
|
||||
* <p>
|
||||
* 批次号
|
||||
* 示例值: 9865000
|
||||
*/
|
||||
@SerializedName("stock_id")
|
||||
private String stockId;
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 查询批次可以商户结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksMerchantsGetResult {
|
||||
|
||||
public static FavorStocksMerchantsGetResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksMerchantsGetResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 可用商户总数量
|
||||
* <p>
|
||||
* 可用商户总数量。
|
||||
* 示例值: 200
|
||||
*/
|
||||
@SerializedName("total_count")
|
||||
private Integer totalCount;
|
||||
|
||||
/**
|
||||
* 可用商户列表
|
||||
* <p>
|
||||
* 可用商户列表
|
||||
* 特殊规则：单个商户号的字符长度为【1，20】,条目个数限制为【1，50】。
|
||||
* 示例值:1232001
|
||||
*/
|
||||
@SerializedName("data")
|
||||
private List<String> data;
|
||||
|
||||
/**
|
||||
* 分页大小
|
||||
* <p>
|
||||
* 分页大小，最大10。
|
||||
* 示例值：8
|
||||
*/
|
||||
@SerializedName("limit")
|
||||
private Integer limit;
|
||||
|
||||
/**
|
||||
* 分页页码
|
||||
* <p>
|
||||
* 页码从0开始，默认第0页。
|
||||
* 示例值：1
|
||||
*/
|
||||
@SerializedName("offset")
|
||||
private Integer offset;
|
||||
|
||||
/**
|
||||
* 批次号
|
||||
* <p>
|
||||
* 批次号
|
||||
* 示例值: 9865000
|
||||
*/
|
||||
@SerializedName("stock_id")
|
||||
private String stockId;
|
||||
}
|
||||
@@ -0,0 +1,114 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 条件查询代金券批次列表
|
||||
* <pre>
|
||||
* 文档地址：https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_4.shtml
|
||||
* </pre>
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class FavorStocksQueryRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 1L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：分页页码
|
||||
* 变量名：offset
|
||||
* 是否必填：是
|
||||
* 类型：uint32
|
||||
* 描述：
|
||||
* 页码从0开始，默认第0页。
|
||||
* 示例值：1
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "offset")
|
||||
private Integer offset;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：分页大小
|
||||
* 变量名：limit
|
||||
* 是否必填：是
|
||||
* 类型：uint32
|
||||
* 描述：
|
||||
* 分页大小，最大10。
|
||||
* 示例值：8
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "limit")
|
||||
private Integer limit;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：创建批次的商户号
|
||||
* 变量名：stock_creator_mchid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次创建方商户号。
|
||||
* 示例值：9856888
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_creator_mchid")
|
||||
private String stockCreatorMchid;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：起始时间
|
||||
* 变量名：create_start_time
|
||||
* 是否必填：否
|
||||
* 类型：string[1,64]
|
||||
* 描述：
|
||||
* 起始创建时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "create_start_time")
|
||||
private String createStartTime;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：终止时间
|
||||
* 变量名：create_end_time
|
||||
* 是否必填：否
|
||||
* 类型：string[1,64]
|
||||
* 描述：
|
||||
* 终止创建时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "create_end_time")
|
||||
private String createEndTime;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：批次状态
|
||||
* 变量名：status
|
||||
* 是否必填：否
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次状态，枚举值：
|
||||
* unactivated：未激活
|
||||
* audit：审核中
|
||||
* running：运行中
|
||||
* stoped：已停止
|
||||
* paused：暂停发放
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "status")
|
||||
private String status;
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 条件查询代金券批次列表结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksQueryResult {
|
||||
|
||||
public static FavorStocksQueryResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksQueryResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 批次总数
|
||||
* <p>
|
||||
* 经过条件筛选，查询到的批次总数量。
|
||||
* 示例值：10
|
||||
*/
|
||||
@SerializedName("total_count")
|
||||
private Integer totalCount;
|
||||
|
||||
/**
|
||||
* 批次详情
|
||||
* <p>
|
||||
* 批次详情
|
||||
*/
|
||||
@SerializedName("data")
|
||||
private List<FavorStocksGetResult> data;
|
||||
|
||||
/**
|
||||
* 分页大小
|
||||
* <p>
|
||||
* 分页大小，最大10。
|
||||
* 示例值：8
|
||||
*/
|
||||
@SerializedName("limit")
|
||||
private Integer limit;
|
||||
|
||||
/**
|
||||
* 分页页码
|
||||
* <p>
|
||||
* 页码从0开始，默认第0页。
|
||||
* 示例值：1
|
||||
*/
|
||||
@SerializedName("offset")
|
||||
private Integer offset;
|
||||
}
|
||||
@@ -0,0 +1,45 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 激活代金券批次
|
||||
* 暂停代金券批次
|
||||
* 重启代金券批次
|
||||
* <pre>
|
||||
* 文档地址：
|
||||
* https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_3.shtml
|
||||
* https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_13.shtml
|
||||
* https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/marketing/convention/chapter3_14.shtml
|
||||
* </pre>
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class FavorStocksSetRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 1L;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 字段名：创建批次的商户号
|
||||
* 变量名：stock_creator_mchid
|
||||
* 是否必填：是
|
||||
* 类型：string[1,20]
|
||||
* 描述：
|
||||
* 批次创建方商户号。
|
||||
* 示例值：8956000
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName(value = "stock_creator_mchid")
|
||||
private String stockCreatorMchid;
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
/**
|
||||
* 激活代金券批次返回结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class FavorStocksStartResult {
|
||||
|
||||
public static FavorStocksStartResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, FavorStocksStartResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 生效时间
|
||||
* <p>
|
||||
* 生效时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
|
||||
* 示例值：2015-05-20T13:29:35.120+08:00
|
||||
*/
|
||||
@SerializedName("start_time")
|
||||
private String startTime;
|
||||
|
||||
/**
|
||||
* 批次号
|
||||
* <p>
|
||||
* 微信为每个代金券批次分配的唯一ID。
|
||||
* 示例值：98065001
|
||||
*/
|
||||
@SerializedName("stock_id")
|
||||
private String stockId;
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing.enums;
|
||||
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Getter;
|
||||
|
||||
/**
|
||||
* 券的背景颜色
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Getter
|
||||
@AllArgsConstructor
|
||||
public enum BackgroundColorEnum {
|
||||
|
||||
/**
|
||||
* 颜色 #63B359
|
||||
*/
|
||||
COLOR010("COLOR010", "#63B359"),
|
||||
|
||||
/**
|
||||
* 颜色 #2C9F67
|
||||
*/
|
||||
COLOR020("COLOR020", "#2C9F67"),
|
||||
|
||||
/**
|
||||
* 颜色 #509FC9
|
||||
*/
|
||||
COLOR030("COLOR030", "#509FC9"),
|
||||
|
||||
/**
|
||||
* 颜色 #5885CF
|
||||
*/
|
||||
COLOR040("COLOR040", "#5885CF"),
|
||||
|
||||
/**
|
||||
* 颜色 #9062C0
|
||||
*/
|
||||
COLOR050("COLOR050", "#9062C0"),
|
||||
|
||||
/**
|
||||
* 颜色 #D09A45
|
||||
*/
|
||||
COLOR060("COLOR060", "#D09A45"),
|
||||
|
||||
/**
|
||||
* 颜色 #E4B138
|
||||
*/
|
||||
COLOR070("COLOR070", "#E4B138"),
|
||||
|
||||
/**
|
||||
* 颜色 #EE903C
|
||||
*/
|
||||
COLOR080("COLOR080", "#EE903C"),
|
||||
|
||||
/**
|
||||
* 颜色 #DD6549
|
||||
*/
|
||||
COLOR090("COLOR090", "#DD6549"),
|
||||
|
||||
/**
|
||||
* 颜色 #CC463D
|
||||
*/
|
||||
COLOR100("COLOR100", "#CC463D"),
|
||||
;
|
||||
|
||||
/**
|
||||
* 色值
|
||||
*/
|
||||
private final String value;
|
||||
|
||||
/**
|
||||
* 十六进制颜色码
|
||||
*/
|
||||
private final String code;
|
||||
}
|
||||
@@ -0,0 +1,25 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing.enums;
|
||||
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Getter;
|
||||
|
||||
/**
|
||||
* 批次类型
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Getter
|
||||
@AllArgsConstructor
|
||||
public enum StockTypeEnum {
|
||||
|
||||
/**
|
||||
* NORMAL：固定面额满减券批次
|
||||
*/
|
||||
NORMAL("NORMAL"),
|
||||
;
|
||||
|
||||
/**
|
||||
* 批次类型
|
||||
*/
|
||||
private final String value;
|
||||
}
|
||||
@@ -0,0 +1,45 @@
|
||||
package com.github.binarywang.wxpay.bean.marketing.enums;
|
||||
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Getter;
|
||||
|
||||
/**
|
||||
* 支付方式
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@Getter
|
||||
@AllArgsConstructor
|
||||
public enum TradeTypeEnum {
|
||||
|
||||
/**
|
||||
* MICROAPP：小程序支付
|
||||
*/
|
||||
MICROAPP("MICROAPP"),
|
||||
/**
|
||||
* APPPAY：APP支付
|
||||
*/
|
||||
APPPAY("APPPAY"),
|
||||
/**
|
||||
* PPAY：免密支付
|
||||
*/
|
||||
PPAY("PPAY"),
|
||||
/**
|
||||
* CARD：刷卡支付
|
||||
*/
|
||||
CARD("CARD"),
|
||||
/**
|
||||
* FACE：人脸支付
|
||||
*/
|
||||
FACE("FACE"),
|
||||
/**
|
||||
* OTHER：其他支付
|
||||
*/
|
||||
OTHER("OTHER"),
|
||||
;
|
||||
|
||||
/**
|
||||
* 支付方式
|
||||
*/
|
||||
private final String value;
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
package com.github.binarywang.wxpay.bean.media;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
|
||||
|
||||
/**
|
||||
* 媒体文件上传返回结果对象
|
||||
*
|
||||
* @author thinsstar
|
||||
*/
|
||||
@NoArgsConstructor
|
||||
@Data
|
||||
public class MarketingImageUploadResult {
|
||||
|
||||
public static MarketingImageUploadResult fromJson(String json) {
|
||||
return WxGsonBuilder.create().fromJson(json, MarketingImageUploadResult.class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 媒体文件URL地址
|
||||
* <p>
|
||||
* 微信返回的媒体文件标识url。有效期为永久
|
||||
* 示例值：https://qpic.cn/xxx
|
||||
*/
|
||||
@SerializedName("media_url")
|
||||
private String mediaUrl;
|
||||
}
|
||||
Reference in New Issue
Block a user