确认发放用户商品券

1curl -X POST \
2  https://api.mch.weixin.qq.com/brand/marketing/product-coupon/users/oh-394z-6CGkNoJrsDLTTUKiAnp4/coupons/Code_123456/confirm \
3  -H "Authorization: WECHATPAY-BRAND-SHA256-RSA2048 brand_id=\"XXXX\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: PUB_KEY_ID_XXXX"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "product_coupon_id" : "1000000013",
9    "appid" : "wx233544546545989",
10    "stock_id" : "1000000013001",
11    "out_request_no" : "MCHCONFIRM202003101234"
12  }'
13

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

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