创建品牌会员发券活动

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/brand/partner/card-member/membership-activities \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_request_no" : "100002322019090134234sfdf",
8    "brand_id" : "1004",
9    "card_id" : "pbLatjvWOibDc5-TBnbUk1pD12o0",
10    "activity_channel" : "MECHANT_APP_COMPONENT",
11    "title" : "入会享券",
12    "sub_title" : "5张满减券",
13    "begin_time" : "2025-05-20T13:29:35.120+08:00",
14    "end_time" : "2026-05-20T13:29:35.120+08:00",
15    "apply_total" : 1000,
16    "product_coupon_stock_list" : [
17      {
18        "product_coupon_id" : "701138812971763025610907319729",
19        "stock_id" : "701211100891757235590194161918"
20      }
21    ]
22  }'
23

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 CreateMembershipActivity {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/v3/brand/partner/card-member/membership-activities";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    CreateMembershipActivity client = new CreateMembershipActivity(
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    CreateMembershipActivityRequest request = new CreateMembershipActivityRequest();
41    request.outRequestNo = "100002322019090134234sfdf";
42    request.brandId = "1004";
43    request.cardId = "pbLatjvWOibDc5-TBnbUk1pD12o0";
44    request.activityChannel = MembershipActivityChannel.MECHANT_APP_COMPONENT;
45    request.title = "入会享券";
46    request.subTitle = "5张满减券";
47    request.beginTime = "2025-05-20T13:29:35.120+08:00";
48    request.endTime = "2026-05-20T13:29:35.120+08:00";
49    request.applyTotal = 1000L;
50    request.productCouponStockList = new ArrayList<>();
51    {
52      ProductCouponStock productCouponStockListItem = new ProductCouponStock();
53      productCouponStockListItem.productCouponId = "701138812971763025610907319729";
54      productCouponStockListItem.stockId = "701211100891757235590194161918";
55      request.productCouponStockList.add(productCouponStockListItem);
56    };
57    try {
58      MembershipActivity response = client.run(request);
59        // TODO: 请求成功，继续业务逻辑
60        System.out.println(response);
61    } catch (WXPayUtility.ApiException e) {
62        // TODO: 请求失败，根据状态码执行不同的逻辑
63        e.printStackTrace();
64    }
65  }
66
67  public MembershipActivity run(CreateMembershipActivityRequest request) {
68    String uri = PATH;
69    String reqBody = WXPayUtility.toJson(request);
70
71    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
72    reqBuilder.addHeader("Accept", "application/json");
73    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
74    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
75    reqBuilder.addHeader("Content-Type", "application/json");
76    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
77    reqBuilder.method(METHOD, requestBody);
78    Request httpRequest = reqBuilder.build();
79
80    // 发送HTTP请求
81    OkHttpClient client = new OkHttpClient.Builder().build();
82    try (Response httpResponse = client.newCall(httpRequest).execute()) {
83      String respBody = WXPayUtility.extractBody(httpResponse);
84      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
85        // 2XX 成功，验证应答签名
86        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
87            httpResponse.headers(), respBody);
88
89        // 从HTTP应答报文构建返回数据
90        return WXPayUtility.fromJson(respBody, MembershipActivity.class);
91      } else {
92        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
93      }
94    } catch (IOException e) {
95      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
96    }
97  }
98
99  private final String mchid;
100  private final String certificateSerialNo;
101  private final PrivateKey privateKey;
102  private final String wechatPayPublicKeyId;
103  private final PublicKey wechatPayPublicKey;
104
105  public CreateMembershipActivity(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
106    this.mchid = mchid;
107    this.certificateSerialNo = certificateSerialNo;
108    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
109    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
110    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
111  }
112
113  public static class CreateMembershipActivityRequest {
114    @SerializedName("out_request_no")
115    public String outRequestNo;
116  
117    @SerializedName("brand_id")
118    public String brandId;
119  
120    @SerializedName("card_id")
121    public String cardId;
122  
123    @SerializedName("activity_channel")
124    public MembershipActivityChannel activityChannel;
125  
126    @SerializedName("title")
127    public String title;
128  
129    @SerializedName("sub_title")
130    public String subTitle;
131  
132    @SerializedName("begin_time")
133    public String beginTime;
134  
135    @SerializedName("end_time")
136    public String endTime;
137  
138    @SerializedName("apply_total")
139    public Long applyTotal;
140  
141    @SerializedName("product_coupon_stock_list")
142    public List<ProductCouponStock> productCouponStockList = new ArrayList<ProductCouponStock>();
143  }
144  
145  public static class MembershipActivity {
146    @SerializedName("out_request_no")
147    public String outRequestNo;
148  
149    @SerializedName("brand_id")
150    public String brandId;
151  
152    @SerializedName("card_id")
153    public String cardId;
154  
155    @SerializedName("activity_channel")
156    public MembershipActivityChannel activityChannel;
157  
158    @SerializedName("title")
159    public String title;
160  
161    @SerializedName("sub_title")
162    public String subTitle;
163  
164    @SerializedName("begin_time")
165    public String beginTime;
166  
167    @SerializedName("end_time")
168    public String endTime;
169  
170    @SerializedName("apply_total")
171    public Long applyTotal;
172  
173    @SerializedName("apply_available")
174    public Long applyAvailable;
175  
176    @SerializedName("product_coupon_stock_list")
177    public List<ProductCouponStock> productCouponStockList;
178  
179    @SerializedName("activity_id")
180    public Long activityId;
181  
182    @SerializedName("activity_state")
183    public MembershipGiftActivityState activityState;
184  
185    @SerializedName("create_time")
186    public String createTime;
187  
188    @SerializedName("modify_time")
189    public String modifyTime;
190  }
191  
192  public enum MembershipActivityChannel {
193    @SerializedName("MECHANT_APP_COMPONENT")
194    MECHANT_APP_COMPONENT
195  }
196  
197  public static class ProductCouponStock {
198    @SerializedName("product_coupon_id")
199    public String productCouponId;
200  
201    @SerializedName("stock_id")
202    public String stockId;
203  }
204  
205  public enum MembershipGiftActivityState {
206    @SerializedName("MEMBERSHIP_ACTIVITY_CREATED")
207    MEMBERSHIP_ACTIVITY_CREATED,
208    @SerializedName("MEMBERSHIP_ACTIVITY_EFFECTIVE")
209    MEMBERSHIP_ACTIVITY_EFFECTIVE,
210    @SerializedName("MEMBERSHIP_ACTIVITY_TERMINATED")
211    MEMBERSHIP_ACTIVITY_TERMINATED,
212    @SerializedName("MEMBERSHIP_ACTIVITY_EXPIRED")
213    MEMBERSHIP_ACTIVITY_EXPIRED
214  }
215  
216}
217

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)
11
12func main() {
13	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
14	config, err := wxpay_utility.CreateMchConfig(
15		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
16		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
17		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
18		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
19		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
20	)
21	if err != nil {
22		fmt.Println(err)
23		return
24	}
25
26	request := &CreateMembershipActivityRequest{
27		OutRequestNo:    wxpay_utility.String("100002322019090134234sfdf"),
28		BrandId:         wxpay_utility.String("1004"),
29		CardId:          wxpay_utility.String("pbLatjvWOibDc5-TBnbUk1pD12o0"),
30		ActivityChannel: MEMBERSHIPACTIVITYCHANNEL_MECHANT_APP_COMPONENT.Ptr(),
31		Title:           wxpay_utility.String("入会享券"),
32		SubTitle:        wxpay_utility.String("5张满减券"),
33		BeginTime:       wxpay_utility.String("2025-05-20T13:29:35.120+08:00"),
34		EndTime:         wxpay_utility.String("2026-05-20T13:29:35.120+08:00"),
35		ApplyTotal:      wxpay_utility.Int64(1000),
36		ProductCouponStockList: []ProductCouponStock{ProductCouponStock{
37			ProductCouponId: wxpay_utility.String("701138812971763025610907319729"),
38			StockId:         wxpay_utility.String("701211100891757235590194161918"),
39		}},
40	}
41
42	response, err := CreateMembershipActivity(config, request)
43	if err != nil {
44		fmt.Printf("请求失败: %+v\n", err)
45		// TODO: 请求失败，根据状态码执行不同的处理
46		return
47	}
48
49	// TODO: 请求成功，继续业务逻辑
50	fmt.Printf("请求成功: %+v\n", response)
51}
52
53func CreateMembershipActivity(config *wxpay_utility.MchConfig, request *CreateMembershipActivityRequest) (response *MembershipActivity, err error) {
54	const (
55		host   = "https://api.mch.weixin.qq.com"
56		method = "POST"
57		path   = "/v3/brand/partner/card-member/membership-activities"
58	)
59
60	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
61	if err != nil {
62		return nil, err
63	}
64	reqBody, err := json.Marshal(request)
65	if err != nil {
66		return nil, err
67	}
68	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
69	if err != nil {
70		return nil, err
71	}
72	httpRequest.Header.Set("Accept", "application/json")
73	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
74	httpRequest.Header.Set("Content-Type", "application/json")
75	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
76	if err != nil {
77		return nil, err
78	}
79	httpRequest.Header.Set("Authorization", authorization)
80
81	client := &http.Client{}
82	httpResponse, err := client.Do(httpRequest)
83	if err != nil {
84		return nil, err
85	}
86	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
87	if err != nil {
88		return nil, err
89	}
90	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
91		// 2XX 成功，验证应答签名
92		err = wxpay_utility.ValidateResponse(
93			config.WechatPayPublicKeyId(),
94			config.WechatPayPublicKey(),
95			&httpResponse.Header,
96			respBody,
97		)
98		if err != nil {
99			return nil, err
100		}
101		response := &MembershipActivity{}
102		if err := json.Unmarshal(respBody, response); err != nil {
103			return nil, err
104		}
105
106		return response, nil
107	} else {
108		return nil, wxpay_utility.NewApiException(
109			httpResponse.StatusCode,
110			httpResponse.Header,
111			respBody,
112		)
113	}
114}
115
116type CreateMembershipActivityRequest struct {
117	OutRequestNo           *string                    `json:"out_request_no,omitempty"`
118	BrandId                *string                    `json:"brand_id,omitempty"`
119	CardId                 *string                    `json:"card_id,omitempty"`
120	ActivityChannel        *MembershipActivityChannel `json:"activity_channel,omitempty"`
121	Title                  *string                    `json:"title,omitempty"`
122	SubTitle               *string                    `json:"sub_title,omitempty"`
123	BeginTime              *string                    `json:"begin_time,omitempty"`
124	EndTime                *string                    `json:"end_time,omitempty"`
125	ApplyTotal             *int64                     `json:"apply_total,omitempty"`
126	ProductCouponStockList []ProductCouponStock       `json:"product_coupon_stock_list,omitempty"`
127}
128
129type MembershipActivity struct {
130	OutRequestNo           *string                      `json:"out_request_no,omitempty"`
131	BrandId                *string                      `json:"brand_id,omitempty"`
132	CardId                 *string                      `json:"card_id,omitempty"`
133	ActivityChannel        *MembershipActivityChannel   `json:"activity_channel,omitempty"`
134	Title                  *string                      `json:"title,omitempty"`
135	SubTitle               *string                      `json:"sub_title,omitempty"`
136	BeginTime              *string                      `json:"begin_time,omitempty"`
137	EndTime                *string                      `json:"end_time,omitempty"`
138	ApplyTotal             *int64                       `json:"apply_total,omitempty"`
139	ApplyAvailable         *int64                       `json:"apply_available,omitempty"`
140	ProductCouponStockList []ProductCouponStock         `json:"product_coupon_stock_list,omitempty"`
141	ActivityId             *int64                       `json:"activity_id,omitempty"`
142	ActivityState          *MembershipGiftActivityState `json:"activity_state,omitempty"`
143	CreateTime             *string                      `json:"create_time,omitempty"`
144	ModifyTime             *string                      `json:"modify_time,omitempty"`
145}
146
147type MembershipActivityChannel string
148
149func (e MembershipActivityChannel) Ptr() *MembershipActivityChannel {
150	return &e
151}
152
153const (
154	MEMBERSHIPACTIVITYCHANNEL_MECHANT_APP_COMPONENT MembershipActivityChannel = "MECHANT_APP_COMPONENT"
155)
156
157type ProductCouponStock struct {
158	ProductCouponId *string `json:"product_coupon_id,omitempty"`
159	StockId         *string `json:"stock_id,omitempty"`
160}
161
162type MembershipGiftActivityState string
163
164func (e MembershipGiftActivityState) Ptr() *MembershipGiftActivityState {
165	return &e
166}
167
168const (
169	MEMBERSHIPGIFTACTIVITYSTATE_MEMBERSHIP_ACTIVITY_CREATED    MembershipGiftActivityState = "MEMBERSHIP_ACTIVITY_CREATED"
170	MEMBERSHIPGIFTACTIVITYSTATE_MEMBERSHIP_ACTIVITY_EFFECTIVE  MembershipGiftActivityState = "MEMBERSHIP_ACTIVITY_EFFECTIVE"
171	MEMBERSHIPGIFTACTIVITYSTATE_MEMBERSHIP_ACTIVITY_TERMINATED MembershipGiftActivityState = "MEMBERSHIP_ACTIVITY_TERMINATED"
172	MEMBERSHIPGIFTACTIVITYSTATE_MEMBERSHIP_ACTIVITY_EXPIRED    MembershipGiftActivityState = "MEMBERSHIP_ACTIVITY_EXPIRED"
173)
174