企业商户为员工下发企业支付额度卡

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 ApplyQuotaCard {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/v3/webizpay/employees/{employee_id}/quota-cards";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    ApplyQuotaCard client = new ApplyQuotaCard(
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    ApplyQuotaCardRequest request = new ApplyQuotaCardRequest();
41    request.employeeId = "WeBizPay_a968402a-73bb-43e2-9e1a-8371b0ca3d7c";
42    request.spMchid = "12341234";
43    request.subMchid = "43214321";
44    request.cardTemplateId = "template_123";
45    request.amount = 10000L;
46    request.cardName = "报销额度卡";
47    request.outCardNo = "out_card_123456";
48    request.effectiveEndTime = "2023-12-31T23:59:59+08:00";
49    request.cardRemark = "2023年1月差旅报销";
50    try {
51      CardsApplyQuotaCardResponse response = client.run(request);
52
53      // TODO: 请求成功，继续业务逻辑
54      System.out.println(response);
55    } catch (WXPayUtility.ApiException e) {
56      // TODO: 请求失败，根据状态码执行不同的逻辑
57      e.printStackTrace();
58    }
59  }
60
61  public CardsApplyQuotaCardResponse run(ApplyQuotaCardRequest request) {
62    String uri = PATH;
63    uri = uri.replace("{employee_id}", WXPayUtility.urlEncode(request.employeeId));
64    String reqBody = WXPayUtility.toJson(request);
65
66    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
67    reqBuilder.addHeader("Accept", "application/json");
68    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
69    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
70    reqBuilder.addHeader("Content-Type", "application/json");
71    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
72    reqBuilder.method(METHOD, requestBody);
73    Request httpRequest = reqBuilder.build();
74
75    // 发送HTTP请求
76    OkHttpClient client = new OkHttpClient.Builder().build();
77    try (Response httpResponse = client.newCall(httpRequest).execute()) {
78      String respBody = WXPayUtility.extractBody(httpResponse);
79      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
80        // 2XX 成功，验证应答签名
81        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
82            httpResponse.headers(), respBody);
83
84        // 从HTTP应答报文构建返回数据
85        return WXPayUtility.fromJson(respBody, CardsApplyQuotaCardResponse.class);
86      } else {
87        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
88      }
89    } catch (IOException e) {
90      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
91    }
92  }
93
94  private final String mchid;
95  private final String certificateSerialNo;
96  private final PrivateKey privateKey;
97  private final String wechatPayPublicKeyId;
98  private final PublicKey wechatPayPublicKey;
99
100  public ApplyQuotaCard(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
101    this.mchid = mchid;
102    this.certificateSerialNo = certificateSerialNo;
103    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
104    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
105    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
106  }
107
108  public static class ApplyQuotaCardRequest {
109    @SerializedName("sp_mchid")
110    public String spMchid;
111  
112    @SerializedName("sub_mchid")
113    public String subMchid;
114  
115    @SerializedName("employee_id")
116    @Expose(serialize = false)
117    public String employeeId;
118  
119    @SerializedName("card_template_id")
120    public String cardTemplateId;
121  
122    @SerializedName("amount")
123    public Long amount;
124  
125    @SerializedName("card_name")
126    public String cardName;
127  
128    @SerializedName("out_card_no")
129    public String outCardNo;
130  
131    @SerializedName("effective_end_time")
132    public String effectiveEndTime;
133  
134    @SerializedName("card_remark")
135    public String cardRemark;
136  }
137  
138  public static class CardsApplyQuotaCardResponse {
139    @SerializedName("sp_mchid")
140    public String spMchid;
141  
142    @SerializedName("sub_mchid")
143    public String subMchid;
144  
145    @SerializedName("out_card_no")
146    public String outCardNo;
147  
148    @SerializedName("employee_id")
149    public String employeeId;
150  
151    @SerializedName("card_no")
152    public String cardNo;
153  
154    @SerializedName("effective_begin_time")
155    public String effectiveBeginTime;
156  
157    @SerializedName("effective_end_time")
158    public String effectiveEndTime;
159  }
160  
161}
162

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 := &ApplyQuotaCardRequest{
29		EmployeeId:       wxpay_utility.String("WeBizPay_a968402a-73bb-43e2-9e1a-8371b0ca3d7c"),
30		SpMchid:          wxpay_utility.String("12341234"),
31		SubMchid:         wxpay_utility.String("43214321"),
32		CardTemplateId:   wxpay_utility.String("template_123"),
33		Amount:           wxpay_utility.Int64(10000),
34		CardName:         wxpay_utility.String("报销额度卡"),
35		OutCardNo:        wxpay_utility.String("out_card_123456"),
36		EffectiveEndTime: wxpay_utility.String("2023-12-31T23:59:59+08:00"),
37		CardRemark:       wxpay_utility.String("2023年1月差旅报销"),
38	}
39
40	response, err := ApplyQuotaCard(config, request)
41	if err != nil {
42		fmt.Printf("请求失败: %+v\n", err)
43		// TODO: 请求失败，根据状态码执行不同的处理
44		return
45	}
46
47	// TODO: 请求成功，继续业务逻辑
48	fmt.Printf("请求成功: %+v\n", response)
49}
50
51func ApplyQuotaCard(config *wxpay_utility.MchConfig, request *ApplyQuotaCardRequest) (response *CardsApplyQuotaCardResponse, err error) {
52	const (
53		host   = "https://api.mch.weixin.qq.com"
54		method = "POST"
55		path   = "/v3/webizpay/employees/{employee_id}/quota-cards"
56	)
57
58	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
59	if err != nil {
60		return nil, err
61	}
62	reqUrl.Path = strings.Replace(reqUrl.Path, "{employee_id}", url.PathEscape(*request.EmployeeId), -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
86	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
87	if err != nil {
88		return nil, err
89	}
90
91	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
92		// 2XX 成功，验证应答签名
93		err = wxpay_utility.ValidateResponse(
94			config.WechatPayPublicKeyId(),
95			config.WechatPayPublicKey(),
96			&httpResponse.Header,
97			respBody,
98		)
99		if err != nil {
100			return nil, err
101		}
102
103		if err := json.Unmarshal(respBody, response); err != nil {
104			return nil, err
105		}
106
107		return response, nil
108	} else {
109		return nil, wxpay_utility.NewApiException(
110			httpResponse.StatusCode,
111			httpResponse.Header,
112			respBody,
113		)
114	}
115}
116
117type ApplyQuotaCardRequest struct {
118	SpMchid          *string `json:"sp_mchid,omitempty"`
119	SubMchid         *string `json:"sub_mchid,omitempty"`
120	EmployeeId       *string `json:"employee_id,omitempty"`
121	CardTemplateId   *string `json:"card_template_id,omitempty"`
122	Amount           *int64  `json:"amount,omitempty"`
123	CardName         *string `json:"card_name,omitempty"`
124	OutCardNo        *string `json:"out_card_no,omitempty"`
125	EffectiveEndTime *string `json:"effective_end_time,omitempty"`
126	CardRemark       *string `json:"card_remark,omitempty"`
127}
128
129func (o *ApplyQuotaCardRequest) MarshalJSON() ([]byte, error) {
130	type Alias ApplyQuotaCardRequest
131	a := &struct {
132		EmployeeId *string `json:"employee_id,omitempty"`
133		*Alias
134	}{
135		// 序列化时移除非 Body 字段
136		EmployeeId: nil,
137		Alias:      (*Alias)(o),
138	}
139	return json.Marshal(a)
140}
141
142type CardsApplyQuotaCardResponse struct {
143	SpMchid            *string    `json:"sp_mchid,omitempty"`
144	SubMchid           *string    `json:"sub_mchid,omitempty"`
145	OutCardNo          *string    `json:"out_card_no,omitempty"`
146	EmployeeId         *string    `json:"employee_id,omitempty"`
147	CardNo             *string    `json:"card_no,omitempty"`
148	EffectiveBeginTime *time.Time `json:"effective_begin_time,omitempty"`
149	EffectiveEndTime   *time.Time `json:"effective_end_time,omitempty"`
150}
151

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/webizpay/employees/WeBizPay_a968402a-73bb-43e2-9e1a-8371b0ca3d7c/quota-cards \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sp_mchid" : "12341234",
8    "sub_mchid" : "43214321",
9    "card_template_id" : "template_123",
10    "amount" : 10000,
11    "card_name" : "报销额度卡",
12    "out_card_no" : "out_card_123456",
13    "effective_end_time" : "2023-12-31T23:59:59+08:00",
14    "card_remark" : "2023年1月差旅报销"
15  }'
16