特殊减额

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/aggracct-bc/wb-channel/special-reduction \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "mchid" : "1900016681",
9    "bal_account_no" : "8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f",
10    "out_request_no" : "htozr8denqegbt6tk6u10iymo7yww5pn",
11    "reduction_type" : "JUDICIAL_DEDUCTION",
12    "amount" : 1,
13    "reason" : "司法案件号：202508080009"
14  }'
15

1package com.java.demo;
2
3import com.java.utils.WXPayUtility; // 引用微信支付工具库，参考：https://pay.weixin.qq.com/doc/v3/merchant/4014931831
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 SpecialReduction {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/v3/aggracct-bc/wb-channel/special-reduction";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/merchant/4013070756
32    SpecialReduction client = new SpecialReduction(
33      "19xxxxxxxx",                    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756
34      "1DDE55AD98Exxxxxxxxxx",         // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053
35      "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
36      "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816
37      "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
38    );
39
40    SpecialReductionRequest request = new SpecialReductionRequest();
41    request.mchid = "1900016681";
42    request.balAccountNo = client.encrypt("bal_account_no");
43    request.outRequestNo = "htozr8denqegbt6tk6u10iymo7yww5pn";
44    request.reductionType = SpecialReductionType.JUDICIAL_DEDUCTION;
45    request.amount = 1L;
46    request.reason = "司法案件号：202508080009";
47    try {
48      SpecialReduction response = client.run(request);
49        // TODO: 请求成功，继续业务逻辑
50        System.out.println(response);
51    } catch (WXPayUtility.ApiException e) {
52        // TODO: 请求失败，根据状态码执行不同的逻辑
53        e.printStackTrace();
54    }
55  }
56
57  public SpecialReduction run(SpecialReductionRequest request) {
58    String uri = PATH;
59    String reqBody = WXPayUtility.toJson(request);
60
61    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
62    reqBuilder.addHeader("Accept", "application/json");
63    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
64    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
65    reqBuilder.addHeader("Content-Type", "application/json");
66    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
67    reqBuilder.method(METHOD, requestBody);
68    Request httpRequest = reqBuilder.build();
69
70    // 发送HTTP请求
71    OkHttpClient client = new OkHttpClient.Builder().build();
72    try (Response httpResponse = client.newCall(httpRequest).execute()) {
73      String respBody = WXPayUtility.extractBody(httpResponse);
74      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
75        // 2XX 成功，验证应答签名
76        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
77            httpResponse.headers(), respBody);
78
79        // 从HTTP应答报文构建返回数据
80        return WXPayUtility.fromJson(respBody, SpecialReduction.class);
81      } else {
82        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
83      }
84    } catch (IOException e) {
85      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
86    }
87  }
88
89  private final String mchid;
90  private final String certificateSerialNo;
91  private final PrivateKey privateKey;
92  private final String wechatPayPublicKeyId;
93  private final PublicKey wechatPayPublicKey;
94
95  public SpecialReduction(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
96    this.mchid = mchid;
97    this.certificateSerialNo = certificateSerialNo;
98    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
99    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
100    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
101  }
102
103  public String encrypt(String plainText) {
104    return WXPayUtility.encrypt(this.wechatPayPublicKey, plainText);
105  }
106
107  public static class SpecialReductionRequest {
108    @SerializedName("mchid")
109    public String mchid;
110  
111    @SerializedName("bal_account_no")
112    public String balAccountNo;
113  
114    @SerializedName("out_request_no")
115    public String outRequestNo;
116  
117    @SerializedName("reduction_type")
118    public SpecialReductionType reductionType;
119  
120    @SerializedName("amount")
121    public Long amount;
122  
123    @SerializedName("reason")
124    public String reason;
125  }
126  
127  public static class SpecialReduction {
128    @SerializedName("out_request_no")
129    public String outRequestNo;
130  
131    @SerializedName("reason")
132    public String reason;
133  
134    @SerializedName("quota_change_no")
135    public String quotaChangeNo;
136  
137    @SerializedName("success_time")
138    public String successTime;
139  }
140  
141  public enum SpecialReductionType {
142    @SerializedName("REDUCTION_TYPE_UNKNOWN")
143    REDUCTION_TYPE_UNKNOWN,
144    @SerializedName("FINANCIAL_PENALTY")
145    FINANCIAL_PENALTY,
146    @SerializedName("JUDICIAL_DEDUCTION")
147    JUDICIAL_DEDUCTION
148  }
149  
150}
151

