失效用户商品券

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/partner/product-coupon/users/oh-394z-6CGkNoJrsDLTTUKiAnp4/coupons/123446565767/deactivate \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "product_coupon_id" : "1002323",
8    "stock_id" : "100232301",
9    "appid" : "wx233544546545989",
10    "out_request_no" : "1002600620019090123144054436",
11    "deactivate_reason" : "商品已下线，使用户商品券失效",
12    "brand_id" : "120344"
13  }'
14

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

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