修改商品券批次发放预算

1curl -X POST \
2  https://api.mch.weixin.qq.com/brand/marketing/product-coupon/product-coupons/1000000013/stocks/1000000013001/update-budget \
3  -H "Authorization: WECHATPAY-BRAND-SHA256-RSA2048 brand_id=\"XXXX\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: PUB_KEY_ID_XXXX"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "target_max_count" : 200,
9    "update_mode" : "MAX_COUNT",
10    "out_request_no" : "update_budget_34657_20250101_123456",
11    "current_max_count" : 10000000
12  }'
13

1package com.java.demo;
2
3import com.java.utils.WXPayBrandUtility; // 引用微信支付工具库，参考：https://pay.weixin.qq.com/doc/brand/4015826861
4
5import com.google.gson.annotations.SerializedName;
6import com.google.gson.annotations.Expose;
7import okhttp3.MediaType;
8import okhttp3.OkHttpClient;
9import okhttp3.Request;
10import okhttp3.RequestBody;
11import okhttp3.Response;
12
13import java.io.IOException;
14import java.io.UncheckedIOException;
15import java.security.PrivateKey;
16import java.security.PublicKey;
17import java.util.ArrayList;
18import java.util.HashMap;
19import java.util.List;
20import java.util.Map;
21
22/**
23 * 修改商品券批次发放预算
24 */
25public class UpdateStockBudget {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/brand/marketing/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}/update-budget";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/brand/4015415289
32    UpdateStockBudget client = new UpdateStockBudget(
33      "xxxxxxxx",                    // 品牌ID，是由微信支付系统生成并分配给每个品牌方的唯一标识符，品牌ID获取方式参考 https://pay.weixin.qq.com/doc/brand/4015415289
34      "1DDE55AD98Exxxxxxxxxx",         // 品牌API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015407570
35      "/path/to/apiclient_key.pem",     // 品牌API证书私钥文件路径，本地文件路径
36      "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015453439
37      "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
38    );
39
40    UpdateStockBudgetRequest request = new UpdateStockBudgetRequest();
41    request.outRequestNo = "update_budget_34657_20250101_123456";
42    request.productCouponId = "1000000013";
43    request.stockId = "1000000013001";
44    request.updateMode = UpdateBudgetMode.MAX_COUNT;
45    request.currentMaxCount = 10000000L;
46    request.targetMaxCount = 200L;
47    try {
48      StockEntity response = client.run(request);
49        // TODO: 请求成功，继续业务逻辑
50        System.out.println(response);
51    } catch (WXPayBrandUtility.ApiException e) {
52        // TODO: 请求失败，根据状态码执行不同的逻辑
53        e.printStackTrace();
54    }
55  }
56
57  public StockEntity run(UpdateStockBudgetRequest request) {
58    String uri = PATH;
59    uri = uri.replace("{product_coupon_id}", WXPayBrandUtility.urlEncode(request.productCouponId));
60    uri = uri.replace("{stock_id}", WXPayBrandUtility.urlEncode(request.stockId));
61    String reqBody = WXPayBrandUtility.toJson(request);
62
63    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
64    reqBuilder.addHeader("Accept", "application/json");
65    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
66    reqBuilder.addHeader("Authorization", WXPayBrandUtility.buildAuthorization(brand_id, certificateSerialNo,privateKey, METHOD, uri, reqBody));
67    reqBuilder.addHeader("Content-Type", "application/json");
68    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
69    reqBuilder.method(METHOD, requestBody);
70    Request httpRequest = reqBuilder.build();
71
72    // 发送HTTP请求
73    OkHttpClient client = new OkHttpClient.Builder().build();
74    try (Response httpResponse = client.newCall(httpRequest).execute()) {
75      String respBody = WXPayBrandUtility.extractBody(httpResponse);
76      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
77        // 2XX 成功，验证应答签名
78        WXPayBrandUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
79            httpResponse.headers(), respBody);
80
81        // 从HTTP应答报文构建返回数据
82        return WXPayBrandUtility.fromJson(respBody, StockEntity.class);
83      } else {
84        throw new WXPayBrandUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
85      }
86    } catch (IOException e) {
87      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
88    }
89  }
90
91  private final String brand_id;
92  private final String certificateSerialNo;
93  private final PrivateKey privateKey;
94  private final String wechatPayPublicKeyId;
95  private final PublicKey wechatPayPublicKey;
96
97  public UpdateStockBudget(String brand_id, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
98    this.brand_id = brand_id;
99    this.certificateSerialNo = certificateSerialNo;
100    this.privateKey = WXPayBrandUtility.loadPrivateKeyFromPath(privateKeyFilePath);
101    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
102    this.wechatPayPublicKey = WXPayBrandUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
103  }
104
105  public static class UpdateStockBudgetRequest {
106    @SerializedName("out_request_no")
107    public String outRequestNo;
108  
109    @SerializedName("product_coupon_id")
110    @Expose(serialize = false)
111    public String productCouponId;
112  
113    @SerializedName("stock_id")
114    @Expose(serialize = false)
115    public String stockId;
116  
117    @SerializedName("update_mode")
118    public UpdateBudgetMode updateMode;
119  
120    @SerializedName("current_max_count")
121    public Long currentMaxCount;
122  
123    @SerializedName("target_max_count")
124    public Long targetMaxCount;
125  
126    @SerializedName("current_max_count_per_day")
127    public Long currentMaxCountPerDay;
128  
129    @SerializedName("target_max_count_per_day")
130    public Long targetMaxCountPerDay;
131  }
132  
133  public static class StockEntity {
134    @SerializedName("product_coupon_id")
135    public String productCouponId;
136  
137    @SerializedName("stock_id")
138    public String stockId;
139  
140    @SerializedName("remark")
141    public String remark;
142  
143    @SerializedName("coupon_code_mode")
144    public CouponCodeMode couponCodeMode;
145  
146    @SerializedName("coupon_code_count_info")
147    public CouponCodeCountInfo couponCodeCountInfo;
148  
149    @SerializedName("stock_send_rule")
150    public StockSendRule stockSendRule;
151  
152    @SerializedName("single_usage_rule")
153    public SingleUsageRule singleUsageRule;
154  
155    @SerializedName("usage_rule_display_info")
156    public UsageRuleDisplayInfo usageRuleDisplayInfo;
157  
158    @SerializedName("coupon_display_info")
159    public CouponDisplayInfo couponDisplayInfo;
160  
161    @SerializedName("notify_config")
162    public NotifyConfig notifyConfig;
163  
164    @SerializedName("store_scope")
165    public StockStoreScope storeScope;
166  
167    @SerializedName("sent_count_info")
168    public StockSentCountInfo sentCountInfo;
169  
170    @SerializedName("state")
171    public StockState state;
172  
173    @SerializedName("deactivate_request_no")
174    public String deactivateRequestNo;
175  
176    @SerializedName("deactivate_time")
177    public String deactivateTime;
178  
179    @SerializedName("deactivate_reason")
180    public String deactivateReason;
181  }
182  
183  public enum UpdateBudgetMode {
184    @SerializedName("MAX_COUNT")
185    MAX_COUNT,
186    @SerializedName("MAX_COUNT_PER_DAY")
187    MAX_COUNT_PER_DAY
188  }
189  
190  public enum CouponCodeMode {
191    @SerializedName("WECHATPAY")
192    WECHATPAY,
193    @SerializedName("UPLOAD")
194    UPLOAD,
195    @SerializedName("API_ASSIGN")
196    API_ASSIGN
197  }
198  
199  public static class CouponCodeCountInfo {
200    @SerializedName("total_count")
201    public Long totalCount;
202  
203    @SerializedName("available_count")
204    public Long availableCount;
205  }
206  
207  public static class StockSendRule {
208    @SerializedName("max_count")
209    public Long maxCount;
210  
211    @SerializedName("max_count_per_day")
212    public Long maxCountPerDay;
213  
214    @SerializedName("max_count_per_user")
215    public Long maxCountPerUser;
216  }
217  
218  public static class SingleUsageRule {
219    @SerializedName("coupon_available_period")
220    public CouponAvailablePeriod couponAvailablePeriod;
221  
222    @SerializedName("normal_coupon")
223    public NormalCouponUsageRule normalCoupon;
224  
225    @SerializedName("discount_coupon")
226    public DiscountCouponUsageRule discountCoupon;
227  
228    @SerializedName("exchange_coupon")
229    public ExchangeCouponUsageRule exchangeCoupon;
230  }
231  
232  public static class UsageRuleDisplayInfo {
233    @SerializedName("coupon_usage_method_list")
234    public List<CouponUsageMethod> couponUsageMethodList = new ArrayList<CouponUsageMethod>();
235  
236    @SerializedName("mini_program_appid")
237    public String miniProgramAppid;
238  
239    @SerializedName("mini_program_path")
240    public String miniProgramPath;
241  
242    @SerializedName("app_path")
243    public String appPath;
244  
245    @SerializedName("usage_description")
246    public String usageDescription;
247  
248    @SerializedName("coupon_available_store_info")
249    public CouponAvailableStoreInfo couponAvailableStoreInfo;
250  }
251  
252  public static class CouponDisplayInfo {
253    @SerializedName("code_display_mode")
254    public CouponCodeDisplayMode codeDisplayMode;
255  
256    @SerializedName("background_color")
257    public String backgroundColor;
258  
259    @SerializedName("entrance_mini_program")
260    public EntranceMiniProgram entranceMiniProgram;
261  
262    @SerializedName("entrance_official_account")
263    public EntranceOfficialAccount entranceOfficialAccount;
264  
265    @SerializedName("entrance_finder")
266    public EntranceFinder entranceFinder;
267  }
268  
269  public static class NotifyConfig {
270    @SerializedName("notify_appid")
271    public String notifyAppid;
272  }
273  
274  public enum StockStoreScope {
275    @SerializedName("NONE")
276    NONE,
277    @SerializedName("ALL")
278    ALL,
279    @SerializedName("SPECIFIC")
280    SPECIFIC
281  }
282  
283  public static class StockSentCountInfo {
284    @SerializedName("total_count")
285    public Long totalCount;
286  
287    @SerializedName("today_count")
288    public Long todayCount;
289  }
290  
291  public enum StockState {
292    @SerializedName("AUDITING")
293    AUDITING,
294    @SerializedName("SENDING")
295    SENDING,
296    @SerializedName("PAUSED")
297    PAUSED,
298    @SerializedName("STOPPED")
299    STOPPED,
300    @SerializedName("DEACTIVATED")
301    DEACTIVATED
302  }
303  
304  public static class CouponAvailablePeriod {
305    @SerializedName("available_begin_time")
306    public String availableBeginTime;
307  
308    @SerializedName("available_end_time")
309    public String availableEndTime;
310  
311    @SerializedName("available_days")
312    public Long availableDays;
313  
314    @SerializedName("wait_days_after_receive")
315    public Long waitDaysAfterReceive;
316  
317    @SerializedName("weekly_available_period")
318    public FixedWeekPeriod weeklyAvailablePeriod;
319  
320    @SerializedName("irregular_available_period_list")
321    public List<TimePeriod> irregularAvailablePeriodList;
322  }
323  
324  public static class NormalCouponUsageRule {
325    @SerializedName("threshold")
326    public Long threshold;
327  
328    @SerializedName("discount_amount")
329    public Long discountAmount;
330  }
331  
332  public static class DiscountCouponUsageRule {
333    @SerializedName("threshold")
334    public Long threshold;
335  
336    @SerializedName("percent_off")
337    public Long percentOff;
338  }
339  
340  public static class ExchangeCouponUsageRule {
341    @SerializedName("threshold")
342    public Long threshold;
343  
344    @SerializedName("exchange_price")
345    public Long exchangePrice;
346  }
347  
348  public enum CouponUsageMethod {
349    @SerializedName("OFFLINE")
350    OFFLINE,
351    @SerializedName("MINI_PROGRAM")
352    MINI_PROGRAM,
353    @SerializedName("APP")
354    APP,
355    @SerializedName("PAYMENT_CODE")
356    PAYMENT_CODE
357  }
358  
359  public static class CouponAvailableStoreInfo {
360    @SerializedName("description")
361    public String description;
362  
363    @SerializedName("mini_program_appid")
364    public String miniProgramAppid;
365  
366    @SerializedName("mini_program_path")
367    public String miniProgramPath;
368  }
369  
370  public enum CouponCodeDisplayMode {
371    @SerializedName("INVISIBLE")
372    INVISIBLE,
373    @SerializedName("BARCODE")
374    BARCODE,
375    @SerializedName("QRCODE")
376    QRCODE
377  }
378  
379  public static class EntranceMiniProgram {
380    @SerializedName("appid")
381    public String appid;
382  
383    @SerializedName("path")
384    public String path;
385  
386    @SerializedName("entrance_wording")
387    public String entranceWording;
388  
389    @SerializedName("guidance_wording")
390    public String guidanceWording;
391  }
392  
393  public static class EntranceOfficialAccount {
394    @SerializedName("appid")
395    public String appid;
396  }
397  
398  public static class EntranceFinder {
399    @SerializedName("finder_id")
400    public String finderId;
401  
402    @SerializedName("finder_video_id")
403    public String finderVideoId;
404  
405    @SerializedName("finder_video_cover_image_url")
406    public String finderVideoCoverImageUrl;
407  }
408  
409  public static class FixedWeekPeriod {
410    @SerializedName("day_list")
411    public List<WeekEnum> dayList;
412  
413    @SerializedName("day_period_list")
414    public List<PeriodOfTheDay> dayPeriodList;
415  }
416  
417  public static class TimePeriod {
418    @SerializedName("begin_time")
419    public String beginTime;
420  
421    @SerializedName("end_time")
422    public String endTime;
423  }
424  
425  public enum WeekEnum {
426    @SerializedName("MONDAY")
427    MONDAY,
428    @SerializedName("TUESDAY")
429    TUESDAY,
430    @SerializedName("WEDNESDAY")
431    WEDNESDAY,
432    @SerializedName("THURSDAY")
433    THURSDAY,
434    @SerializedName("FRIDAY")
435    FRIDAY,
436    @SerializedName("SATURDAY")
437    SATURDAY,
438    @SerializedName("SUNDAY")
439    SUNDAY
440  }
441  
442  public static class PeriodOfTheDay {
443    @SerializedName("begin_time")
444    public Long beginTime;
445  
446    @SerializedName("end_time")
447    public Long endTime;
448  }
449  
450}
451