1package main
2
3import (
4	"bytes"
5	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/merchant/4015119334
6	"encoding/json"
7	"fmt"
8	"net/http"
9	"net/url"
10)
11
12func main() {
13	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/merchant/4013070756
14	config, err := wxpay_utility.CreateMchConfig(
15		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756
16		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053
17		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
18		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816
19		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
20	)
21	if err != nil {
22		fmt.Println(err)
23		return
24	}
25
26	request := &SpecialReductionRequest{
27		Mchid:         wxpay_utility.String("1900016681"),
28		BalAccountNo:  wxpay_utility.String("8609cb22e1774a50a930e414cc71eca06121bcd266335cda230d24a7886a8d9f"), /*请传入wxpay_utility.EncryptOAEPWithPublicKey 加密结果*/
29		OutRequestNo:  wxpay_utility.String("htozr8denqegbt6tk6u10iymo7yww5pn"),
30		ReductionType: SPECIALREDUCTIONTYPE_JUDICIAL_DEDUCTION.Ptr(),
31		Amount:        wxpay_utility.Int64(1),
32		Reason:        wxpay_utility.String("司法案件号：202508080009"),
33	}
34
35	response, err := SpecialReduction(config, request)
36	if err != nil {
37		fmt.Printf("请求失败: %+v\n", err)
38		// TODO: 请求失败，根据状态码执行不同的处理
39		return
40	}
41
42	// TODO: 请求成功，继续业务逻辑
43	fmt.Printf("请求成功: %+v\n", response)
44}
45
46func SpecialReduction(config *wxpay_utility.MchConfig, request *SpecialReductionRequest) (response *SpecialReduction, err error) {
47	const (
48		host   = "https://api.mch.weixin.qq.com"
49		method = "POST"
50		path   = "/v3/aggracct-bc/wb-channel/special-reduction"
51	)
52
53	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
54	if err != nil {
55		return nil, err
56	}
57	reqBody, err := json.Marshal(request)
58	if err != nil {
59		return nil, err
60	}
61	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
62	if err != nil {
63		return nil, err
64	}
65	httpRequest.Header.Set("Accept", "application/json")
66	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
67	httpRequest.Header.Set("Content-Type", "application/json")
68	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
69	if err != nil {
70		return nil, err
71	}
72	httpRequest.Header.Set("Authorization", authorization)
73
74	client := &http.Client{}
75	httpResponse, err := client.Do(httpRequest)
76	if err != nil {
77		return nil, err
78	}
79	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
80	if err != nil {
81		return nil, err
82	}
83	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
84		// 2XX 成功，验证应答签名
85		err = wxpay_utility.ValidateResponse(
86			config.WechatPayPublicKeyId(),
87			config.WechatPayPublicKey(),
88			&httpResponse.Header,
89			respBody,
90		)
91		if err != nil {
92			return nil, err
93		}
94		response := &SpecialReduction{}
95		if err := json.Unmarshal(respBody, response); err != nil {
96			return nil, err
97		}
98
99		return response, nil
100	} else {
101		return nil, wxpay_utility.NewApiException(
102			httpResponse.StatusCode,
103			httpResponse.Header,
104			respBody,
105		)
106	}
107}
108
109type SpecialReductionRequest struct {
110	Mchid         *string               `json:"mchid,omitempty"`
111	BalAccountNo  *string               `json:"bal_account_no,omitempty"`
112	OutRequestNo  *string               `json:"out_request_no,omitempty"`
113	ReductionType *SpecialReductionType `json:"reduction_type,omitempty"`
114	Amount        *int64                `json:"amount,omitempty"`
115	Reason        *string               `json:"reason,omitempty"`
116}
117
118type SpecialReduction struct {
119	OutRequestNo  *string `json:"out_request_no,omitempty"`
120	Reason        *string `json:"reason,omitempty"`
121	QuotaChangeNo *string `json:"quota_change_no,omitempty"`
122	SuccessTime   *string `json:"success_time,omitempty"`
123}
124
125type SpecialReductionType string
126
127func (e SpecialReductionType) Ptr() *SpecialReductionType {
128	return &e
129}
130
131const (
132	SPECIALREDUCTIONTYPE_REDUCTION_TYPE_UNKNOWN SpecialReductionType = "REDUCTION_TYPE_UNKNOWN"
133	SPECIALREDUCTIONTYPE_FINANCIAL_PENALTY      SpecialReductionType = "FINANCIAL_PENALTY"
134	SPECIALREDUCTIONTYPE_JUDICIAL_DEDUCTION     SpecialReductionType = "JUDICIAL_DEDUCTION"
135)
136