核销用户商品券

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/partner/product-coupon/users/oh-394z-6CGkNoJrsDLTTUKiAnp4/coupons/Code_123456/use \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "use_time" : "2025-08-03T12:00:00+08:00",
8    "product_coupon_id" : "1000000013",
9    "appid" : "wx233544546545989",
10    "associated_order_info" : {
11      "transaction_id" : "4200000000123456789123456789"
12    },
13    "stock_id" : "1000000013001",
14    "out_request_no" : "MCHUSE202003101234",
15    "brand_id" : "120344"
16  }'
17

1package com.java.demo;
2
3import com.java.utils.WXPayUtility; // 引用微信支付工具库，参考：https://pay.weixin.qq.com/doc/v3/partner/4014985777
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 UseUserProductCoupon {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/v3/marketing/partner/product-coupon/users/{openid}/coupons/{coupon_code}/use";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    UseUserProductCoupon client = new UseUserProductCoupon(
33      "19xxxxxxxx",                    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
34      "1DDE55AD98Exxxxxxxxxx",         // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
35      "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
36      "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
37      "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
38    );
39
40    UseUserProductCouponRequest request = new UseUserProductCouponRequest();
41    request.productCouponId = "1000000013";
42    request.stockId = "1000000013001";
43    request.couponCode = "Code_123456";
44    request.appid = "wx233544546545989";
45    request.openid = "oh-394z-6CGkNoJrsDLTTUKiAnp4";
46    request.useTime = "2025-08-03T12:00:00+08:00";
47    request.associatedOrderInfo = new UserProductCouponAssociatedOrderInfo();
48    request.associatedOrderInfo.transactionId = "4200000000123456789123456789";
49    request.outRequestNo = "MCHUSE202003101234";
50    request.brandId = "120344";
51    try {
52      UserProductCouponEntity response = client.run(request);
53        // TODO: 请求成功，继续业务逻辑
54        System.out.println(response);
55    } catch (WXPayUtility.ApiException e) {
56        // TODO: 请求失败，根据状态码执行不同的逻辑
57        e.printStackTrace();
58    }
59  }
60
61  public UserProductCouponEntity run(UseUserProductCouponRequest request) {
62    String uri = PATH;
63    uri = uri.replace("{coupon_code}", WXPayUtility.urlEncode(request.couponCode));
64    uri = uri.replace("{openid}", WXPayUtility.urlEncode(request.openid));
65    String reqBody = WXPayUtility.toJson(request);
66
67    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
68    reqBuilder.addHeader("Accept", "application/json");
69    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
70    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
71    reqBuilder.addHeader("Content-Type", "application/json");
72    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
73    reqBuilder.method(METHOD, requestBody);
74    Request httpRequest = reqBuilder.build();
75
76    // 发送HTTP请求
77    OkHttpClient client = new OkHttpClient.Builder().build();
78    try (Response httpResponse = client.newCall(httpRequest).execute()) {
79      String respBody = WXPayUtility.extractBody(httpResponse);
80      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
81        // 2XX 成功，验证应答签名
82        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
83            httpResponse.headers(), respBody);
84
85        // 从HTTP应答报文构建返回数据
86        return WXPayUtility.fromJson(respBody, UserProductCouponEntity.class);
87      } else {
88        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
89      }
90    } catch (IOException e) {
91      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
92    }
93  }
94
95  private final String mchid;
96  private final String certificateSerialNo;
97  private final PrivateKey privateKey;
98  private final String wechatPayPublicKeyId;
99  private final PublicKey wechatPayPublicKey;
100
101  public UseUserProductCoupon(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
102    this.mchid = mchid;
103    this.certificateSerialNo = certificateSerialNo;
104    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
105    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
106    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
107  }
108
109  public static class UseUserProductCouponRequest {
110    @SerializedName("product_coupon_id")
111    public String productCouponId;
112  
113    @SerializedName("stock_id")
114    public String stockId;
115  
116    @SerializedName("coupon_code")
117    @Expose(serialize = false)
118    public String couponCode;
119  
120    @SerializedName("appid")
121    public String appid;
122  
123    @SerializedName("openid")
124    @Expose(serialize = false)
125    public String openid;
126  
127    @SerializedName("use_time")
128    public String useTime;
129  
130    @SerializedName("associated_order_info")
131    public UserProductCouponAssociatedOrderInfo associatedOrderInfo;
132  
133    @SerializedName("out_request_no")
134    public String outRequestNo;
135  
136    @SerializedName("brand_id")
137    public String brandId;
138  
139    @SerializedName("store_id")
140    public String storeId;
141  }
142  
143  public static class UserProductCouponEntity {
144    @SerializedName("coupon_code")
145    public String couponCode;
146  
147    @SerializedName("coupon_state")
148    public UserProductCouponState couponState;
149  
150    @SerializedName("valid_begin_time")
151    public String validBeginTime;
152  
153    @SerializedName("valid_end_time")
154    public String validEndTime;
155  
156    @SerializedName("receive_time")
157    public String receiveTime;
158  
159    @SerializedName("send_request_no")
160    public String sendRequestNo;
161  
162    @SerializedName("send_channel")
163    public UserProductCouponSendChannel sendChannel;
164  
165    @SerializedName("confirm_request_no")
166    public String confirmRequestNo;
167  
168    @SerializedName("confirm_time")
169    public String confirmTime;
170  
171    @SerializedName("deactivate_request_no")
172    public String deactivateRequestNo;
173  
174    @SerializedName("deactivate_time")
175    public String deactivateTime;
176  
177    @SerializedName("deactivate_reason")
178    public String deactivateReason;
179  
180    @SerializedName("single_usage_detail")
181    public CouponUsageDetail singleUsageDetail;
182  
183    @SerializedName("progressive_bundle_usage_detail")
184    public CouponUsageDetail progressiveBundleUsageDetail;
185  
186    @SerializedName("user_product_coupon_bundle_info")
187    public UserProductCouponBundleInfo userProductCouponBundleInfo;
188  
189    @SerializedName("product_coupon")
190    public ProductCouponEntity productCoupon;
191  
192    @SerializedName("stock")
193    public StockEntity stock;
194  
195    @SerializedName("attach")
196    public String attach;
197  
198    @SerializedName("channel_custom_info")
199    public String channelCustomInfo;
200  
201    @SerializedName("coupon_tag_info")
202    public CouponTagInfo couponTagInfo;
203  
204    @SerializedName("brand_id")
205    public String brandId;
206  }
207  
208  public static class UserProductCouponAssociatedOrderInfo {
209    @SerializedName("transaction_id")
210    public String transactionId;
211  
212    @SerializedName("out_trade_no")
213    public String outTradeNo;
214  
215    @SerializedName("mchid")
216    public String mchid;
217  
218    @SerializedName("sub_mchid")
219    public String subMchid;
220  }
221  
222  public enum UserProductCouponState {
223    @SerializedName("CONFIRMING")
224    CONFIRMING,
225    @SerializedName("PENDING")
226    PENDING,
227    @SerializedName("EFFECTIVE")
228    EFFECTIVE,
229    @SerializedName("USED")
230    USED,
231    @SerializedName("EXPIRED")
232    EXPIRED,
233    @SerializedName("DELETED")
234    DELETED,
235    @SerializedName("DEACTIVATED")
236    DEACTIVATED
237  }
238  
239  public enum UserProductCouponSendChannel {
240    @SerializedName("BRAND_MANAGE")
241    BRAND_MANAGE,
242    @SerializedName("API")
243    API,
244    @SerializedName("RECEIVE_COMPONENT")
245    RECEIVE_COMPONENT
246  }
247  
248  public static class CouponUsageDetail {
249    @SerializedName("use_request_no")
250    public String useRequestNo;
251  
252    @SerializedName("use_time")
253    public String useTime;
254  
255    @SerializedName("associated_order_info")
256    public UserProductCouponAssociatedOrderInfo associatedOrderInfo;
257  
258    @SerializedName("return_request_no")
259    public String returnRequestNo;
260  
261    @SerializedName("return_time")
262    public String returnTime;
263  }
264  
265  public static class UserProductCouponBundleInfo {
266    @SerializedName("user_coupon_bundle_id")
267    public String userCouponBundleId;
268  
269    @SerializedName("user_coupon_bundle_index")
270    public Long userCouponBundleIndex;
271  
272    @SerializedName("total_count")
273    public Long totalCount;
274  
275    @SerializedName("used_count")
276    public Long usedCount;
277  }
278  
279  public static class ProductCouponEntity {
280    @SerializedName("product_coupon_id")
281    public String productCouponId;
282  
283    @SerializedName("scope")
284    public ProductCouponScope scope;
285  
286    @SerializedName("type")
287    public ProductCouponType type;
288  
289    @SerializedName("usage_mode")
290    public UsageMode usageMode;
291  
292    @SerializedName("single_usage_info")
293    public SingleUsageInfo singleUsageInfo;
294  
295    @SerializedName("progressive_bundle_usage_info")
296    public ProgressiveBundleUsageInfo progressiveBundleUsageInfo;
297  
298    @SerializedName("display_info")
299    public ProductCouponDisplayInfo displayInfo;
300  
301    @SerializedName("out_product_no")
302    public String outProductNo;
303  
304    @SerializedName("state")
305    public ProductCouponState state;
306  
307    @SerializedName("deactivate_request_no")
308    public String deactivateRequestNo;
309  
310    @SerializedName("deactivate_time")
311    public String deactivateTime;
312  
313    @SerializedName("deactivate_reason")
314    public String deactivateReason;
315  
316    @SerializedName("brand_id")
317    public String brandId;
318  }
319  
320  public static class StockEntity {
321    @SerializedName("product_coupon_id")
322    public String productCouponId;
323  
324    @SerializedName("stock_id")
325    public String stockId;
326  
327    @SerializedName("remark")
328    public String remark;
329  
330    @SerializedName("coupon_code_mode")
331    public CouponCodeMode couponCodeMode;
332  
333    @SerializedName("coupon_code_count_info")
334    public CouponCodeCountInfo couponCodeCountInfo;
335  
336    @SerializedName("stock_send_rule")
337    public StockSendRule stockSendRule;
338  
339    @SerializedName("single_usage_rule")
340    public SingleUsageRule singleUsageRule;
341  
342    @SerializedName("progressive_bundle_usage_rule")
343    public StockUsageRule progressiveBundleUsageRule;
344  
345    @SerializedName("stock_bundle_info")
346    public StockBundleInfo stockBundleInfo;
347  
348    @SerializedName("usage_rule_display_info")
349    public UsageRuleDisplayInfo usageRuleDisplayInfo;
350  
351    @SerializedName("coupon_display_info")
352    public CouponDisplayInfo couponDisplayInfo;
353  
354    @SerializedName("notify_config")
355    public NotifyConfig notifyConfig;
356  
357    @SerializedName("store_scope")
358    public StockStoreScope storeScope;
359  
360    @SerializedName("sent_count_info")
361    public StockSentCountInfo sentCountInfo;
362  
363    @SerializedName("state")
364    public StockState state;
365  
366    @SerializedName("deactivate_request_no")
367    public String deactivateRequestNo;
368  
369    @SerializedName("deactivate_time")
370    public String deactivateTime;
371  
372    @SerializedName("deactivate_reason")
373    public String deactivateReason;
374  
375    @SerializedName("brand_id")
376    public String brandId;
377  }
378  
379  public static class CouponTagInfo {
380    @SerializedName("coupon_tag_list")
381    public List<UserProductCouponTag> couponTagList;
382  
383    @SerializedName("member_tag_info")
384    public MemberTagInfo memberTagInfo;
385  }
386  
387  public enum ProductCouponScope {
388    @SerializedName("ALL")
389    ALL,
390    @SerializedName("SINGLE")
391    SINGLE
392  }
393  
394  public enum ProductCouponType {
395    @SerializedName("NORMAL")
396    NORMAL,
397    @SerializedName("DISCOUNT")
398    DISCOUNT,
399    @SerializedName("EXCHANGE")
400    EXCHANGE
401  }
402  
403  public enum UsageMode {
404    @SerializedName("SINGLE")
405    SINGLE,
406    @SerializedName("PROGRESSIVE_BUNDLE")
407    PROGRESSIVE_BUNDLE
408  }
409  
410  public static class SingleUsageInfo {
411    @SerializedName("normal_coupon")
412    public NormalCouponUsageRule normalCoupon;
413  
414    @SerializedName("discount_coupon")
415    public DiscountCouponUsageRule discountCoupon;
416  }
417  
418  public static class ProgressiveBundleUsageInfo {
419    @SerializedName("count")
420    public Long count;
421  
422    @SerializedName("interval_days")
423    public Long intervalDays;
424  }
425  
426  public static class ProductCouponDisplayInfo {
427    @SerializedName("name")
428    public String name;
429  
430    @SerializedName("image_url")
431    public String imageUrl;
432  
433    @SerializedName("background_url")
434    public String backgroundUrl;
435  
436    @SerializedName("detail_image_url_list")
437    public List<String> detailImageUrlList;
438  
439    @SerializedName("original_price")
440    public Long originalPrice;
441  
442    @SerializedName("combo_package_list")
443    public List<ComboPackage> comboPackageList;
444  }
445  
446  public enum ProductCouponState {
447    @SerializedName("AUDITING")
448    AUDITING,
449    @SerializedName("EFFECTIVE")
450    EFFECTIVE,
451    @SerializedName("DEACTIVATED")
452    DEACTIVATED
453  }
454  
455  public enum CouponCodeMode {
456    @SerializedName("WECHATPAY")
457    WECHATPAY,
458    @SerializedName("UPLOAD")
459    UPLOAD,
460    @SerializedName("API_ASSIGN")
461    API_ASSIGN
462  }
463  
464  public static class CouponCodeCountInfo {
465    @SerializedName("total_count")
466    public Long totalCount;
467  
468    @SerializedName("available_count")
469    public Long availableCount;
470  }
471  
472  public static class StockSendRule {
473    @SerializedName("max_count")
474    public Long maxCount;
475  
476    @SerializedName("max_count_per_day")
477    public Long maxCountPerDay;
478  
479    @SerializedName("max_count_per_user")
480    public Long maxCountPerUser;
481  }
482  
483  public static class SingleUsageRule {
484    @SerializedName("coupon_available_period")
485    public CouponAvailablePeriod couponAvailablePeriod;
486  
487    @SerializedName("normal_coupon")
488    public NormalCouponUsageRule normalCoupon;
489  
490    @SerializedName("discount_coupon")
491    public DiscountCouponUsageRule discountCoupon;
492  
493    @SerializedName("exchange_coupon")
494    public ExchangeCouponUsageRule exchangeCoupon;
495  }
496  
497  public static class StockUsageRule {
498    @SerializedName("coupon_available_period")
499    public CouponAvailablePeriod couponAvailablePeriod;
500  
501    @SerializedName("normal_coupon")
502    public NormalCouponUsageRule normalCoupon;
503  
504    @SerializedName("discount_coupon")
505    public DiscountCouponUsageRule discountCoupon;
506  
507    @SerializedName("exchange_coupon")
508    public ExchangeCouponUsageRule exchangeCoupon;
509  }
510  
511  public static class StockBundleInfo {
512    @SerializedName("stock_bundle_id")
513    public String stockBundleId;
514  
515    @SerializedName("stock_bundle_index")
516    public Long stockBundleIndex;
517  }
518  
519  public static class UsageRuleDisplayInfo {
520    @SerializedName("coupon_usage_method_list")
521    public List<CouponUsageMethod> couponUsageMethodList = new ArrayList<CouponUsageMethod>();
522  
523    @SerializedName("mini_program_appid")
524    public String miniProgramAppid;
525  
526    @SerializedName("mini_program_path")
527    public String miniProgramPath;
528  
529    @SerializedName("app_path")
530    public String appPath;
531  
532    @SerializedName("usage_description")
533    public String usageDescription;
534  
535    @SerializedName("coupon_available_store_info")
536    public CouponAvailableStoreInfo couponAvailableStoreInfo;
537  }
538  
539  public static class CouponDisplayInfo {
540    @SerializedName("code_display_mode")
541    public CouponCodeDisplayMode codeDisplayMode;
542  
543    @SerializedName("background_color")
544    public String backgroundColor;
545  
546    @SerializedName("entrance_mini_program")
547    public EntranceMiniProgram entranceMiniProgram;
548  
549    @SerializedName("entrance_official_account")
550    public EntranceOfficialAccount entranceOfficialAccount;
551  
552    @SerializedName("entrance_finder")
553    public EntranceFinder entranceFinder;
554  }
555  
556  public static class NotifyConfig {
557    @SerializedName("notify_appid")
558    public String notifyAppid;
559  }
560  
561  public enum StockStoreScope {
562    @SerializedName("NONE")
563    NONE,
564    @SerializedName("ALL")
565    ALL,
566    @SerializedName("SPECIFIC")
567    SPECIFIC
568  }
569  
570  public static class StockSentCountInfo {
571    @SerializedName("total_count")
572    public Long totalCount;
573  
574    @SerializedName("today_count")
575    public Long todayCount;
576  }
577  
578  public enum StockState {
579    @SerializedName("AUDITING")
580    AUDITING,
581    @SerializedName("SENDING")
582    SENDING,
583    @SerializedName("PAUSED")
584    PAUSED,
585    @SerializedName("STOPPED")
586    STOPPED,
587    @SerializedName("DEACTIVATED")
588    DEACTIVATED
589  }
590  
591  public enum UserProductCouponTag {
592    @SerializedName("MEMBER")
593    MEMBER
594  }
595  
596  public static class MemberTagInfo {
597    @SerializedName("member_card_id")
598    public String memberCardId;
599  }
600  
601  public static class NormalCouponUsageRule {
602    @SerializedName("threshold")
603    public Long threshold;
604  
605    @SerializedName("discount_amount")
606    public Long discountAmount;
607  }
608  
609  public static class DiscountCouponUsageRule {
610    @SerializedName("threshold")
611    public Long threshold;
612  
613    @SerializedName("percent_off")
614    public Long percentOff;
615  }
616  
617  public static class ComboPackage {
618    @SerializedName("name")
619    public String name;
620  
621    @SerializedName("pick_count")
622    public Long pickCount;
623  
624    @SerializedName("choice_list")
625    public List<ComboPackageChoice> choiceList = new ArrayList<ComboPackageChoice>();
626  }
627  
628  public static class CouponAvailablePeriod {
629    @SerializedName("available_begin_time")
630    public String availableBeginTime;
631  
632    @SerializedName("available_end_time")
633    public String availableEndTime;
634  
635    @SerializedName("available_days")
636    public Long availableDays;
637  
638    @SerializedName("wait_days_after_receive")
639    public Long waitDaysAfterReceive;
640  
641    @SerializedName("weekly_available_period")
642    public FixedWeekPeriod weeklyAvailablePeriod;
643  
644    @SerializedName("irregular_available_period_list")
645    public List<TimePeriod> irregularAvailablePeriodList;
646  }
647  
648  public static class ExchangeCouponUsageRule {
649    @SerializedName("threshold")
650    public Long threshold;
651  
652    @SerializedName("exchange_price")
653    public Long exchangePrice;
654  }
655  
656  public enum CouponUsageMethod {
657    @SerializedName("OFFLINE")
658    OFFLINE,
659    @SerializedName("MINI_PROGRAM")
660    MINI_PROGRAM,
661    @SerializedName("APP")
662    APP,
663    @SerializedName("PAYMENT_CODE")
664    PAYMENT_CODE
665  }
666  
667  public static class CouponAvailableStoreInfo {
668    @SerializedName("description")
669    public String description;
670  
671    @SerializedName("mini_program_appid")
672    public String miniProgramAppid;
673  
674    @SerializedName("mini_program_path")
675    public String miniProgramPath;
676  }
677  
678  public enum CouponCodeDisplayMode {
679    @SerializedName("INVISIBLE")
680    INVISIBLE,
681    @SerializedName("BARCODE")
682    BARCODE,
683    @SerializedName("QRCODE")
684    QRCODE
685  }
686  
687  public static class EntranceMiniProgram {
688    @SerializedName("appid")
689    public String appid;
690  
691    @SerializedName("path")
692    public String path;
693  
694    @SerializedName("entrance_wording")
695    public String entranceWording;
696  
697    @SerializedName("guidance_wording")
698    public String guidanceWording;
699  }
700  
701  public static class EntranceOfficialAccount {
702    @SerializedName("appid")
703    public String appid;
704  }
705  
706  public static class EntranceFinder {
707    @SerializedName("finder_id")
708    public String finderId;
709  
710    @SerializedName("finder_video_id")
711    public String finderVideoId;
712  
713    @SerializedName("finder_video_cover_image_url")
714    public String finderVideoCoverImageUrl;
715  }
716  
717  public static class ComboPackageChoice {
718    @SerializedName("name")
719    public String name;
720  
721    @SerializedName("price")
722    public Long price;
723  
724    @SerializedName("count")
725    public Long count;
726  
727    @SerializedName("image_url")
728    public String imageUrl;
729  
730    @SerializedName("mini_program_appid")
731    public String miniProgramAppid;
732  
733    @SerializedName("mini_program_path")
734    public String miniProgramPath;
735  }
736  
737  public static class FixedWeekPeriod {
738    @SerializedName("day_list")
739    public List<WeekEnum> dayList;
740  
741    @SerializedName("day_period_list")
742    public List<PeriodOfTheDay> dayPeriodList;
743  }
744  
745  public static class TimePeriod {
746    @SerializedName("begin_time")
747    public String beginTime;
748  
749    @SerializedName("end_time")
750    public String endTime;
751  }
752  
753  public enum WeekEnum {
754    @SerializedName("MONDAY")
755    MONDAY,
756    @SerializedName("TUESDAY")
757    TUESDAY,
758    @SerializedName("WEDNESDAY")
759    WEDNESDAY,
760    @SerializedName("THURSDAY")
761    THURSDAY,
762    @SerializedName("FRIDAY")
763    FRIDAY,
764    @SerializedName("SATURDAY")
765    SATURDAY,
766    @SerializedName("SUNDAY")
767    SUNDAY
768  }
769  
770  public static class PeriodOfTheDay {
771    @SerializedName("begin_time")
772    public Long beginTime;
773  
774    @SerializedName("end_time")
775    public Long endTime;
776  }
777  
778}
779

