申请公益捐赠预算

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 CreateBudget {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/v3/fund-app/mch-transfer/partner/charity-budget";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    CreateBudget client = new CreateBudget(
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    CreateBudgetRequest request = new CreateBudgetRequest();
41    request.outBudgetNo = "budget202506300102";
42    request.sponsorMchid = "1900001109";
43    request.sponsorSubjectName = "腾讯控股有限公司";
44    request.activityName = "公益企业配捐活动";
45    request.activityRemark = "公益活动开始于9月1日，帮助困难儿童筹款活动";
46    request.amount = 20000000L;
47    request.notifyUrl = "https://www.weixin.qq.com/wxpay/pay.php";
48    try {
49      BudgetInfo response = client.run(request);
50
51      // TODO: 请求成功，继续业务逻辑
52      System.out.println(response);
53    } catch (WXPayUtility.ApiException e) {
54      // TODO: 请求失败，根据状态码执行不同的逻辑
55      e.printStackTrace();
56    }
57  }
58
59  public BudgetInfo run(CreateBudgetRequest request) {
60    String uri = PATH;
61    String reqBody = WXPayUtility.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", WXPayUtility.buildAuthorization(mchid, 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 = WXPayUtility.extractBody(httpResponse);
76      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
77        // 2XX 成功，验证应答签名
78        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
79            httpResponse.headers(), respBody);
80
81        // 从HTTP应答报文构建返回数据
82        return WXPayUtility.fromJson(respBody, BudgetInfo.class);
83      } else {
84        throw new WXPayUtility.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 mchid;
92  private final String certificateSerialNo;
93  private final PrivateKey privateKey;
94  private final String wechatPayPublicKeyId;
95  private final PublicKey wechatPayPublicKey;
96
97  public CreateBudget(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
98    this.mchid = mchid;
99    this.certificateSerialNo = certificateSerialNo;
100    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
101    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
102    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
103  }
104
105  public static class CreateBudgetRequest {
106    @SerializedName("out_budget_no")
107    public String outBudgetNo;
108  
109    @SerializedName("sponsor_mchid")
110    public String sponsorMchid;
111  
112    @SerializedName("sponsor_subject_name")
113    public String sponsorSubjectName;
114  
115    @SerializedName("activity_name")
116    public String activityName;
117  
118    @SerializedName("activity_remark")
119    public String activityRemark;
120  
121    @SerializedName("amount")
122    public Long amount;
123  
124    @SerializedName("notify_url")
125    public String notifyUrl;
126  }
127  
128  public static class BudgetInfo {
129    @SerializedName("sp_mchid")
130    public String spMchid;
131  
132    @SerializedName("out_budget_no")
133    public String outBudgetNo;
134  
135    @SerializedName("budget_id")
136    public String budgetId;
137  
138    @SerializedName("amount")
139    public Long amount;
140  
141    @SerializedName("sponsor_mchid")
142    public String sponsorMchid;
143  
144    @SerializedName("activity_name")
145    public String activityName;
146  
147    @SerializedName("activity_remark")
148    public String activityRemark;
149  
150    @SerializedName("state")
151    public BudgetOrderState state;
152  
153    @SerializedName("confirm_url")
154    public String confirmUrl;
155  
156    @SerializedName("super_admin_wxid_mask")
157    public String superAdminWxidMask;
158  
159    @SerializedName("remain_amount")
160    public Long remainAmount;
161  
162    @SerializedName("unlock_remark")
163    public String unlockRemark;
164  
165    @SerializedName("locked_time")
166    public String lockedTime;
167  
168    @SerializedName("finished_time")
169    public String finishedTime;
170  
171    @SerializedName("closed_time")
172    public String closedTime;
173  }
174  
175  public enum BudgetOrderState {
176    @SerializedName("PENDING")
177    PENDING,
178    @SerializedName("LOCKED")
179    LOCKED,
180    @SerializedName("FINISHED")
181    FINISHED,
182    @SerializedName("CLOSED")
183    CLOSED
184  }
185  
186}
187

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 := &CreateBudgetRequest{
27		OutBudgetNo:        wxpay_utility.String("budget202506300102"),
28		SponsorMchid:       wxpay_utility.String("1900001109"),
29		SponsorSubjectName: wxpay_utility.String("腾讯控股有限公司"),
30		ActivityName:       wxpay_utility.String("公益企业配捐活动"),
31		ActivityRemark:     wxpay_utility.String("公益活动开始于9月1日，帮助困难儿童筹款活动"),
32		Amount:             wxpay_utility.Int64(20000000),
33		NotifyUrl:          wxpay_utility.String("https://www.weixin.qq.com/wxpay/pay.php"),
34	}
35
36	response, err := CreateBudget(config, request)
37	if err != nil {
38		fmt.Printf("请求失败: %+v\n", err)
39		// TODO: 请求失败，根据状态码执行不同的处理
40		return
41	}
42
43	// TODO: 请求成功，继续业务逻辑
44	fmt.Printf("请求成功: %+v\n", response)
45}
46
47func CreateBudget(config *wxpay_utility.MchConfig, request *CreateBudgetRequest) (response *BudgetInfo, err error) {
48	const (
49		host   = "https://api.mch.weixin.qq.com"
50		method = "POST"
51		path   = "/v3/fund-app/mch-transfer/partner/charity-budget"
52	)
53
54	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
55	if err != nil {
56		return nil, err
57	}
58	reqBody, err := json.Marshal(request)
59	if err != nil {
60		return nil, err
61	}
62	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
63	if err != nil {
64		return nil, err
65	}
66	httpRequest.Header.Set("Accept", "application/json")
67	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
68	httpRequest.Header.Set("Content-Type", "application/json")
69	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
70	if err != nil {
71		return nil, err
72	}
73	httpRequest.Header.Set("Authorization", authorization)
74
75	client := &http.Client{}
76	httpResponse, err := client.Do(httpRequest)
77	if err != nil {
78		return nil, err
79	}
80
81	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
82	if err != nil {
83		return nil, err
84	}
85
86	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
87		// 2XX 成功，验证应答签名
88		err = wxpay_utility.ValidateResponse(
89			config.WechatPayPublicKeyId(),
90			config.WechatPayPublicKey(),
91			&httpResponse.Header,
92			respBody,
93		)
94		if err != nil {
95			return nil, err
96		}
97
98		if err := json.Unmarshal(respBody, response); err != nil {
99			return nil, err
100		}
101
102		return response, nil
103	} else {
104		return nil, wxpay_utility.NewApiException(
105			httpResponse.StatusCode,
106			httpResponse.Header,
107			respBody,
108		)
109	}
110}
111
112type CreateBudgetRequest struct {
113	OutBudgetNo        *string `json:"out_budget_no,omitempty"`
114	SponsorMchid       *string `json:"sponsor_mchid,omitempty"`
115	SponsorSubjectName *string `json:"sponsor_subject_name,omitempty"`
116	ActivityName       *string `json:"activity_name,omitempty"`
117	ActivityRemark     *string `json:"activity_remark,omitempty"`
118	Amount             *int64  `json:"amount,omitempty"`
119	NotifyUrl          *string `json:"notify_url,omitempty"`
120}
121
122type BudgetInfo struct {
123	SpMchid            *string           `json:"sp_mchid,omitempty"`
124	OutBudgetNo        *string           `json:"out_budget_no,omitempty"`
125	BudgetId           *string           `json:"budget_id,omitempty"`
126	Amount             *int64            `json:"amount,omitempty"`
127	SponsorMchid       *string           `json:"sponsor_mchid,omitempty"`
128	ActivityName       *string           `json:"activity_name,omitempty"`
129	ActivityRemark     *string           `json:"activity_remark,omitempty"`
130	State              *BudgetOrderState `json:"state,omitempty"`
131	ConfirmUrl         *string           `json:"confirm_url,omitempty"`
132	SuperAdminWxidMask *string           `json:"super_admin_wxid_mask,omitempty"`
133	RemainAmount       *int64            `json:"remain_amount,omitempty"`
134	UnlockRemark       *string           `json:"unlock_remark,omitempty"`
135	LockedTime         *string           `json:"locked_time,omitempty"`
136	FinishedTime       *string           `json:"finished_time,omitempty"`
137	ClosedTime         *string           `json:"closed_time,omitempty"`
138}
139
140type BudgetOrderState string
141
142func (e BudgetOrderState) Ptr() *BudgetOrderState {
143	return &e
144}
145
146const (
147	BUDGETORDERSTATE_PENDING  BudgetOrderState = "PENDING"
148	BUDGETORDERSTATE_LOCKED   BudgetOrderState = "LOCKED"
149	BUDGETORDERSTATE_FINISHED BudgetOrderState = "FINISHED"
150	BUDGETORDERSTATE_CLOSED   BudgetOrderState = "CLOSED"
151)
152

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/partner/charity-budget \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_budget_no" : "budget202506300102",
8    "sponsor_mchid" : "1900001109",
9    "sponsor_subject_name" : "腾讯控股有限公司",
10    "activity_name" : "公益企业配捐活动",
11    "activity_remark" : "公益活动开始于9月1日，帮助困难儿童筹款活动",
12    "amount" : 20000000,
13    "notify_url" : "https://www.weixin.qq.com/wxpay/pay.php"
14  }'
15