创建会员卡模板

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/brand/partner/card-member/cards \
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    "appid" : "wxea9c30890f48d5ae",
10    "card_type" : "NORMAL",
11    "card_title" : "测试卡",
12    "card_color" : "#FFFF00",
13    "card_picture_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0",
14    "code_mode" : "SYSTEM_ALLOCATE",
15    "code_type" : "BAR_CODE",
16    "code_jump_information" : {
17      "jump_appid" : "wxea9c30a90fs8d3fe",
18      "jump_path" : "/pages/code/code"
19    },
20    "benefits" : "会员折扣、专属价",
21    "notify_url" : "https://www.weixin.qq.com/wxpay/notify.php",
22    "need_pinned" : true,
23    "need_display_level" : true,
24    "init_level" : "白银会员",
25    "service_phone" : "010-8877xxxx",
26    "legal_agreement" : "商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。",
27    "valid_date_information" : {
28      "type" : "PERMANENT",
29      "available_begin_time" : "2020-05-20T13:29:35.120+08:00",
30      "available_end_time" : "2020-05-20T13:29:35.120+08:00",
31      "available_day_after_receive" : 30
32    },
33    "member_information" : {
34      "jump_appid" : "wxea9c30a90fs8d3fe",
35      "jump_path" : "/pages/points/points"
36    },
37    "points_information" : {
38      "jump_appid" : "wxea9c30a90fs8d3fe",
39      "jump_path" : "/pages/points/points"
40    },
41    "balance_information" : {
42      "jump_appid" : "wxea9c30a90fs8d3fe",
43      "jump_path" : "/pages/balance/balance"
44    },
45    "purchase_information" : {
46      "price" : 100,
47      "jump_appid" : "wxea9c30a90fs8d3fe",
48      "jump_path" : "/pages/purchase/purchase"
49    },
50    "user_information" : {
51      "common_field_list" : [
52        "USER_FORM_FLAG_SEX"
53      ],
54      "custom_field_list" : [
55        {
56          "type" : "CHECK_BOX",
57          "name" : "喜欢的运动",
58          "values" : [
59            "篮球"
60          ]
61        }
62      ]
63    }
64  }'
65

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 CreateCard {
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/cards";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    CreateCard client = new CreateCard(
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    CreateCardRequest request = new CreateCardRequest();
41    request.outRequestNo = "100002322019090134234sfdf";
42    request.brandId = "1004";
43    request.appid = "wxea9c30890f48d5ae";
44    request.cardType = CardType.NORMAL;
45    request.cardTitle = "测试卡";
46    request.cardColor = "#FFFF00";
47    request.cardPictureUrl = "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0";
48    request.codeMode = CodeMode.SYSTEM_ALLOCATE;
49    request.codeType = CodeType.BAR_CODE;
50    request.codeJumpInformation = new CodeJumpInfo();
51    request.codeJumpInformation.jumpAppid = "wxea9c30a90fs8d3fe";
52    request.codeJumpInformation.jumpPath = "/pages/code/code";
53    request.benefits = "会员折扣、专属价";
54    request.notifyUrl = "https://www.weixin.qq.com/wxpay/notify.php";
55    request.needPinned = true;
56    request.needDisplayLevel = true;
57    request.initLevel = "白银会员";
58    request.servicePhone = "010-8877xxxx";
59    request.legalAgreement = "商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。";
60    request.validDateInformation = new DateInfo();
61    request.validDateInformation.type = DateType.PERMANENT;
62    request.validDateInformation.availableBeginTime = "2020-05-20T13:29:35.120+08:00";
63    request.validDateInformation.availableEndTime = "2020-05-20T13:29:35.120+08:00";
64    request.validDateInformation.availableDayAfterReceive = 30L;
65    request.memberInformation = new MemberInfo();
66    request.memberInformation.jumpAppid = "wxea9c30a90fs8d3fe";
67    request.memberInformation.jumpPath = "/pages/points/points";
68    request.pointsInformation = new PointsInfo();
69    request.pointsInformation.jumpAppid = "wxea9c30a90fs8d3fe";
70    request.pointsInformation.jumpPath = "/pages/points/points";
71    request.balanceInformation = new BalanceInfo();
72    request.balanceInformation.jumpAppid = "wxea9c30a90fs8d3fe";
73    request.balanceInformation.jumpPath = "/pages/balance/balance";
74    request.purchaseInformation = new PurchaseInfo();
75    request.purchaseInformation.price = 100L;
76    request.purchaseInformation.jumpAppid = "wxea9c30a90fs8d3fe";
77    request.purchaseInformation.jumpPath = "/pages/purchase/purchase";
78    request.userInformation = new UserInfoForm();
79    request.userInformation.commonFieldList = new ArrayList<>();
80    {
81      request.userInformation.commonFieldList.add(CommonFieldFlag.USER_FORM_FLAG_SEX);
82    };
83    request.userInformation.customFieldList = new ArrayList<>();
84    {
85      UserCustomFieldForm customFieldListItem = new UserCustomFieldForm();
86      customFieldListItem.type = CustomFieldType.CHECK_BOX;
87      customFieldListItem.name = "喜欢的运动";
88      customFieldListItem.values = new ArrayList<>();
89      {
90        customFieldListItem.values.add("篮球");
91      };
92      request.userInformation.customFieldList.add(customFieldListItem);
93    };
94    try {
95      Card response = client.run(request);
96        // TODO: 请求成功，继续业务逻辑
97        System.out.println(response);
98    } catch (WXPayUtility.ApiException e) {
99        // TODO: 请求失败，根据状态码执行不同的逻辑
100        e.printStackTrace();
101    }
102  }
103
104  public Card run(CreateCardRequest request) {
105    String uri = PATH;
106    String reqBody = WXPayUtility.toJson(request);
107
108    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
109    reqBuilder.addHeader("Accept", "application/json");
110    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
111    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
112    reqBuilder.addHeader("Content-Type", "application/json");
113    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
114    reqBuilder.method(METHOD, requestBody);
115    Request httpRequest = reqBuilder.build();
116
117    // 发送HTTP请求
118    OkHttpClient client = new OkHttpClient.Builder().build();
119    try (Response httpResponse = client.newCall(httpRequest).execute()) {
120      String respBody = WXPayUtility.extractBody(httpResponse);
121      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
122        // 2XX 成功，验证应答签名
123        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
124            httpResponse.headers(), respBody);
125
126        // 从HTTP应答报文构建返回数据
127        return WXPayUtility.fromJson(respBody, Card.class);
128      } else {
129        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
130      }
131    } catch (IOException e) {
132      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
133    }
134  }
135
136  private final String mchid;
137  private final String certificateSerialNo;
138  private final PrivateKey privateKey;
139  private final String wechatPayPublicKeyId;
140  private final PublicKey wechatPayPublicKey;
141
142  public CreateCard(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
143    this.mchid = mchid;
144    this.certificateSerialNo = certificateSerialNo;
145    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
146    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
147    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
148  }
149
150  public static class CreateCardRequest {
151    @SerializedName("out_request_no")
152    public String outRequestNo;
153  
154    @SerializedName("brand_id")
155    public String brandId;
156  
157    @SerializedName("appid")
158    public String appid;
159  
160    @SerializedName("card_type")
161    public CardType cardType;
162  
163    @SerializedName("card_title")
164    public String cardTitle;
165  
166    @SerializedName("card_color")
167    public String cardColor;
168  
169    @SerializedName("card_picture_url")
170    public String cardPictureUrl;
171  
172    @SerializedName("code_mode")
173    public CodeMode codeMode;
174  
175    @SerializedName("code_type")
176    public CodeType codeType;
177  
178    @SerializedName("code_jump_information")
179    public CodeJumpInfo codeJumpInformation;
180  
181    @SerializedName("benefits")
182    public String benefits;
183  
184    @SerializedName("notify_url")
185    public String notifyUrl;
186  
187    @SerializedName("need_pinned")
188    public Boolean needPinned;
189  
190    @SerializedName("need_display_level")
191    public Boolean needDisplayLevel;
192  
193    @SerializedName("init_level")
194    public String initLevel;
195  
196    @SerializedName("service_phone")
197    public String servicePhone;
198  
199    @SerializedName("legal_agreement")
200    public String legalAgreement;
201  
202    @SerializedName("valid_date_information")
203    public DateInfo validDateInformation;
204  
205    @SerializedName("member_information")
206    public MemberInfo memberInformation;
207  
208    @SerializedName("points_information")
209    public PointsInfo pointsInformation;
210  
211    @SerializedName("balance_information")
212    public BalanceInfo balanceInformation;
213  
214    @SerializedName("purchase_information")
215    public PurchaseInfo purchaseInformation;
216  
217    @SerializedName("user_information")
218    public UserInfoForm userInformation;
219  }
220  
221  public static class Card {
222    @SerializedName("out_request_no")
223    public String outRequestNo;
224  
225    @SerializedName("card_id")
226    public String cardId;
227  
228    @SerializedName("brand_id")
229    public String brandId;
230  
231    @SerializedName("appid")
232    public String appid;
233  
234    @SerializedName("card_type")
235    public CardType cardType;
236  
237    @SerializedName("card_title")
238    public String cardTitle;
239  
240    @SerializedName("card_color")
241    public String cardColor;
242  
243    @SerializedName("card_picture_url")
244    public String cardPictureUrl;
245  
246    @SerializedName("code_mode")
247    public CodeMode codeMode;
248  
249    @SerializedName("code_type")
250    public CodeType codeType;
251  
252    @SerializedName("code_jump_information")
253    public CodeJumpInfo codeJumpInformation;
254  
255    @SerializedName("benefits")
256    public String benefits;
257  
258    @SerializedName("notify_url")
259    public String notifyUrl;
260  
261    @SerializedName("need_pinned")
262    public Boolean needPinned;
263  
264    @SerializedName("need_display_level")
265    public Boolean needDisplayLevel;
266  
267    @SerializedName("init_level")
268    public String initLevel;
269  
270    @SerializedName("service_phone")
271    public String servicePhone;
272  
273    @SerializedName("legal_agreement")
274    public String legalAgreement;
275  
276    @SerializedName("valid_date_information")
277    public DateInfo validDateInformation;
278  
279    @SerializedName("member_information")
280    public MemberInfo memberInformation;
281  
282    @SerializedName("points_information")
283    public PointsInfo pointsInformation;
284  
285    @SerializedName("balance_information")
286    public BalanceInfo balanceInformation;
287  
288    @SerializedName("purchase_information")
289    public PurchaseInfo purchaseInformation;
290  
291    @SerializedName("user_information")
292    public UserInfoForm userInformation;
293  
294    @SerializedName("state")
295    public CardState state;
296  
297    @SerializedName("create_time")
298    public String createTime;
299  
300    @SerializedName("modify_time")
301    public String modifyTime;
302  }
303  
304  public enum CardType {
305    @SerializedName("PURCHASE")
306    PURCHASE,
307    @SerializedName("NORMAL")
308    NORMAL,
309    @SerializedName("BALANCE")
310    BALANCE
311  }
312  
313  public enum CodeMode {
314    @SerializedName("SYSTEM_ALLOCATE")
315    SYSTEM_ALLOCATE,
316    @SerializedName("MERCHANT_ALLOCATE")
317    MERCHANT_ALLOCATE
318  }
319  
320  public enum CodeType {
321    @SerializedName("NONE_CODE")
322    NONE_CODE,
323    @SerializedName("BAR_CODE")
324    BAR_CODE,
325    @SerializedName("QR_CODE")
326    QR_CODE,
327    @SerializedName("BAR_CODE_AND_QR_CODE")
328    BAR_CODE_AND_QR_CODE,
329    @SerializedName("JUMP_MINI_PROGRAM")
330    JUMP_MINI_PROGRAM
331  }
332  
333  public static class CodeJumpInfo {
334    @SerializedName("jump_appid")
335    public String jumpAppid;
336  
337    @SerializedName("jump_path")
338    public String jumpPath;
339  }
340  
341  public static class DateInfo {
342    @SerializedName("type")
343    public DateType type;
344  
345    @SerializedName("available_begin_time")
346    public String availableBeginTime;
347  
348    @SerializedName("available_end_time")
349    public String availableEndTime;
350  
351    @SerializedName("available_day_after_receive")
352    public Long availableDayAfterReceive;
353  }
354  
355  public static class MemberInfo {
356    @SerializedName("jump_appid")
357    public String jumpAppid;
358  
359    @SerializedName("jump_path")
360    public String jumpPath;
361  }
362  
363  public static class PointsInfo {
364    @SerializedName("jump_appid")
365    public String jumpAppid;
366  
367    @SerializedName("jump_path")
368    public String jumpPath;
369  }
370  
371  public static class BalanceInfo {
372    @SerializedName("jump_appid")
373    public String jumpAppid;
374  
375    @SerializedName("jump_path")
376    public String jumpPath;
377  }
378  
379  public static class PurchaseInfo {
380    @SerializedName("price")
381    public Long price;
382  
383    @SerializedName("jump_appid")
384    public String jumpAppid;
385  
386    @SerializedName("jump_path")
387    public String jumpPath;
388  }
389  
390  public static class UserInfoForm {
391    @SerializedName("common_field_list")
392    public List<CommonFieldFlag> commonFieldList;
393  
394    @SerializedName("custom_field_list")
395    public List<UserCustomFieldForm> customFieldList;
396  }
397  
398  public enum CardState {
399    @SerializedName("CARD_EFFECTIVE")
400    CARD_EFFECTIVE,
401    @SerializedName("CARD_INVALID")
402    CARD_INVALID
403  }
404  
405  public enum DateType {
406    @SerializedName("FIX_TIME_RANGE")
407    FIX_TIME_RANGE,
408    @SerializedName("FIX_TERM")
409    FIX_TERM,
410    @SerializedName("PERMANENT")
411    PERMANENT
412  }
413  
414  public enum CommonFieldFlag {
415    @SerializedName("USER_FORM_FLAG_SEX")
416    USER_FORM_FLAG_SEX,
417    @SerializedName("USER_FORM_FLAG_NAME")
418    USER_FORM_FLAG_NAME,
419    @SerializedName("USER_FORM_FLAG_BIRTHDAY")
420    USER_FORM_FLAG_BIRTHDAY,
421    @SerializedName("USER_FORM_FLAG_ADDRESS")
422    USER_FORM_FLAG_ADDRESS,
423    @SerializedName("USER_FORM_FLAG_EMAIL")
424    USER_FORM_FLAG_EMAIL,
425    @SerializedName("USER_FORM_FLAG_CITY")
426    USER_FORM_FLAG_CITY
427  }
428  
429  public static class UserCustomFieldForm {
430    @SerializedName("type")
431    public CustomFieldType type;
432  
433    @SerializedName("name")
434    public String name;
435  
436    @SerializedName("values")
437    public List<String> values;
438  }
439  
440  public enum CustomFieldType {
441    @SerializedName("CHECK_BOX")
442    CHECK_BOX,
443    @SerializedName("RADIO")
444    RADIO
445  }
446  
447}
448

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 := &CreateCardRequest{
27		OutRequestNo:   wxpay_utility.String("100002322019090134234sfdf"),
28		BrandId:        wxpay_utility.String("1004"),
29		Appid:          wxpay_utility.String("wxea9c30890f48d5ae"),
30		CardType:       CARDTYPE_NORMAL.Ptr(),
31		CardTitle:      wxpay_utility.String("测试卡"),
32		CardColor:      wxpay_utility.String("#FFFF00"),
33		CardPictureUrl: wxpay_utility.String("https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/0"),
34		CodeMode:       CODEMODE_SYSTEM_ALLOCATE.Ptr(),
35		CodeType:       CODETYPE_BAR_CODE.Ptr(),
36		CodeJumpInformation: &CodeJumpInfo{
37			JumpAppid: wxpay_utility.String("wxea9c30a90fs8d3fe"),
38			JumpPath:  wxpay_utility.String("/pages/code/code"),
39		},
40		Benefits:         wxpay_utility.String("会员折扣、专属价"),
41		NotifyUrl:        wxpay_utility.String("https://www.weixin.qq.com/wxpay/notify.php"),
42		NeedPinned:       wxpay_utility.Bool(true),
43		NeedDisplayLevel: wxpay_utility.Bool(true),
44		InitLevel:        wxpay_utility.String("白银会员"),
45		ServicePhone:     wxpay_utility.String("010-8877xxxx"),
46		LegalAgreement:   wxpay_utility.String("商家需在 48 小时内发货，若商品存在质量问题，用户可在 7 天内申请退货。"),
47		ValidDateInformation: &DateInfo{
48			Type:                     DATETYPE_PERMANENT.Ptr(),
49			AvailableBeginTime:       wxpay_utility.String("2020-05-20T13:29:35.120+08:00"),
50			AvailableEndTime:         wxpay_utility.String("2020-05-20T13:29:35.120+08:00"),
51			AvailableDayAfterReceive: wxpay_utility.Int64(30),
52		},
53		MemberInformation: &MemberInfo{
54			JumpAppid: wxpay_utility.String("wxea9c30a90fs8d3fe"),
55			JumpPath:  wxpay_utility.String("/pages/points/points"),
56		},
57		PointsInformation: &PointsInfo{
58			JumpAppid: wxpay_utility.String("wxea9c30a90fs8d3fe"),
59			JumpPath:  wxpay_utility.String("/pages/points/points"),
60		},
61		BalanceInformation: &BalanceInfo{
62			JumpAppid: wxpay_utility.String("wxea9c30a90fs8d3fe"),
63			JumpPath:  wxpay_utility.String("/pages/balance/balance"),
64		},
65		PurchaseInformation: &PurchaseInfo{
66			Price:     wxpay_utility.Int64(100),
67			JumpAppid: wxpay_utility.String("wxea9c30a90fs8d3fe"),
68			JumpPath:  wxpay_utility.String("/pages/purchase/purchase"),
69		},
70		UserInformation: &UserInfoForm{
71			CommonFieldList: []CommonFieldFlag{COMMONFIELDFLAG_USER_FORM_FLAG_SEX},
72			CustomFieldList: []UserCustomFieldForm{UserCustomFieldForm{
73				Type:   CUSTOMFIELDTYPE_CHECK_BOX.Ptr(),
74				Name:   wxpay_utility.String("喜欢的运动"),
75				Values: []string{"篮球"},
76			}},
77		},
78	}
79
80	response, err := CreateCard(config, request)
81	if err != nil {
82		fmt.Printf("请求失败: %+v\n", err)
83		// TODO: 请求失败，根据状态码执行不同的处理
84		return
85	}
86
87	// TODO: 请求成功，继续业务逻辑
88	fmt.Printf("请求成功: %+v\n", response)
89}
90
91func CreateCard(config *wxpay_utility.MchConfig, request *CreateCardRequest) (response *Card, err error) {
92	const (
93		host   = "https://api.mch.weixin.qq.com"
94		method = "POST"
95		path   = "/v3/brand/partner/card-member/cards"
96	)
97
98	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
99	if err != nil {
100		return nil, err
101	}
102	reqBody, err := json.Marshal(request)
103	if err != nil {
104		return nil, err
105	}
106	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
107	if err != nil {
108		return nil, err
109	}
110	httpRequest.Header.Set("Accept", "application/json")
111	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
112	httpRequest.Header.Set("Content-Type", "application/json")
113	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
114	if err != nil {
115		return nil, err
116	}
117	httpRequest.Header.Set("Authorization", authorization)
118
119	client := &http.Client{}
120	httpResponse, err := client.Do(httpRequest)
121	if err != nil {
122		return nil, err
123	}
124	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
125	if err != nil {
126		return nil, err
127	}
128	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
129		// 2XX 成功，验证应答签名
130		err = wxpay_utility.ValidateResponse(
131			config.WechatPayPublicKeyId(),
132			config.WechatPayPublicKey(),
133			&httpResponse.Header,
134			respBody,
135		)
136		if err != nil {
137			return nil, err
138		}
139		response := &Card{}
140		if err := json.Unmarshal(respBody, response); err != nil {
141			return nil, err
142		}
143
144		return response, nil
145	} else {
146		return nil, wxpay_utility.NewApiException(
147			httpResponse.StatusCode,
148			httpResponse.Header,
149			respBody,
150		)
151	}
152}
153
154type CreateCardRequest struct {
155	OutRequestNo         *string       `json:"out_request_no,omitempty"`
156	BrandId              *string       `json:"brand_id,omitempty"`
157	Appid                *string       `json:"appid,omitempty"`
158	CardType             *CardType     `json:"card_type,omitempty"`
159	CardTitle            *string       `json:"card_title,omitempty"`
160	CardColor            *string       `json:"card_color,omitempty"`
161	CardPictureUrl       *string       `json:"card_picture_url,omitempty"`
162	CodeMode             *CodeMode     `json:"code_mode,omitempty"`
163	CodeType             *CodeType     `json:"code_type,omitempty"`
164	CodeJumpInformation  *CodeJumpInfo `json:"code_jump_information,omitempty"`
165	Benefits             *string       `json:"benefits,omitempty"`
166	NotifyUrl            *string       `json:"notify_url,omitempty"`
167	NeedPinned           *bool         `json:"need_pinned,omitempty"`
168	NeedDisplayLevel     *bool         `json:"need_display_level,omitempty"`
169	InitLevel            *string       `json:"init_level,omitempty"`
170	ServicePhone         *string       `json:"service_phone,omitempty"`
171	LegalAgreement       *string       `json:"legal_agreement,omitempty"`
172	ValidDateInformation *DateInfo     `json:"valid_date_information,omitempty"`
173	MemberInformation    *MemberInfo   `json:"member_information,omitempty"`
174	PointsInformation    *PointsInfo   `json:"points_information,omitempty"`
175	BalanceInformation   *BalanceInfo  `json:"balance_information,omitempty"`
176	PurchaseInformation  *PurchaseInfo `json:"purchase_information,omitempty"`
177	UserInformation      *UserInfoForm `json:"user_information,omitempty"`
178}
179
180type Card struct {
181	OutRequestNo         *string       `json:"out_request_no,omitempty"`
182	CardId               *string       `json:"card_id,omitempty"`
183	BrandId              *string       `json:"brand_id,omitempty"`
184	Appid                *string       `json:"appid,omitempty"`
185	CardType             *CardType     `json:"card_type,omitempty"`
186	CardTitle            *string       `json:"card_title,omitempty"`
187	CardColor            *string       `json:"card_color,omitempty"`
188	CardPictureUrl       *string       `json:"card_picture_url,omitempty"`
189	CodeMode             *CodeMode     `json:"code_mode,omitempty"`
190	CodeType             *CodeType     `json:"code_type,omitempty"`
191	CodeJumpInformation  *CodeJumpInfo `json:"code_jump_information,omitempty"`
192	Benefits             *string       `json:"benefits,omitempty"`
193	NotifyUrl            *string       `json:"notify_url,omitempty"`
194	NeedPinned           *bool         `json:"need_pinned,omitempty"`
195	NeedDisplayLevel     *bool         `json:"need_display_level,omitempty"`
196	InitLevel            *string       `json:"init_level,omitempty"`
197	ServicePhone         *string       `json:"service_phone,omitempty"`
198	LegalAgreement       *string       `json:"legal_agreement,omitempty"`
199	ValidDateInformation *DateInfo     `json:"valid_date_information,omitempty"`
200	MemberInformation    *MemberInfo   `json:"member_information,omitempty"`
201	PointsInformation    *PointsInfo   `json:"points_information,omitempty"`
202	BalanceInformation   *BalanceInfo  `json:"balance_information,omitempty"`
203	PurchaseInformation  *PurchaseInfo `json:"purchase_information,omitempty"`
204	UserInformation      *UserInfoForm `json:"user_information,omitempty"`
205	State                *CardState    `json:"state,omitempty"`
206	CreateTime           *string       `json:"create_time,omitempty"`
207	ModifyTime           *string       `json:"modify_time,omitempty"`
208}
209
210type CardType string
211
212func (e CardType) Ptr() *CardType {
213	return &e
214}
215
216const (
217	CARDTYPE_PURCHASE CardType = "PURCHASE"
218	CARDTYPE_NORMAL   CardType = "NORMAL"
219	CARDTYPE_BALANCE  CardType = "BALANCE"
220)
221
222type CodeMode string
223
224func (e CodeMode) Ptr() *CodeMode {
225	return &e
226}
227
228const (
229	CODEMODE_SYSTEM_ALLOCATE   CodeMode = "SYSTEM_ALLOCATE"
230	CODEMODE_MERCHANT_ALLOCATE CodeMode = "MERCHANT_ALLOCATE"
231)
232
233type CodeType string
234
235func (e CodeType) Ptr() *CodeType {
236	return &e
237}
238
239const (
240	CODETYPE_NONE_CODE            CodeType = "NONE_CODE"
241	CODETYPE_BAR_CODE             CodeType = "BAR_CODE"
242	CODETYPE_QR_CODE              CodeType = "QR_CODE"
243	CODETYPE_BAR_CODE_AND_QR_CODE CodeType = "BAR_CODE_AND_QR_CODE"
244	CODETYPE_JUMP_MINI_PROGRAM    CodeType = "JUMP_MINI_PROGRAM"
245)
246
247type CodeJumpInfo struct {
248	JumpAppid *string `json:"jump_appid,omitempty"`
249	JumpPath  *string `json:"jump_path,omitempty"`
250}
251
252type DateInfo struct {
253	Type                     *DateType `json:"type,omitempty"`
254	AvailableBeginTime       *string   `json:"available_begin_time,omitempty"`
255	AvailableEndTime         *string   `json:"available_end_time,omitempty"`
256	AvailableDayAfterReceive *int64    `json:"available_day_after_receive,omitempty"`
257}
258
259type MemberInfo struct {
260	JumpAppid *string `json:"jump_appid,omitempty"`
261	JumpPath  *string `json:"jump_path,omitempty"`
262}
263
264type PointsInfo struct {
265	JumpAppid *string `json:"jump_appid,omitempty"`
266	JumpPath  *string `json:"jump_path,omitempty"`
267}
268
269type BalanceInfo struct {
270	JumpAppid *string `json:"jump_appid,omitempty"`
271	JumpPath  *string `json:"jump_path,omitempty"`
272}
273
274type PurchaseInfo struct {
275	Price     *int64  `json:"price,omitempty"`
276	JumpAppid *string `json:"jump_appid,omitempty"`
277	JumpPath  *string `json:"jump_path,omitempty"`
278}
279
280type UserInfoForm struct {
281	CommonFieldList []CommonFieldFlag     `json:"common_field_list,omitempty"`
282	CustomFieldList []UserCustomFieldForm `json:"custom_field_list,omitempty"`
283}
284
285type CardState string
286
287func (e CardState) Ptr() *CardState {
288	return &e
289}
290
291const (
292	CARDSTATE_CARD_EFFECTIVE CardState = "CARD_EFFECTIVE"
293	CARDSTATE_CARD_INVALID   CardState = "CARD_INVALID"
294)
295
296type DateType string
297
298func (e DateType) Ptr() *DateType {
299	return &e
300}
301
302const (
303	DATETYPE_FIX_TIME_RANGE DateType = "FIX_TIME_RANGE"
304	DATETYPE_FIX_TERM       DateType = "FIX_TERM"
305	DATETYPE_PERMANENT      DateType = "PERMANENT"
306)
307
308type CommonFieldFlag string
309
310func (e CommonFieldFlag) Ptr() *CommonFieldFlag {
311	return &e
312}
313
314const (
315	COMMONFIELDFLAG_USER_FORM_FLAG_SEX      CommonFieldFlag = "USER_FORM_FLAG_SEX"
316	COMMONFIELDFLAG_USER_FORM_FLAG_NAME     CommonFieldFlag = "USER_FORM_FLAG_NAME"
317	COMMONFIELDFLAG_USER_FORM_FLAG_BIRTHDAY CommonFieldFlag = "USER_FORM_FLAG_BIRTHDAY"
318	COMMONFIELDFLAG_USER_FORM_FLAG_ADDRESS  CommonFieldFlag = "USER_FORM_FLAG_ADDRESS"
319	COMMONFIELDFLAG_USER_FORM_FLAG_EMAIL    CommonFieldFlag = "USER_FORM_FLAG_EMAIL"
320	COMMONFIELDFLAG_USER_FORM_FLAG_CITY     CommonFieldFlag = "USER_FORM_FLAG_CITY"
321)
322
323type UserCustomFieldForm struct {
324	Type   *CustomFieldType `json:"type,omitempty"`
325	Name   *string          `json:"name,omitempty"`
326	Values []string         `json:"values,omitempty"`
327}
328
329type CustomFieldType string
330
331func (e CustomFieldType) Ptr() *CustomFieldType {
332	return &e
333}
334
335const (
336	CUSTOMFIELDTYPE_CHECK_BOX CustomFieldType = "CHECK_BOX"
337	CUSTOMFIELDTYPE_RADIO     CustomFieldType = "RADIO"
338)
339