1package main
2
3import (
4	"bytes"
5	"demo/wxpay_brand_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/brand/4015826866
6	"encoding/json"
7	"fmt"
8	"net/http"
9	"net/url"
10	"strings"
11	"time"
12)
13
14func main() {
15	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/brand/4015415289
16	config, err := wxpay_brand_utility.CreateBrandConfig(
17		"xxxxxxxx",                   // 品牌ID，是由微信支付系统生成并分配给每个品牌方的唯一标识符，品牌ID获取方式参考 https://pay.weixin.qq.com/doc/brand/4015415289
18		"1DDE55AD98Exxxxxxxxxx",      // 品牌API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015407570
19		"/path/to/apiclient_key.pem", // 品牌API证书私钥文件路径，本地文件路径
20		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015453439
21		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
22	)
23	if err != nil {
24		fmt.Println(err)
25		return
26	}
27
28	request := &UpdateStockBudgetRequest{
29		OutRequestNo:    wxpay_brand_utility.String("update_budget_34657_20250101_123456"),
30		ProductCouponId: wxpay_brand_utility.String("1000000013"),
31		StockId:         wxpay_brand_utility.String("1000000013001"),
32		UpdateMode:      UPDATEBUDGETMODE_MAX_COUNT.Ptr(),
33		CurrentMaxCount: wxpay_brand_utility.Int64(10000000),
34		TargetMaxCount:  wxpay_brand_utility.Int64(200),
35	}
36
37	response, err := UpdateStockBudget(config, request)
38	if err != nil {
39		fmt.Printf("请求失败: %+v\n", err)
40		// TODO: 请求失败，根据状态码执行不同的处理
41		return
42	}
43
44	// TODO: 请求成功，继续业务逻辑
45	fmt.Printf("请求成功: %+v\n", response)
46}
47
48func UpdateStockBudget(config *wxpay_brand_utility.BrandConfig, request *UpdateStockBudgetRequest) (response *StockEntity, err error) {
49	const (
50		host   = "https://api.mch.weixin.qq.com"
51		method = "POST"
52		path   = "/brand/marketing/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}/update-budget"
53	)
54
55	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
56	if err != nil {
57		return nil, err
58	}
59	reqUrl.Path = strings.Replace(reqUrl.Path, "{product_coupon_id}", url.PathEscape(*request.ProductCouponId), -1)
60	reqUrl.Path = strings.Replace(reqUrl.Path, "{stock_id}", url.PathEscape(*request.StockId), -1)
61	reqBody, err := json.Marshal(request)
62	if err != nil {
63		return nil, err
64	}
65	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
66	if err != nil {
67		return nil, err
68	}
69	httpRequest.Header.Set("Accept", "application/json")
70	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
71	httpRequest.Header.Set("Content-Type", "application/json")
72	authorization, err := wxpay_brand_utility.BuildAuthorization(config.BrandId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
73	if err != nil {
74		return nil, err
75	}
76	httpRequest.Header.Set("Authorization", authorization)
77
78	client := &http.Client{}
79	httpResponse, err := client.Do(httpRequest)
80	if err != nil {
81		return nil, err
82	}
83	respBody, err := wxpay_brand_utility.ExtractResponseBody(httpResponse)
84	if err != nil {
85		return nil, err
86	}
87	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
88		// 2XX 成功，验证应答签名
89		err = wxpay_brand_utility.ValidateResponse(
90			config.WechatPayPublicKeyId(),
91			config.WechatPayPublicKey(),
92			&httpResponse.Header,
93			respBody,
94		)
95		if err != nil {
96			return nil, err
97		}
98		response := &StockEntity{}
99		if err := json.Unmarshal(respBody, response); err != nil {
100			return nil, err
101		}
102
103		return response, nil
104	} else {
105		return nil, wxpay_brand_utility.NewApiException(
106			httpResponse.StatusCode,
107			httpResponse.Header,
108			respBody,
109		)
110	}
111}
112
113type UpdateStockBudgetRequest struct {
114	OutRequestNo          *string           `json:"out_request_no,omitempty"`
115	ProductCouponId       *string           `json:"product_coupon_id,omitempty"`
116	StockId               *string           `json:"stock_id,omitempty"`
117	UpdateMode            *UpdateBudgetMode `json:"update_mode,omitempty"`
118	CurrentMaxCount       *int64            `json:"current_max_count,omitempty"`
119	TargetMaxCount        *int64            `json:"target_max_count,omitempty"`
120	CurrentMaxCountPerDay *int64            `json:"current_max_count_per_day,omitempty"`
121	TargetMaxCountPerDay  *int64            `json:"target_max_count_per_day,omitempty"`
122}
123
124func (o *UpdateStockBudgetRequest) MarshalJSON() ([]byte, error) {
125	type Alias UpdateStockBudgetRequest
126	a := &struct {
127		ProductCouponId *string `json:"product_coupon_id,omitempty"`
128		StockId         *string `json:"stock_id,omitempty"`
129		*Alias
130	}{
131		// 序列化时移除非 Body 字段
132		ProductCouponId: nil,
133		StockId:         nil,
134		Alias:           (*Alias)(o),
135	}
136	return json.Marshal(a)
137}
138
139type StockEntity struct {
140	ProductCouponId      *string               `json:"product_coupon_id,omitempty"`
141	StockId              *string               `json:"stock_id,omitempty"`
142	Remark               *string               `json:"remark,omitempty"`
143	CouponCodeMode       *CouponCodeMode       `json:"coupon_code_mode,omitempty"`
144	CouponCodeCountInfo  *CouponCodeCountInfo  `json:"coupon_code_count_info,omitempty"`
145	StockSendRule        *StockSendRule        `json:"stock_send_rule,omitempty"`
146	SingleUsageRule      *SingleUsageRule      `json:"single_usage_rule,omitempty"`
147	UsageRuleDisplayInfo *UsageRuleDisplayInfo `json:"usage_rule_display_info,omitempty"`
148	CouponDisplayInfo    *CouponDisplayInfo    `json:"coupon_display_info,omitempty"`
149	NotifyConfig         *NotifyConfig         `json:"notify_config,omitempty"`
150	StoreScope           *StockStoreScope      `json:"store_scope,omitempty"`
151	SentCountInfo        *StockSentCountInfo   `json:"sent_count_info,omitempty"`
152	State                *StockState           `json:"state,omitempty"`
153	DeactivateRequestNo  *string               `json:"deactivate_request_no,omitempty"`
154	DeactivateTime       *time.Time            `json:"deactivate_time,omitempty"`
155	DeactivateReason     *string               `json:"deactivate_reason,omitempty"`
156}
157
158type UpdateBudgetMode string
159
160func (e UpdateBudgetMode) Ptr() *UpdateBudgetMode {
161	return &e
162}
163
164const (
165	UPDATEBUDGETMODE_MAX_COUNT         UpdateBudgetMode = "MAX_COUNT"
166	UPDATEBUDGETMODE_MAX_COUNT_PER_DAY UpdateBudgetMode = "MAX_COUNT_PER_DAY"
167)
168
169type CouponCodeMode string
170
171func (e CouponCodeMode) Ptr() *CouponCodeMode {
172	return &e
173}
174
175const (
176	COUPONCODEMODE_WECHATPAY  CouponCodeMode = "WECHATPAY"
177	COUPONCODEMODE_UPLOAD     CouponCodeMode = "UPLOAD"
178	COUPONCODEMODE_API_ASSIGN CouponCodeMode = "API_ASSIGN"
179)
180
181type CouponCodeCountInfo struct {
182	TotalCount     *int64 `json:"total_count,omitempty"`
183	AvailableCount *int64 `json:"available_count,omitempty"`
184}
185
186type StockSendRule struct {
187	MaxCount        *int64 `json:"max_count,omitempty"`
188	MaxCountPerDay  *int64 `json:"max_count_per_day,omitempty"`
189	MaxCountPerUser *int64 `json:"max_count_per_user,omitempty"`
190}
191
192type SingleUsageRule struct {
193	CouponAvailablePeriod *CouponAvailablePeriod   `json:"coupon_available_period,omitempty"`
194	NormalCoupon          *NormalCouponUsageRule   `json:"normal_coupon,omitempty"`
195	DiscountCoupon        *DiscountCouponUsageRule `json:"discount_coupon,omitempty"`
196	ExchangeCoupon        *ExchangeCouponUsageRule `json:"exchange_coupon,omitempty"`
197}
198
199type UsageRuleDisplayInfo struct {
200	CouponUsageMethodList    []CouponUsageMethod       `json:"coupon_usage_method_list,omitempty"`
201	MiniProgramAppid         *string                   `json:"mini_program_appid,omitempty"`
202	MiniProgramPath          *string                   `json:"mini_program_path,omitempty"`
203	AppPath                  *string                   `json:"app_path,omitempty"`
204	UsageDescription         *string                   `json:"usage_description,omitempty"`
205	CouponAvailableStoreInfo *CouponAvailableStoreInfo `json:"coupon_available_store_info,omitempty"`
206}
207
208type CouponDisplayInfo struct {
209	CodeDisplayMode         *CouponCodeDisplayMode   `json:"code_display_mode,omitempty"`
210	BackgroundColor         *string                  `json:"background_color,omitempty"`
211	EntranceMiniProgram     *EntranceMiniProgram     `json:"entrance_mini_program,omitempty"`
212	EntranceOfficialAccount *EntranceOfficialAccount `json:"entrance_official_account,omitempty"`
213	EntranceFinder          *EntranceFinder          `json:"entrance_finder,omitempty"`
214}
215
216type NotifyConfig struct {
217	NotifyAppid *string `json:"notify_appid,omitempty"`
218}
219
220type StockStoreScope string
221
222func (e StockStoreScope) Ptr() *StockStoreScope {
223	return &e
224}
225
226const (
227	STOCKSTORESCOPE_NONE     StockStoreScope = "NONE"
228	STOCKSTORESCOPE_ALL      StockStoreScope = "ALL"
229	STOCKSTORESCOPE_SPECIFIC StockStoreScope = "SPECIFIC"
230)
231
232type StockSentCountInfo struct {
233	TotalCount *int64 `json:"total_count,omitempty"`
234	TodayCount *int64 `json:"today_count,omitempty"`
235}
236
237type StockState string
238
239func (e StockState) Ptr() *StockState {
240	return &e
241}
242
243const (
244	STOCKSTATE_AUDITING    StockState = "AUDITING"
245	STOCKSTATE_SENDING     StockState = "SENDING"
246	STOCKSTATE_PAUSED      StockState = "PAUSED"
247	STOCKSTATE_STOPPED     StockState = "STOPPED"
248	STOCKSTATE_DEACTIVATED StockState = "DEACTIVATED"
249)
250
251type CouponAvailablePeriod struct {
252	AvailableBeginTime           *string          `json:"available_begin_time,omitempty"`
253	AvailableEndTime             *string          `json:"available_end_time,omitempty"`
254	AvailableDays                *int64           `json:"available_days,omitempty"`
255	WaitDaysAfterReceive         *int64           `json:"wait_days_after_receive,omitempty"`
256	WeeklyAvailablePeriod        *FixedWeekPeriod `json:"weekly_available_period,omitempty"`
257	IrregularAvailablePeriodList []TimePeriod     `json:"irregular_available_period_list,omitempty"`
258}
259
260type NormalCouponUsageRule struct {
261	Threshold      *int64 `json:"threshold,omitempty"`
262	DiscountAmount *int64 `json:"discount_amount,omitempty"`
263}
264
265type DiscountCouponUsageRule struct {
266	Threshold  *int64 `json:"threshold,omitempty"`
267	PercentOff *int64 `json:"percent_off,omitempty"`
268}
269
270type ExchangeCouponUsageRule struct {
271	Threshold     *int64 `json:"threshold,omitempty"`
272	ExchangePrice *int64 `json:"exchange_price,omitempty"`
273}
274
275type CouponUsageMethod string
276
277func (e CouponUsageMethod) Ptr() *CouponUsageMethod {
278	return &e
279}
280
281const (
282	COUPONUSAGEMETHOD_OFFLINE      CouponUsageMethod = "OFFLINE"
283	COUPONUSAGEMETHOD_MINI_PROGRAM CouponUsageMethod = "MINI_PROGRAM"
284	COUPONUSAGEMETHOD_APP          CouponUsageMethod = "APP"
285	COUPONUSAGEMETHOD_PAYMENT_CODE CouponUsageMethod = "PAYMENT_CODE"
286)
287
288type CouponAvailableStoreInfo struct {
289	Description      *string `json:"description,omitempty"`
290	MiniProgramAppid *string `json:"mini_program_appid,omitempty"`
291	MiniProgramPath  *string `json:"mini_program_path,omitempty"`
292}
293
294type CouponCodeDisplayMode string
295
296func (e CouponCodeDisplayMode) Ptr() *CouponCodeDisplayMode {
297	return &e
298}
299
300const (
301	COUPONCODEDISPLAYMODE_INVISIBLE CouponCodeDisplayMode = "INVISIBLE"
302	COUPONCODEDISPLAYMODE_BARCODE   CouponCodeDisplayMode = "BARCODE"
303	COUPONCODEDISPLAYMODE_QRCODE    CouponCodeDisplayMode = "QRCODE"
304)
305
306type EntranceMiniProgram struct {
307	Appid           *string `json:"appid,omitempty"`
308	Path            *string `json:"path,omitempty"`
309	EntranceWording *string `json:"entrance_wording,omitempty"`
310	GuidanceWording *string `json:"guidance_wording,omitempty"`
311}
312
313type EntranceOfficialAccount struct {
314	Appid *string `json:"appid,omitempty"`
315}
316
317type EntranceFinder struct {
318	FinderId                 *string `json:"finder_id,omitempty"`
319	FinderVideoId            *string `json:"finder_video_id,omitempty"`
320	FinderVideoCoverImageUrl *string `json:"finder_video_cover_image_url,omitempty"`
321}
322
323type FixedWeekPeriod struct {
324	DayList       []WeekEnum       `json:"day_list,omitempty"`
325	DayPeriodList []PeriodOfTheDay `json:"day_period_list,omitempty"`
326}
327
328type TimePeriod struct {
329	BeginTime *string `json:"begin_time,omitempty"`
330	EndTime   *string `json:"end_time,omitempty"`
331}
332
333type WeekEnum string
334
335func (e WeekEnum) Ptr() *WeekEnum {
336	return &e
337}
338
339const (
340	WEEKENUM_MONDAY    WeekEnum = "MONDAY"
341	WEEKENUM_TUESDAY   WeekEnum = "TUESDAY"
342	WEEKENUM_WEDNESDAY WeekEnum = "WEDNESDAY"
343	WEEKENUM_THURSDAY  WeekEnum = "THURSDAY"
344	WEEKENUM_FRIDAY    WeekEnum = "FRIDAY"
345	WEEKENUM_SATURDAY  WeekEnum = "SATURDAY"
346	WEEKENUM_SUNDAY    WeekEnum = "SUNDAY"
347)
348
349type PeriodOfTheDay struct {
350	BeginTime *int64 `json:"begin_time,omitempty"`
351	EndTime   *int64 `json:"end_time,omitempty"`
352}
353