1package main
2
3import (
4	"bytes"
5	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/partner/4015119446
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/v3/partner/4013080340
16	config, err := wxpay_utility.CreateMchConfig(
17		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
18		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
19		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
20		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
21		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
22	)
23	if err != nil {
24		fmt.Println(err)
25		return
26	}
27
28	request := &UseUserProductCouponRequest{
29		ProductCouponId: wxpay_utility.String("1000000013"),
30		StockId:         wxpay_utility.String("1000000013001"),
31		CouponCode:      wxpay_utility.String("Code_123456"),
32		Appid:           wxpay_utility.String("wx233544546545989"),
33		Openid:          wxpay_utility.String("oh-394z-6CGkNoJrsDLTTUKiAnp4"),
34		UseTime:         wxpay_utility.Time(time.Now()),
35		AssociatedOrderInfo: &UserProductCouponAssociatedOrderInfo{
36			TransactionId: wxpay_utility.String("4200000000123456789123456789"),
37		},
38		OutRequestNo: wxpay_utility.String("MCHUSE202003101234"),
39		BrandId:      wxpay_utility.String("120344"),
40	}
41
42	response, err := UseUserProductCoupon(config, request)
43	if err != nil {
44		fmt.Printf("请求失败: %+v\n", err)
45		// TODO: 请求失败，根据状态码执行不同的处理
46		return
47	}
48
49	// TODO: 请求成功，继续业务逻辑
50	fmt.Printf("请求成功: %+v\n", response)
51}
52
53func UseUserProductCoupon(config *wxpay_utility.MchConfig, request *UseUserProductCouponRequest) (response *UserProductCouponEntity, err error) {
54	const (
55		host   = "https://api.mch.weixin.qq.com"
56		method = "POST"
57		path   = "/v3/marketing/partner/product-coupon/users/{openid}/coupons/{coupon_code}/use"
58	)
59
60	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
61	if err != nil {
62		return nil, err
63	}
64	reqUrl.Path = strings.Replace(reqUrl.Path, "{coupon_code}", url.PathEscape(*request.CouponCode), -1)
65	reqUrl.Path = strings.Replace(reqUrl.Path, "{openid}", url.PathEscape(*request.Openid), -1)
66	reqBody, err := json.Marshal(request)
67	if err != nil {
68		return nil, err
69	}
70	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
71	if err != nil {
72		return nil, err
73	}
74	httpRequest.Header.Set("Accept", "application/json")
75	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
76	httpRequest.Header.Set("Content-Type", "application/json")
77	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
78	if err != nil {
79		return nil, err
80	}
81	httpRequest.Header.Set("Authorization", authorization)
82
83	client := &http.Client{}
84	httpResponse, err := client.Do(httpRequest)
85	if err != nil {
86		return nil, err
87	}
88	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
89	if err != nil {
90		return nil, err
91	}
92	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
93		// 2XX 成功，验证应答签名
94		err = wxpay_utility.ValidateResponse(
95			config.WechatPayPublicKeyId(),
96			config.WechatPayPublicKey(),
97			&httpResponse.Header,
98			respBody,
99		)
100		if err != nil {
101			return nil, err
102		}
103		response := &UserProductCouponEntity{}
104		if err := json.Unmarshal(respBody, response); err != nil {
105			return nil, err
106		}
107
108		return response, nil
109	} else {
110		return nil, wxpay_utility.NewApiException(
111			httpResponse.StatusCode,
112			httpResponse.Header,
113			respBody,
114		)
115	}
116}
117
118type UseUserProductCouponRequest struct {
119	ProductCouponId     *string                               `json:"product_coupon_id,omitempty"`
120	StockId             *string                               `json:"stock_id,omitempty"`
121	CouponCode          *string                               `json:"coupon_code,omitempty"`
122	Appid               *string                               `json:"appid,omitempty"`
123	Openid              *string                               `json:"openid,omitempty"`
124	UseTime             *time.Time                            `json:"use_time,omitempty"`
125	AssociatedOrderInfo *UserProductCouponAssociatedOrderInfo `json:"associated_order_info,omitempty"`
126	OutRequestNo        *string                               `json:"out_request_no,omitempty"`
127	BrandId             *string                               `json:"brand_id,omitempty"`
128	StoreId             *string                               `json:"store_id,omitempty"`
129}
130
131func (o *UseUserProductCouponRequest) MarshalJSON() ([]byte, error) {
132	type Alias UseUserProductCouponRequest
133	a := &struct {
134		CouponCode *string `json:"coupon_code,omitempty"`
135		Openid     *string `json:"openid,omitempty"`
136		*Alias
137	}{
138		// 序列化时移除非 Body 字段
139		CouponCode: nil,
140		Openid:     nil,
141		Alias:      (*Alias)(o),
142	}
143	return json.Marshal(a)
144}
145
146type UserProductCouponEntity struct {
147	CouponCode                   *string                       `json:"coupon_code,omitempty"`
148	CouponState                  *UserProductCouponState       `json:"coupon_state,omitempty"`
149	ValidBeginTime               *time.Time                    `json:"valid_begin_time,omitempty"`
150	ValidEndTime                 *time.Time                    `json:"valid_end_time,omitempty"`
151	ReceiveTime                  *string                       `json:"receive_time,omitempty"`
152	SendRequestNo                *string                       `json:"send_request_no,omitempty"`
153	SendChannel                  *UserProductCouponSendChannel `json:"send_channel,omitempty"`
154	ConfirmRequestNo             *string                       `json:"confirm_request_no,omitempty"`
155	ConfirmTime                  *time.Time                    `json:"confirm_time,omitempty"`
156	DeactivateRequestNo          *string                       `json:"deactivate_request_no,omitempty"`
157	DeactivateTime               *string                       `json:"deactivate_time,omitempty"`
158	DeactivateReason             *string                       `json:"deactivate_reason,omitempty"`
159	SingleUsageDetail            *CouponUsageDetail            `json:"single_usage_detail,omitempty"`
160	ProgressiveBundleUsageDetail *CouponUsageDetail            `json:"progressive_bundle_usage_detail,omitempty"`
161	UserProductCouponBundleInfo  *UserProductCouponBundleInfo  `json:"user_product_coupon_bundle_info,omitempty"`
162	ProductCoupon                *ProductCouponEntity          `json:"product_coupon,omitempty"`
163	Stock                        *StockEntity                  `json:"stock,omitempty"`
164	Attach                       *string                       `json:"attach,omitempty"`
165	ChannelCustomInfo            *string                       `json:"channel_custom_info,omitempty"`
166	CouponTagInfo                *CouponTagInfo                `json:"coupon_tag_info,omitempty"`
167	BrandId                      *string                       `json:"brand_id,omitempty"`
168}
169
170type UserProductCouponAssociatedOrderInfo struct {
171	TransactionId *string `json:"transaction_id,omitempty"`
172	OutTradeNo    *string `json:"out_trade_no,omitempty"`
173	Mchid         *string `json:"mchid,omitempty"`
174	SubMchid      *string `json:"sub_mchid,omitempty"`
175}
176
177type UserProductCouponState string
178
179func (e UserProductCouponState) Ptr() *UserProductCouponState {
180	return &e
181}
182
183const (
184	USERPRODUCTCOUPONSTATE_CONFIRMING  UserProductCouponState = "CONFIRMING"
185	USERPRODUCTCOUPONSTATE_PENDING     UserProductCouponState = "PENDING"
186	USERPRODUCTCOUPONSTATE_EFFECTIVE   UserProductCouponState = "EFFECTIVE"
187	USERPRODUCTCOUPONSTATE_USED        UserProductCouponState = "USED"
188	USERPRODUCTCOUPONSTATE_EXPIRED     UserProductCouponState = "EXPIRED"
189	USERPRODUCTCOUPONSTATE_DELETED     UserProductCouponState = "DELETED"
190	USERPRODUCTCOUPONSTATE_DEACTIVATED UserProductCouponState = "DEACTIVATED"
191)
192
193type UserProductCouponSendChannel string
194
195func (e UserProductCouponSendChannel) Ptr() *UserProductCouponSendChannel {
196	return &e
197}
198
199const (
200	USERPRODUCTCOUPONSENDCHANNEL_BRAND_MANAGE      UserProductCouponSendChannel = "BRAND_MANAGE"
201	USERPRODUCTCOUPONSENDCHANNEL_API               UserProductCouponSendChannel = "API"
202	USERPRODUCTCOUPONSENDCHANNEL_RECEIVE_COMPONENT UserProductCouponSendChannel = "RECEIVE_COMPONENT"
203)
204
205type CouponUsageDetail struct {
206	UseRequestNo        *string                               `json:"use_request_no,omitempty"`
207	UseTime             *time.Time                            `json:"use_time,omitempty"`
208	AssociatedOrderInfo *UserProductCouponAssociatedOrderInfo `json:"associated_order_info,omitempty"`
209	ReturnRequestNo     *string                               `json:"return_request_no,omitempty"`
210	ReturnTime          *time.Time                            `json:"return_time,omitempty"`
211}
212
213type UserProductCouponBundleInfo struct {
214	UserCouponBundleId    *string `json:"user_coupon_bundle_id,omitempty"`
215	UserCouponBundleIndex *int64  `json:"user_coupon_bundle_index,omitempty"`
216	TotalCount            *int64  `json:"total_count,omitempty"`
217	UsedCount             *int64  `json:"used_count,omitempty"`
218}
219
220type ProductCouponEntity struct {
221	ProductCouponId            *string                     `json:"product_coupon_id,omitempty"`
222	Scope                      *ProductCouponScope         `json:"scope,omitempty"`
223	Type                       *ProductCouponType          `json:"type,omitempty"`
224	UsageMode                  *UsageMode                  `json:"usage_mode,omitempty"`
225	SingleUsageInfo            *SingleUsageInfo            `json:"single_usage_info,omitempty"`
226	ProgressiveBundleUsageInfo *ProgressiveBundleUsageInfo `json:"progressive_bundle_usage_info,omitempty"`
227	DisplayInfo                *ProductCouponDisplayInfo   `json:"display_info,omitempty"`
228	OutProductNo               *string                     `json:"out_product_no,omitempty"`
229	State                      *ProductCouponState         `json:"state,omitempty"`
230	DeactivateRequestNo        *string                     `json:"deactivate_request_no,omitempty"`
231	DeactivateTime             *string                     `json:"deactivate_time,omitempty"`
232	DeactivateReason           *string                     `json:"deactivate_reason,omitempty"`
233	BrandId                    *string                     `json:"brand_id,omitempty"`
234}
235
236type StockEntity struct {
237	ProductCouponId            *string               `json:"product_coupon_id,omitempty"`
238	StockId                    *string               `json:"stock_id,omitempty"`
239	Remark                     *string               `json:"remark,omitempty"`
240	CouponCodeMode             *CouponCodeMode       `json:"coupon_code_mode,omitempty"`
241	CouponCodeCountInfo        *CouponCodeCountInfo  `json:"coupon_code_count_info,omitempty"`
242	StockSendRule              *StockSendRule        `json:"stock_send_rule,omitempty"`
243	SingleUsageRule            *SingleUsageRule      `json:"single_usage_rule,omitempty"`
244	ProgressiveBundleUsageRule *StockUsageRule       `json:"progressive_bundle_usage_rule,omitempty"`
245	StockBundleInfo            *StockBundleInfo      `json:"stock_bundle_info,omitempty"`
246	UsageRuleDisplayInfo       *UsageRuleDisplayInfo `json:"usage_rule_display_info,omitempty"`
247	CouponDisplayInfo          *CouponDisplayInfo    `json:"coupon_display_info,omitempty"`
248	NotifyConfig               *NotifyConfig         `json:"notify_config,omitempty"`
249	StoreScope                 *StockStoreScope      `json:"store_scope,omitempty"`
250	SentCountInfo              *StockSentCountInfo   `json:"sent_count_info,omitempty"`
251	State                      *StockState           `json:"state,omitempty"`
252	DeactivateRequestNo        *string               `json:"deactivate_request_no,omitempty"`
253	DeactivateTime             *time.Time            `json:"deactivate_time,omitempty"`
254	DeactivateReason           *string               `json:"deactivate_reason,omitempty"`
255	BrandId                    *string               `json:"brand_id,omitempty"`
256}
257
258type CouponTagInfo struct {
259	CouponTagList []UserProductCouponTag `json:"coupon_tag_list,omitempty"`
260	MemberTagInfo *MemberTagInfo         `json:"member_tag_info,omitempty"`
261}
262
263type ProductCouponScope string
264
265func (e ProductCouponScope) Ptr() *ProductCouponScope {
266	return &e
267}
268
269const (
270	PRODUCTCOUPONSCOPE_ALL    ProductCouponScope = "ALL"
271	PRODUCTCOUPONSCOPE_SINGLE ProductCouponScope = "SINGLE"
272)
273
274type ProductCouponType string
275
276func (e ProductCouponType) Ptr() *ProductCouponType {
277	return &e
278}
279
280const (
281	PRODUCTCOUPONTYPE_NORMAL   ProductCouponType = "NORMAL"
282	PRODUCTCOUPONTYPE_DISCOUNT ProductCouponType = "DISCOUNT"
283	PRODUCTCOUPONTYPE_EXCHANGE ProductCouponType = "EXCHANGE"
284)
285
286type UsageMode string
287
288func (e UsageMode) Ptr() *UsageMode {
289	return &e
290}
291
292const (
293	USAGEMODE_SINGLE             UsageMode = "SINGLE"
294	USAGEMODE_PROGRESSIVE_BUNDLE UsageMode = "PROGRESSIVE_BUNDLE"
295)
296
297type SingleUsageInfo struct {
298	NormalCoupon   *NormalCouponUsageRule   `json:"normal_coupon,omitempty"`
299	DiscountCoupon *DiscountCouponUsageRule `json:"discount_coupon,omitempty"`
300}
301
302type ProgressiveBundleUsageInfo struct {
303	Count        *int64 `json:"count,omitempty"`
304	IntervalDays *int64 `json:"interval_days,omitempty"`
305}
306
307type ProductCouponDisplayInfo struct {
308	Name               *string        `json:"name,omitempty"`
309	ImageUrl           *string        `json:"image_url,omitempty"`
310	BackgroundUrl      *string        `json:"background_url,omitempty"`
311	DetailImageUrlList []string       `json:"detail_image_url_list,omitempty"`
312	OriginalPrice      *int64         `json:"original_price,omitempty"`
313	ComboPackageList   []ComboPackage `json:"combo_package_list,omitempty"`
314}
315
316type ProductCouponState string
317
318func (e ProductCouponState) Ptr() *ProductCouponState {
319	return &e
320}
321
322const (
323	PRODUCTCOUPONSTATE_AUDITING    ProductCouponState = "AUDITING"
324	PRODUCTCOUPONSTATE_EFFECTIVE   ProductCouponState = "EFFECTIVE"
325	PRODUCTCOUPONSTATE_DEACTIVATED ProductCouponState = "DEACTIVATED"
326)
327
328type CouponCodeMode string
329
330func (e CouponCodeMode) Ptr() *CouponCodeMode {
331	return &e
332}
333
334const (
335	COUPONCODEMODE_WECHATPAY  CouponCodeMode = "WECHATPAY"
336	COUPONCODEMODE_UPLOAD     CouponCodeMode = "UPLOAD"
337	COUPONCODEMODE_API_ASSIGN CouponCodeMode = "API_ASSIGN"
338)
339
340type CouponCodeCountInfo struct {
341	TotalCount     *int64 `json:"total_count,omitempty"`
342	AvailableCount *int64 `json:"available_count,omitempty"`
343}
344
345type StockSendRule struct {
346	MaxCount        *int64 `json:"max_count,omitempty"`
347	MaxCountPerDay  *int64 `json:"max_count_per_day,omitempty"`
348	MaxCountPerUser *int64 `json:"max_count_per_user,omitempty"`
349}
350
351type SingleUsageRule struct {
352	CouponAvailablePeriod *CouponAvailablePeriod   `json:"coupon_available_period,omitempty"`
353	NormalCoupon          *NormalCouponUsageRule   `json:"normal_coupon,omitempty"`
354	DiscountCoupon        *DiscountCouponUsageRule `json:"discount_coupon,omitempty"`
355	ExchangeCoupon        *ExchangeCouponUsageRule `json:"exchange_coupon,omitempty"`
356}
357
358type StockUsageRule struct {
359	CouponAvailablePeriod *CouponAvailablePeriod   `json:"coupon_available_period,omitempty"`
360	NormalCoupon          *NormalCouponUsageRule   `json:"normal_coupon,omitempty"`
361	DiscountCoupon        *DiscountCouponUsageRule `json:"discount_coupon,omitempty"`
362	ExchangeCoupon        *ExchangeCouponUsageRule `json:"exchange_coupon,omitempty"`
363}
364
365type StockBundleInfo struct {
366	StockBundleId    *string `json:"stock_bundle_id,omitempty"`
367	StockBundleIndex *int64  `json:"stock_bundle_index,omitempty"`
368}
369
370type UsageRuleDisplayInfo struct {
371	CouponUsageMethodList    []CouponUsageMethod       `json:"coupon_usage_method_list,omitempty"`
372	MiniProgramAppid         *string                   `json:"mini_program_appid,omitempty"`
373	MiniProgramPath          *string                   `json:"mini_program_path,omitempty"`
374	AppPath                  *string                   `json:"app_path,omitempty"`
375	UsageDescription         *string                   `json:"usage_description,omitempty"`
376	CouponAvailableStoreInfo *CouponAvailableStoreInfo `json:"coupon_available_store_info,omitempty"`
377}
378
379type CouponDisplayInfo struct {
380	CodeDisplayMode         *CouponCodeDisplayMode   `json:"code_display_mode,omitempty"`
381	BackgroundColor         *string                  `json:"background_color,omitempty"`
382	EntranceMiniProgram     *EntranceMiniProgram     `json:"entrance_mini_program,omitempty"`
383	EntranceOfficialAccount *EntranceOfficialAccount `json:"entrance_official_account,omitempty"`
384	EntranceFinder          *EntranceFinder          `json:"entrance_finder,omitempty"`
385}
386
387type NotifyConfig struct {
388	NotifyAppid *string `json:"notify_appid,omitempty"`
389}
390
391type StockStoreScope string
392
393func (e StockStoreScope) Ptr() *StockStoreScope {
394	return &e
395}
396
397const (
398	STOCKSTORESCOPE_NONE     StockStoreScope = "NONE"
399	STOCKSTORESCOPE_ALL      StockStoreScope = "ALL"
400	STOCKSTORESCOPE_SPECIFIC StockStoreScope = "SPECIFIC"
401)
402
403type StockSentCountInfo struct {
404	TotalCount *int64 `json:"total_count,omitempty"`
405	TodayCount *int64 `json:"today_count,omitempty"`
406}
407
408type StockState string
409
410func (e StockState) Ptr() *StockState {
411	return &e
412}
413
414const (
415	STOCKSTATE_AUDITING    StockState = "AUDITING"
416	STOCKSTATE_SENDING     StockState = "SENDING"
417	STOCKSTATE_PAUSED      StockState = "PAUSED"
418	STOCKSTATE_STOPPED     StockState = "STOPPED"
419	STOCKSTATE_DEACTIVATED StockState = "DEACTIVATED"
420)
421
422type UserProductCouponTag string
423
424func (e UserProductCouponTag) Ptr() *UserProductCouponTag {
425	return &e
426}
427
428const (
429	USERPRODUCTCOUPONTAG_MEMBER UserProductCouponTag = "MEMBER"
430)
431
432type MemberTagInfo struct {
433	MemberCardId *string `json:"member_card_id,omitempty"`
434}
435
436type NormalCouponUsageRule struct {
437	Threshold      *int64 `json:"threshold,omitempty"`
438	DiscountAmount *int64 `json:"discount_amount,omitempty"`
439}
440
441type DiscountCouponUsageRule struct {
442	Threshold  *int64 `json:"threshold,omitempty"`
443	PercentOff *int64 `json:"percent_off,omitempty"`
444}
445
446type ComboPackage struct {
447	Name       *string              `json:"name,omitempty"`
448	PickCount  *int64               `json:"pick_count,omitempty"`
449	ChoiceList []ComboPackageChoice `json:"choice_list,omitempty"`
450}
451
452type CouponAvailablePeriod struct {
453	AvailableBeginTime           *string          `json:"available_begin_time,omitempty"`
454	AvailableEndTime             *string          `json:"available_end_time,omitempty"`
455	AvailableDays                *int64           `json:"available_days,omitempty"`
456	WaitDaysAfterReceive         *int64           `json:"wait_days_after_receive,omitempty"`
457	WeeklyAvailablePeriod        *FixedWeekPeriod `json:"weekly_available_period,omitempty"`
458	IrregularAvailablePeriodList []TimePeriod     `json:"irregular_available_period_list,omitempty"`
459}
460
461type ExchangeCouponUsageRule struct {
462	Threshold     *int64 `json:"threshold,omitempty"`
463	ExchangePrice *int64 `json:"exchange_price,omitempty"`
464}
465
466type CouponUsageMethod string
467
468func (e CouponUsageMethod) Ptr() *CouponUsageMethod {
469	return &e
470}
471
472const (
473	COUPONUSAGEMETHOD_OFFLINE      CouponUsageMethod = "OFFLINE"
474	COUPONUSAGEMETHOD_MINI_PROGRAM CouponUsageMethod = "MINI_PROGRAM"
475	COUPONUSAGEMETHOD_APP          CouponUsageMethod = "APP"
476	COUPONUSAGEMETHOD_PAYMENT_CODE CouponUsageMethod = "PAYMENT_CODE"
477)
478
479type CouponAvailableStoreInfo struct {
480	Description      *string `json:"description,omitempty"`
481	MiniProgramAppid *string `json:"mini_program_appid,omitempty"`
482	MiniProgramPath  *string `json:"mini_program_path,omitempty"`
483}
484
485type CouponCodeDisplayMode string
486
487func (e CouponCodeDisplayMode) Ptr() *CouponCodeDisplayMode {
488	return &e
489}
490
491const (
492	COUPONCODEDISPLAYMODE_INVISIBLE CouponCodeDisplayMode = "INVISIBLE"
493	COUPONCODEDISPLAYMODE_BARCODE   CouponCodeDisplayMode = "BARCODE"
494	COUPONCODEDISPLAYMODE_QRCODE    CouponCodeDisplayMode = "QRCODE"
495)
496
497type EntranceMiniProgram struct {
498	Appid           *string `json:"appid,omitempty"`
499	Path            *string `json:"path,omitempty"`
500	EntranceWording *string `json:"entrance_wording,omitempty"`
501	GuidanceWording *string `json:"guidance_wording,omitempty"`
502}
503
504type EntranceOfficialAccount struct {
505	Appid *string `json:"appid,omitempty"`
506}
507
508type EntranceFinder struct {
509	FinderId                 *string `json:"finder_id,omitempty"`
510	FinderVideoId            *string `json:"finder_video_id,omitempty"`
511	FinderVideoCoverImageUrl *string `json:"finder_video_cover_image_url,omitempty"`
512}
513
514type ComboPackageChoice struct {
515	Name             *string `json:"name,omitempty"`
516	Price            *int64  `json:"price,omitempty"`
517	Count            *int64  `json:"count,omitempty"`
518	ImageUrl         *string `json:"image_url,omitempty"`
519	MiniProgramAppid *string `json:"mini_program_appid,omitempty"`
520	MiniProgramPath  *string `json:"mini_program_path,omitempty"`
521}
522
523type FixedWeekPeriod struct {
524	DayList       []WeekEnum       `json:"day_list,omitempty"`
525	DayPeriodList []PeriodOfTheDay `json:"day_period_list,omitempty"`
526}
527
528type TimePeriod struct {
529	BeginTime *string `json:"begin_time,omitempty"`
530	EndTime   *string `json:"end_time,omitempty"`
531}
532
533type WeekEnum string
534
535func (e WeekEnum) Ptr() *WeekEnum {
536	return &e
537}
538
539const (
540	WEEKENUM_MONDAY    WeekEnum = "MONDAY"
541	WEEKENUM_TUESDAY   WeekEnum = "TUESDAY"
542	WEEKENUM_WEDNESDAY WeekEnum = "WEDNESDAY"
543	WEEKENUM_THURSDAY  WeekEnum = "THURSDAY"
544	WEEKENUM_FRIDAY    WeekEnum = "FRIDAY"
545	WEEKENUM_SATURDAY  WeekEnum = "SATURDAY"
546	WEEKENUM_SUNDAY    WeekEnum = "SUNDAY"
547)
548
549type PeriodOfTheDay struct {
550	BeginTime *int64 `json:"begin_time,omitempty"`
551	EndTime   *int64 `json:"end_time,omitempty"`
552}
553