修改商品券批次

1curl -X PATCH \
2  https://api.mch.weixin.qq.com/brand/marketing/product-coupon/product-coupons/200000001/stocks/123456789 \
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    "out_request_no" : "34657_20250101_123456",
9    "remark" : "疯狂星期四项目专用",
10    "usage_rule_display_info" : {
11      "coupon_usage_method_list" : [
12        "MINI_PROGRAM"
13      ],
14      "mini_program_appid" : "wx1234567890",
15      "mini_program_path" : "/pages/index/product",
16      "app_path" : "https://www.example.com/jump-to-app",
17      "usage_description" : "全场可用",
18      "coupon_available_store_info" : {
19        "description" : "可在上海市区的所有门店使用，详细列表参考小程序内信息为准",
20        "mini_program_appid" : "wx1234567890",
21        "mini_program_path" : "/pages/index/store-list"
22      }
23    },
24    "coupon_display_info" : {
25      "code_display_mode" : "QRCODE",
26      "background_color" : "Color010",
27      "entrance_mini_program" : {
28        "appid" : "wx1234567890",
29        "path" : "/pages/index/product",
30        "entrance_wording" : "欢迎选购",
31        "guidance_wording" : "获取更多优惠"
32      },
33      "entrance_official_account" : {
34        "appid" : "wx1234567890"
35      },
36      "entrance_finder" : {
37        "finder_id" : "gh_12345678",
38        "finder_video_id" : "UDFsdf24df34dD456Hdf34",
39        "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
40      }
41    },
42    "notify_config" : {
43      "notify_appid" : "wx4fd12345678"
44    },
45    "store_scope" : "SPECIFIC"
46  }'
47

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 UpdateStock {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "PATCH";
28  private static String PATH = "/brand/marketing/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/brand/4015415289
32    UpdateStock client = new UpdateStock(
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    UpdateStockRequest request = new UpdateStockRequest();
41    request.productCouponId = "200000001";
42    request.stockId = "123456789";
43    request.outRequestNo = "34657_20250101_123456";
44    request.remark = "疯狂星期四项目专用";
45    request.usageRuleDisplayInfo = new UsageRuleDisplayInfo();
46    request.usageRuleDisplayInfo.couponUsageMethodList = new ArrayList<>();
47    {
48      request.usageRuleDisplayInfo.couponUsageMethodList.add(CouponUsageMethod.OFFLINE);
49    };
50    request.usageRuleDisplayInfo.miniProgramAppid = "wx1234567890";
51    request.usageRuleDisplayInfo.miniProgramPath = "/pages/index/product";
52    request.usageRuleDisplayInfo.appPath = "https://www.example.com/jump-to-app";
53    request.usageRuleDisplayInfo.usageDescription = "全场可用";
54    request.usageRuleDisplayInfo.couponAvailableStoreInfo = new CouponAvailableStoreInfo();
55    request.usageRuleDisplayInfo.couponAvailableStoreInfo.description = "可在上海市区的所有门店使用，详细列表参考小程序内信息为准";
56    request.usageRuleDisplayInfo.couponAvailableStoreInfo.miniProgramAppid = "wx1234567890";
57    request.usageRuleDisplayInfo.couponAvailableStoreInfo.miniProgramPath = "/pages/index/store-list";
58    request.couponDisplayInfo = new CouponDisplayInfo();
59    request.couponDisplayInfo.codeDisplayMode = CouponCodeDisplayMode.QRCODE;
60    request.couponDisplayInfo.backgroundColor = "Color010";
61    request.couponDisplayInfo.entranceMiniProgram = new EntranceMiniProgram();
62    request.couponDisplayInfo.entranceMiniProgram.appid = "wx1234567890";
63    request.couponDisplayInfo.entranceMiniProgram.path = "/pages/index/product";
64    request.couponDisplayInfo.entranceMiniProgram.entranceWording = "欢迎选购";
65    request.couponDisplayInfo.entranceMiniProgram.guidanceWording = "获取更多优惠";
66    request.couponDisplayInfo.entranceOfficialAccount = new EntranceOfficialAccount();
67    request.couponDisplayInfo.entranceOfficialAccount.appid = "wx1234567890";
68    request.couponDisplayInfo.entranceFinder = new EntranceFinder();
69    request.couponDisplayInfo.entranceFinder.finderId = "gh_12345678";
70    request.couponDisplayInfo.entranceFinder.finderVideoId = "UDFsdf24df34dD456Hdf34";
71    request.couponDisplayInfo.entranceFinder.finderVideoCoverImageUrl = "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx";
72    request.notifyConfig = new NotifyConfig();
73    request.notifyConfig.notifyAppid = "wx4fd12345678";
74    request.storeScope = StockStoreScope.SPECIFIC;
75    try {
76      StockEntity response = client.run(request);
77        // TODO: 请求成功，继续业务逻辑
78        System.out.println(response);
79    } catch (WXPayBrandUtility.ApiException e) {
80        // TODO: 请求失败，根据状态码执行不同的逻辑
81        e.printStackTrace();
82    }
83  }
84
85  public StockEntity run(UpdateStockRequest request) {
86    String uri = PATH;
87    uri = uri.replace("{product_coupon_id}", WXPayBrandUtility.urlEncode(request.productCouponId));
88    uri = uri.replace("{stock_id}", WXPayBrandUtility.urlEncode(request.stockId));
89    String reqBody = WXPayBrandUtility.toJson(request);
90
91    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
92    reqBuilder.addHeader("Accept", "application/json");
93    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
94    reqBuilder.addHeader("Authorization", WXPayBrandUtility.buildAuthorization(brand_id, certificateSerialNo,privateKey, METHOD, uri, reqBody));
95    reqBuilder.addHeader("Content-Type", "application/json");
96    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
97    reqBuilder.method(METHOD, requestBody);
98    Request httpRequest = reqBuilder.build();
99
100    // 发送HTTP请求
101    OkHttpClient client = new OkHttpClient.Builder().build();
102    try (Response httpResponse = client.newCall(httpRequest).execute()) {
103      String respBody = WXPayBrandUtility.extractBody(httpResponse);
104      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
105        // 2XX 成功，验证应答签名
106        WXPayBrandUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
107            httpResponse.headers(), respBody);
108
109        // 从HTTP应答报文构建返回数据
110        return WXPayBrandUtility.fromJson(respBody, StockEntity.class);
111      } else {
112        throw new WXPayBrandUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
113      }
114    } catch (IOException e) {
115      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
116    }
117  }
118
119  private final String brand_id;
120  private final String certificateSerialNo;
121  private final PrivateKey privateKey;
122  private final String wechatPayPublicKeyId;
123  private final PublicKey wechatPayPublicKey;
124
125  public UpdateStock(String brand_id, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
126    this.brand_id = brand_id;
127    this.certificateSerialNo = certificateSerialNo;
128    this.privateKey = WXPayBrandUtility.loadPrivateKeyFromPath(privateKeyFilePath);
129    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
130    this.wechatPayPublicKey = WXPayBrandUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
131  }
132
133  public static class UpdateStockRequest {
134    @SerializedName("out_request_no")
135    public String outRequestNo;
136  
137    @SerializedName("product_coupon_id")
138    @Expose(serialize = false)
139    public String productCouponId;
140  
141    @SerializedName("stock_id")
142    @Expose(serialize = false)
143    public String stockId;
144  
145    @SerializedName("remark")
146    public String remark;
147  
148    @SerializedName("usage_rule_display_info")
149    public UsageRuleDisplayInfo usageRuleDisplayInfo;
150  
151    @SerializedName("coupon_display_info")
152    public CouponDisplayInfo couponDisplayInfo;
153  
154    @SerializedName("notify_config")
155    public NotifyConfig notifyConfig;
156  
157    @SerializedName("store_scope")
158    public StockStoreScope storeScope;
159  }
160  
161  public static class StockEntity {
162    @SerializedName("product_coupon_id")
163    public String productCouponId;
164  
165    @SerializedName("stock_id")
166    public String stockId;
167  
168    @SerializedName("remark")
169    public String remark;
170  
171    @SerializedName("coupon_code_mode")
172    public CouponCodeMode couponCodeMode;
173  
174    @SerializedName("coupon_code_count_info")
175    public CouponCodeCountInfo couponCodeCountInfo;
176  
177    @SerializedName("stock_send_rule")
178    public StockSendRule stockSendRule;
179  
180    @SerializedName("single_usage_rule")
181    public SingleUsageRule singleUsageRule;
182  
183    @SerializedName("sequential_usage_rule")
184    public SequentialUsageRule sequentialUsageRule;
185  
186    @SerializedName("usage_rule_display_info")
187    public UsageRuleDisplayInfo usageRuleDisplayInfo;
188  
189    @SerializedName("coupon_display_info")
190    public CouponDisplayInfo couponDisplayInfo;
191  
192    @SerializedName("notify_config")
193    public NotifyConfig notifyConfig;
194  
195    @SerializedName("store_scope")
196    public StockStoreScope storeScope;
197  
198    @SerializedName("sent_count_info")
199    public StockSentCountInfo sentCountInfo;
200  
201    @SerializedName("state")
202    public StockState state;
203  
204    @SerializedName("deactivate_request_no")
205    public String deactivateRequestNo;
206  
207    @SerializedName("deactivate_time")
208    public String deactivateTime;
209  
210    @SerializedName("deactivate_reason")
211    public String deactivateReason;
212  }
213  
214  public static class UsageRuleDisplayInfo {
215    @SerializedName("coupon_usage_method_list")
216    public List<CouponUsageMethod> couponUsageMethodList = new ArrayList<CouponUsageMethod>();
217  
218    @SerializedName("mini_program_appid")
219    public String miniProgramAppid;
220  
221    @SerializedName("mini_program_path")
222    public String miniProgramPath;
223  
224    @SerializedName("app_path")
225    public String appPath;
226  
227    @SerializedName("usage_description")
228    public String usageDescription;
229  
230    @SerializedName("coupon_available_store_info")
231    public CouponAvailableStoreInfo couponAvailableStoreInfo;
232  }
233  
234  public static class CouponDisplayInfo {
235    @SerializedName("code_display_mode")
236    public CouponCodeDisplayMode codeDisplayMode;
237  
238    @SerializedName("background_color")
239    public String backgroundColor;
240  
241    @SerializedName("entrance_mini_program")
242    public EntranceMiniProgram entranceMiniProgram;
243  
244    @SerializedName("entrance_official_account")
245    public EntranceOfficialAccount entranceOfficialAccount;
246  
247    @SerializedName("entrance_finder")
248    public EntranceFinder entranceFinder;
249  }
250  
251  public static class NotifyConfig {
252    @SerializedName("notify_appid")
253    public String notifyAppid;
254  }
255  
256  public enum StockStoreScope {
257    @SerializedName("NONE")
258    NONE,
259    @SerializedName("ALL")
260    ALL,
261    @SerializedName("SPECIFIC")
262    SPECIFIC
263  }
264  
265  public enum CouponCodeMode {
266    @SerializedName("WECHATPAY")
267    WECHATPAY,
268    @SerializedName("UPLOAD")
269    UPLOAD,
270    @SerializedName("API_ASSIGN")
271    API_ASSIGN
272  }
273  
274  public static class CouponCodeCountInfo {
275    @SerializedName("total_count")
276    public Long totalCount;
277  
278    @SerializedName("available_count")
279    public Long availableCount;
280  }
281  
282  public static class StockSendRule {
283    @SerializedName("max_count")
284    public Long maxCount;
285  
286    @SerializedName("max_count_per_day")
287    public Long maxCountPerDay;
288  
289    @SerializedName("max_count_per_user")
290    public Long maxCountPerUser;
291  }
292  
293  public static class SingleUsageRule {
294    @SerializedName("coupon_available_period")
295    public SingleCouponAvailablePeriod couponAvailablePeriod;
296  
297    @SerializedName("normal_coupon")
298    public NormalCouponUsageRule normalCoupon;
299  
300    @SerializedName("discount_coupon")
301    public DiscountCouponUsageRule discountCoupon;
302  
303    @SerializedName("exchange_coupon")
304    public ExchangeCouponUsageRule exchangeCoupon;
305  }
306  
307  public static class SequentialUsageRule {
308    @SerializedName("coupon_available_period")
309    public SequentialCouponAvailablePeriod couponAvailablePeriod;
310  
311    @SerializedName("normal_coupon_list")
312    public List<NormalCouponUsageRule> normalCouponList;
313  
314    @SerializedName("discount_coupon_list")
315    public List<DiscountCouponUsageRule> discountCouponList;
316  
317    @SerializedName("exchange_coupon_list")
318    public List<ExchangeCouponUsageRule> exchangeCouponList;
319  
320    @SerializedName("special_first")
321    public Boolean specialFirst;
322  }
323  
324  public static class StockSentCountInfo {
325    @SerializedName("total_count")
326    public Long totalCount;
327  
328    @SerializedName("today_count")
329    public Long todayCount;
330  }
331  
332  public enum StockState {
333    @SerializedName("AUDITING")
334    AUDITING,
335    @SerializedName("SENDING")
336    SENDING,
337    @SerializedName("PAUSED")
338    PAUSED,
339    @SerializedName("STOPPED")
340    STOPPED,
341    @SerializedName("DEACTIVATED")
342    DEACTIVATED
343  }
344  
345  public enum CouponUsageMethod {
346    @SerializedName("OFFLINE")
347    OFFLINE,
348    @SerializedName("MINI_PROGRAM")
349    MINI_PROGRAM,
350    @SerializedName("APP")
351    APP,
352    @SerializedName("PAYMENT_CODE")
353    PAYMENT_CODE
354  }
355  
356  public static class CouponAvailableStoreInfo {
357    @SerializedName("description")
358    public String description;
359  
360    @SerializedName("mini_program_appid")
361    public String miniProgramAppid;
362  
363    @SerializedName("mini_program_path")
364    public String miniProgramPath;
365  }
366  
367  public enum CouponCodeDisplayMode {
368    @SerializedName("INVISIBLE")
369    INVISIBLE,
370    @SerializedName("BARCODE")
371    BARCODE,
372    @SerializedName("QRCODE")
373    QRCODE
374  }
375  
376  public static class EntranceMiniProgram {
377    @SerializedName("appid")
378    public String appid;
379  
380    @SerializedName("path")
381    public String path;
382  
383    @SerializedName("entrance_wording")
384    public String entranceWording;
385  
386    @SerializedName("guidance_wording")
387    public String guidanceWording;
388  }
389  
390  public static class EntranceOfficialAccount {
391    @SerializedName("appid")
392    public String appid;
393  }
394  
395  public static class EntranceFinder {
396    @SerializedName("finder_id")
397    public String finderId;
398  
399    @SerializedName("finder_video_id")
400    public String finderVideoId;
401  
402    @SerializedName("finder_video_cover_image_url")
403    public String finderVideoCoverImageUrl;
404  }
405  
406  public static class SingleCouponAvailablePeriod {
407    @SerializedName("available_begin_time")
408    public String availableBeginTime;
409  
410    @SerializedName("available_end_time")
411    public String availableEndTime;
412  
413    @SerializedName("available_days")
414    public Long availableDays;
415  
416    @SerializedName("wait_days_after_receive")
417    public Long waitDaysAfterReceive;
418  
419    @SerializedName("weekly_available_period")
420    public FixedWeekPeriod weeklyAvailablePeriod;
421  
422    @SerializedName("irregular_available_period_list")
423    public List<TimePeriod> irregularAvailablePeriodList;
424  }
425  
426  public static class NormalCouponUsageRule {
427    @SerializedName("threshold")
428    public Long threshold;
429  
430    @SerializedName("discount_amount")
431    public Long discountAmount;
432  }
433  
434  public static class DiscountCouponUsageRule {
435    @SerializedName("threshold")
436    public Long threshold;
437  
438    @SerializedName("percent_off")
439    public Long percentOff;
440  }
441  
442  public static class ExchangeCouponUsageRule {
443    @SerializedName("threshold")
444    public Long threshold;
445  
446    @SerializedName("exchange_price")
447    public Long exchangePrice;
448  }
449  
450  public static class SequentialCouponAvailablePeriod {
451    @SerializedName("available_begin_time")
452    public String availableBeginTime;
453  
454    @SerializedName("available_end_time")
455    public String availableEndTime;
456  
457    @SerializedName("wait_days_after_receive")
458    public Long waitDaysAfterReceive;
459  
460    @SerializedName("weekly_available_period")
461    public FixedWeekPeriod weeklyAvailablePeriod;
462  
463    @SerializedName("irregular_available_period_list")
464    public List<TimePeriod> irregularAvailablePeriodList;
465  }
466  
467  public static class FixedWeekPeriod {
468    @SerializedName("day_list")
469    public List<WeekEnum> dayList;
470  
471    @SerializedName("day_period_list")
472    public List<PeriodOfTheDay> dayPeriodList;
473  }
474  
475  public static class TimePeriod {
476    @SerializedName("begin_time")
477    public String beginTime;
478  
479    @SerializedName("end_time")
480    public String endTime;
481  }
482  
483  public enum WeekEnum {
484    @SerializedName("MONDAY")
485    MONDAY,
486    @SerializedName("TUESDAY")
487    TUESDAY,
488    @SerializedName("WEDNESDAY")
489    WEDNESDAY,
490    @SerializedName("THURSDAY")
491    THURSDAY,
492    @SerializedName("FRIDAY")
493    FRIDAY,
494    @SerializedName("SATURDAY")
495    SATURDAY,
496    @SerializedName("SUNDAY")
497    SUNDAY
498  }
499  
500  public static class PeriodOfTheDay {
501    @SerializedName("begin_time")
502    public Long beginTime;
503  
504    @SerializedName("end_time")
505    public Long endTime;
506  }
507  
508}
509

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 := &UpdateStockRequest{
29		ProductCouponId: wxpay_brand_utility.String("200000001"),
30		StockId:         wxpay_brand_utility.String("123456789"),
31		OutRequestNo:    wxpay_brand_utility.String("34657_20250101_123456"),
32		Remark:          wxpay_brand_utility.String("疯狂星期四项目专用"),
33		UsageRuleDisplayInfo: &UsageRuleDisplayInfo{
34			CouponUsageMethodList: []CouponUsageMethod{COUPONUSAGEMETHOD_OFFLINE},
35			MiniProgramAppid:      wxpay_brand_utility.String("wx1234567890"),
36			MiniProgramPath:       wxpay_brand_utility.String("/pages/index/product"),
37			AppPath:               wxpay_brand_utility.String("https://www.example.com/jump-to-app"),
38			UsageDescription:      wxpay_brand_utility.String("全场可用"),
39			CouponAvailableStoreInfo: &CouponAvailableStoreInfo{
40				Description:      wxpay_brand_utility.String("可在上海市区的所有门店使用，详细列表参考小程序内信息为准"),
41				MiniProgramAppid: wxpay_brand_utility.String("wx1234567890"),
42				MiniProgramPath:  wxpay_brand_utility.String("/pages/index/store-list"),
43			},
44		},
45		CouponDisplayInfo: &CouponDisplayInfo{
46			CodeDisplayMode: COUPONCODEDISPLAYMODE_QRCODE.Ptr(),
47			BackgroundColor: wxpay_brand_utility.String("Color010"),
48			EntranceMiniProgram: &EntranceMiniProgram{
49				Appid:           wxpay_brand_utility.String("wx1234567890"),
50				Path:            wxpay_brand_utility.String("/pages/index/product"),
51				EntranceWording: wxpay_brand_utility.String("欢迎选购"),
52				GuidanceWording: wxpay_brand_utility.String("获取更多优惠"),
53			},
54			EntranceOfficialAccount: &EntranceOfficialAccount{
55				Appid: wxpay_brand_utility.String("wx1234567890"),
56			},
57			EntranceFinder: &EntranceFinder{
58				FinderId:                 wxpay_brand_utility.String("gh_12345678"),
59				FinderVideoId:            wxpay_brand_utility.String("UDFsdf24df34dD456Hdf34"),
60				FinderVideoCoverImageUrl: wxpay_brand_utility.String("https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"),
61			},
62		},
63		NotifyConfig: &NotifyConfig{
64			NotifyAppid: wxpay_brand_utility.String("wx4fd12345678"),
65		},
66		StoreScope: STOCKSTORESCOPE_SPECIFIC.Ptr(),
67	}
68
69	response, err := UpdateStock(config, request)
70	if err != nil {
71		fmt.Printf("请求失败: %+v\n", err)
72		// TODO: 请求失败，根据状态码执行不同的处理
73		return
74	}
75
76	// TODO: 请求成功，继续业务逻辑
77	fmt.Printf("请求成功: %+v\n", response)
78}
79
80func UpdateStock(config *wxpay_brand_utility.BrandConfig, request *UpdateStockRequest) (response *StockEntity, err error) {
81	const (
82		host   = "https://api.mch.weixin.qq.com"
83		method = "PATCH"
84		path   = "/brand/marketing/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}"
85	)
86
87	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
88	if err != nil {
89		return nil, err
90	}
91	reqUrl.Path = strings.Replace(reqUrl.Path, "{product_coupon_id}", url.PathEscape(*request.ProductCouponId), -1)
92	reqUrl.Path = strings.Replace(reqUrl.Path, "{stock_id}", url.PathEscape(*request.StockId), -1)
93	reqBody, err := json.Marshal(request)
94	if err != nil {
95		return nil, err
96	}
97	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
98	if err != nil {
99		return nil, err
100	}
101	httpRequest.Header.Set("Accept", "application/json")
102	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
103	httpRequest.Header.Set("Content-Type", "application/json")
104	authorization, err := wxpay_brand_utility.BuildAuthorization(config.BrandId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
105	if err != nil {
106		return nil, err
107	}
108	httpRequest.Header.Set("Authorization", authorization)
109
110	client := &http.Client{}
111	httpResponse, err := client.Do(httpRequest)
112	if err != nil {
113		return nil, err
114	}
115	respBody, err := wxpay_brand_utility.ExtractResponseBody(httpResponse)
116	if err != nil {
117		return nil, err
118	}
119	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
120		// 2XX 成功，验证应答签名
121		err = wxpay_brand_utility.ValidateResponse(
122			config.WechatPayPublicKeyId(),
123			config.WechatPayPublicKey(),
124			&httpResponse.Header,
125			respBody,
126		)
127		if err != nil {
128			return nil, err
129		}
130		response := &StockEntity{}
131		if err := json.Unmarshal(respBody, response); err != nil {
132			return nil, err
133		}
134
135		return response, nil
136	} else {
137		return nil, wxpay_brand_utility.NewApiException(
138			httpResponse.StatusCode,
139			httpResponse.Header,
140			respBody,
141		)
142	}
143}
144
145type UpdateStockRequest struct {
146	OutRequestNo         *string               `json:"out_request_no,omitempty"`
147	ProductCouponId      *string               `json:"product_coupon_id,omitempty"`
148	StockId              *string               `json:"stock_id,omitempty"`
149	Remark               *string               `json:"remark,omitempty"`
150	UsageRuleDisplayInfo *UsageRuleDisplayInfo `json:"usage_rule_display_info,omitempty"`
151	CouponDisplayInfo    *CouponDisplayInfo    `json:"coupon_display_info,omitempty"`
152	NotifyConfig         *NotifyConfig         `json:"notify_config,omitempty"`
153	StoreScope           *StockStoreScope      `json:"store_scope,omitempty"`
154}
155
156func (o *UpdateStockRequest) MarshalJSON() ([]byte, error) {
157	type Alias UpdateStockRequest
158	a := &struct {
159		ProductCouponId *string `json:"product_coupon_id,omitempty"`
160		StockId         *string `json:"stock_id,omitempty"`
161		*Alias
162	}{
163		// 序列化时移除非 Body 字段
164		ProductCouponId: nil,
165		StockId:         nil,
166		Alias:           (*Alias)(o),
167	}
168	return json.Marshal(a)
169}
170
171type StockEntity struct {
172	ProductCouponId      *string               `json:"product_coupon_id,omitempty"`
173	StockId              *string               `json:"stock_id,omitempty"`
174	Remark               *string               `json:"remark,omitempty"`
175	CouponCodeMode       *CouponCodeMode       `json:"coupon_code_mode,omitempty"`
176	CouponCodeCountInfo  *CouponCodeCountInfo  `json:"coupon_code_count_info,omitempty"`
177	StockSendRule        *StockSendRule        `json:"stock_send_rule,omitempty"`
178	SingleUsageRule      *SingleUsageRule      `json:"single_usage_rule,omitempty"`
179	SequentialUsageRule  *SequentialUsageRule  `json:"sequential_usage_rule,omitempty"`
180	UsageRuleDisplayInfo *UsageRuleDisplayInfo `json:"usage_rule_display_info,omitempty"`
181	CouponDisplayInfo    *CouponDisplayInfo    `json:"coupon_display_info,omitempty"`
182	NotifyConfig         *NotifyConfig         `json:"notify_config,omitempty"`
183	StoreScope           *StockStoreScope      `json:"store_scope,omitempty"`
184	SentCountInfo        *StockSentCountInfo   `json:"sent_count_info,omitempty"`
185	State                *StockState           `json:"state,omitempty"`
186	DeactivateRequestNo  *string               `json:"deactivate_request_no,omitempty"`
187	DeactivateTime       *time.Time            `json:"deactivate_time,omitempty"`
188	DeactivateReason     *string               `json:"deactivate_reason,omitempty"`
189}
190
191type UsageRuleDisplayInfo struct {
192	CouponUsageMethodList    []CouponUsageMethod       `json:"coupon_usage_method_list,omitempty"`
193	MiniProgramAppid         *string                   `json:"mini_program_appid,omitempty"`
194	MiniProgramPath          *string                   `json:"mini_program_path,omitempty"`
195	AppPath                  *string                   `json:"app_path,omitempty"`
196	UsageDescription         *string                   `json:"usage_description,omitempty"`
197	CouponAvailableStoreInfo *CouponAvailableStoreInfo `json:"coupon_available_store_info,omitempty"`
198}
199
200type CouponDisplayInfo struct {
201	CodeDisplayMode         *CouponCodeDisplayMode   `json:"code_display_mode,omitempty"`
202	BackgroundColor         *string                  `json:"background_color,omitempty"`
203	EntranceMiniProgram     *EntranceMiniProgram     `json:"entrance_mini_program,omitempty"`
204	EntranceOfficialAccount *EntranceOfficialAccount `json:"entrance_official_account,omitempty"`
205	EntranceFinder          *EntranceFinder          `json:"entrance_finder,omitempty"`
206}
207
208type NotifyConfig struct {
209	NotifyAppid *string `json:"notify_appid,omitempty"`
210}
211
212type StockStoreScope string
213
214func (e StockStoreScope) Ptr() *StockStoreScope {
215	return &e
216}
217
218const (
219	STOCKSTORESCOPE_NONE     StockStoreScope = "NONE"
220	STOCKSTORESCOPE_ALL      StockStoreScope = "ALL"
221	STOCKSTORESCOPE_SPECIFIC StockStoreScope = "SPECIFIC"
222)
223
224type CouponCodeMode string
225
226func (e CouponCodeMode) Ptr() *CouponCodeMode {
227	return &e
228}
229
230const (
231	COUPONCODEMODE_WECHATPAY  CouponCodeMode = "WECHATPAY"
232	COUPONCODEMODE_UPLOAD     CouponCodeMode = "UPLOAD"
233	COUPONCODEMODE_API_ASSIGN CouponCodeMode = "API_ASSIGN"
234)
235
236type CouponCodeCountInfo struct {
237	TotalCount     *int64 `json:"total_count,omitempty"`
238	AvailableCount *int64 `json:"available_count,omitempty"`
239}
240
241type StockSendRule struct {
242	MaxCount        *int64 `json:"max_count,omitempty"`
243	MaxCountPerDay  *int64 `json:"max_count_per_day,omitempty"`
244	MaxCountPerUser *int64 `json:"max_count_per_user,omitempty"`
245}
246
247type SingleUsageRule struct {
248	CouponAvailablePeriod *SingleCouponAvailablePeriod `json:"coupon_available_period,omitempty"`
249	NormalCoupon          *NormalCouponUsageRule       `json:"normal_coupon,omitempty"`
250	DiscountCoupon        *DiscountCouponUsageRule     `json:"discount_coupon,omitempty"`
251	ExchangeCoupon        *ExchangeCouponUsageRule     `json:"exchange_coupon,omitempty"`
252}
253
254type SequentialUsageRule struct {
255	CouponAvailablePeriod *SequentialCouponAvailablePeriod `json:"coupon_available_period,omitempty"`
256	NormalCouponList      []NormalCouponUsageRule          `json:"normal_coupon_list,omitempty"`
257	DiscountCouponList    []DiscountCouponUsageRule        `json:"discount_coupon_list,omitempty"`
258	ExchangeCouponList    []ExchangeCouponUsageRule        `json:"exchange_coupon_list,omitempty"`
259	SpecialFirst          *bool                            `json:"special_first,omitempty"`
260}
261
262type StockSentCountInfo struct {
263	TotalCount *int64 `json:"total_count,omitempty"`
264	TodayCount *int64 `json:"today_count,omitempty"`
265}
266
267type StockState string
268
269func (e StockState) Ptr() *StockState {
270	return &e
271}
272
273const (
274	STOCKSTATE_AUDITING    StockState = "AUDITING"
275	STOCKSTATE_SENDING     StockState = "SENDING"
276	STOCKSTATE_PAUSED      StockState = "PAUSED"
277	STOCKSTATE_STOPPED     StockState = "STOPPED"
278	STOCKSTATE_DEACTIVATED StockState = "DEACTIVATED"
279)
280
281type CouponUsageMethod string
282
283func (e CouponUsageMethod) Ptr() *CouponUsageMethod {
284	return &e
285}
286
287const (
288	COUPONUSAGEMETHOD_OFFLINE      CouponUsageMethod = "OFFLINE"
289	COUPONUSAGEMETHOD_MINI_PROGRAM CouponUsageMethod = "MINI_PROGRAM"
290	COUPONUSAGEMETHOD_APP          CouponUsageMethod = "APP"
291	COUPONUSAGEMETHOD_PAYMENT_CODE CouponUsageMethod = "PAYMENT_CODE"
292)
293
294type CouponAvailableStoreInfo struct {
295	Description      *string `json:"description,omitempty"`
296	MiniProgramAppid *string `json:"mini_program_appid,omitempty"`
297	MiniProgramPath  *string `json:"mini_program_path,omitempty"`
298}
299
300type CouponCodeDisplayMode string
301
302func (e CouponCodeDisplayMode) Ptr() *CouponCodeDisplayMode {
303	return &e
304}
305
306const (
307	COUPONCODEDISPLAYMODE_INVISIBLE CouponCodeDisplayMode = "INVISIBLE"
308	COUPONCODEDISPLAYMODE_BARCODE   CouponCodeDisplayMode = "BARCODE"
309	COUPONCODEDISPLAYMODE_QRCODE    CouponCodeDisplayMode = "QRCODE"
310)
311
312type EntranceMiniProgram struct {
313	Appid           *string `json:"appid,omitempty"`
314	Path            *string `json:"path,omitempty"`
315	EntranceWording *string `json:"entrance_wording,omitempty"`
316	GuidanceWording *string `json:"guidance_wording,omitempty"`
317}
318
319type EntranceOfficialAccount struct {
320	Appid *string `json:"appid,omitempty"`
321}
322
323type EntranceFinder struct {
324	FinderId                 *string `json:"finder_id,omitempty"`
325	FinderVideoId            *string `json:"finder_video_id,omitempty"`
326	FinderVideoCoverImageUrl *string `json:"finder_video_cover_image_url,omitempty"`
327}
328
329type SingleCouponAvailablePeriod struct {
330	AvailableBeginTime           *string          `json:"available_begin_time,omitempty"`
331	AvailableEndTime             *string          `json:"available_end_time,omitempty"`
332	AvailableDays                *int64           `json:"available_days,omitempty"`
333	WaitDaysAfterReceive         *int64           `json:"wait_days_after_receive,omitempty"`
334	WeeklyAvailablePeriod        *FixedWeekPeriod `json:"weekly_available_period,omitempty"`
335	IrregularAvailablePeriodList []TimePeriod     `json:"irregular_available_period_list,omitempty"`
336}
337
338type NormalCouponUsageRule struct {
339	Threshold      *int64 `json:"threshold,omitempty"`
340	DiscountAmount *int64 `json:"discount_amount,omitempty"`
341}
342
343type DiscountCouponUsageRule struct {
344	Threshold  *int64 `json:"threshold,omitempty"`
345	PercentOff *int64 `json:"percent_off,omitempty"`
346}
347
348type ExchangeCouponUsageRule struct {
349	Threshold     *int64 `json:"threshold,omitempty"`
350	ExchangePrice *int64 `json:"exchange_price,omitempty"`
351}
352
353type SequentialCouponAvailablePeriod struct {
354	AvailableBeginTime           *string          `json:"available_begin_time,omitempty"`
355	AvailableEndTime             *string          `json:"available_end_time,omitempty"`
356	WaitDaysAfterReceive         *int64           `json:"wait_days_after_receive,omitempty"`
357	WeeklyAvailablePeriod        *FixedWeekPeriod `json:"weekly_available_period,omitempty"`
358	IrregularAvailablePeriodList []TimePeriod     `json:"irregular_available_period_list,omitempty"`
359}
360
361type FixedWeekPeriod struct {
362	DayList       []WeekEnum       `json:"day_list,omitempty"`
363	DayPeriodList []PeriodOfTheDay `json:"day_period_list,omitempty"`
364}
365
366type TimePeriod struct {
367	BeginTime *string `json:"begin_time,omitempty"`
368	EndTime   *string `json:"end_time,omitempty"`
369}
370
371type WeekEnum string
372
373func (e WeekEnum) Ptr() *WeekEnum {
374	return &e
375}
376
377const (
378	WEEKENUM_MONDAY    WeekEnum = "MONDAY"
379	WEEKENUM_TUESDAY   WeekEnum = "TUESDAY"
380	WEEKENUM_WEDNESDAY WeekEnum = "WEDNESDAY"
381	WEEKENUM_THURSDAY  WeekEnum = "THURSDAY"
382	WEEKENUM_FRIDAY    WeekEnum = "FRIDAY"
383	WEEKENUM_SATURDAY  WeekEnum = "SATURDAY"
384	WEEKENUM_SUNDAY    WeekEnum = "SUNDAY"
385)
386
387type PeriodOfTheDay struct {
388	BeginTime *int64 `json:"begin_time,omitempty"`
389	EndTime   *int64 `json:"end_time,omitempty"`
390}
391