请求补差回退

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/subsidies/return \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1900000109",
8    "out_order_no" : "P20150806125346",
9    "transaction_id" : "4208450740201411110007820472",
10    "refund_id" : "3008450740201411110007820472",
11    "amount" : 10,
12    "description" : "测试备注",
13    "subsidy_id" : "3008450740201411110007820472",
14    "from" : [
15      {
16        "account" : "AVAILABLE",
17        "amount" : 10
18      }
19    ]
20  }'
21

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 ReturnSubsidy {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "POST";
28  private static String PATH = "/v3/ecommerce/subsidies/return";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    ReturnSubsidy client = new ReturnSubsidy(
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    SubsidiesReturnRequest request = new SubsidiesReturnRequest();
41    request.subMchid = "1900000109";
42    request.outOrderNo = "P20150806125346";
43    request.transactionId = "4208450740201411110007820472";
44    request.refundId = "3008450740201411110007820472";
45    request.amount = 10L;
46    request.description = "测试备注";
47    request.subsidyId = "3008450740201411110007820472";
48    request.from = new ArrayList<>();
49    {
50      ReturnFrom fromItem = new ReturnFrom();
51      fromItem.account = ReturnAccount.AVAILABLE;
52      fromItem.amount = 10L;
53      request.from.add(fromItem);
54    };
55    try {
56      SubsidiesReturnEntity response = client.run(request);
57        // TODO: 请求成功，继续业务逻辑
58        System.out.println(response);
59    } catch (WXPayUtility.ApiException e) {
60        // TODO: 请求失败，根据状态码执行不同的逻辑
61        e.printStackTrace();
62    }
63  }
64
65  public SubsidiesReturnEntity run(SubsidiesReturnRequest request) {
66    String uri = PATH;
67    String reqBody = WXPayUtility.toJson(request);
68
69    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
70    reqBuilder.addHeader("Accept", "application/json");
71    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
72    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
73    reqBuilder.addHeader("Content-Type", "application/json");
74    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
75    reqBuilder.method(METHOD, requestBody);
76    Request httpRequest = reqBuilder.build();
77
78    // 发送HTTP请求
79    OkHttpClient client = new OkHttpClient.Builder().build();
80    try (Response httpResponse = client.newCall(httpRequest).execute()) {
81      String respBody = WXPayUtility.extractBody(httpResponse);
82      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
83        // 2XX 成功，验证应答签名
84        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
85            httpResponse.headers(), respBody);
86
87        // 从HTTP应答报文构建返回数据
88        return WXPayUtility.fromJson(respBody, SubsidiesReturnEntity.class);
89      } else {
90        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
91      }
92    } catch (IOException e) {
93      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
94    }
95  }
96
97  private final String mchid;
98  private final String certificateSerialNo;
99  private final PrivateKey privateKey;
100  private final String wechatPayPublicKeyId;
101  private final PublicKey wechatPayPublicKey;
102
103  public ReturnSubsidy(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
104    this.mchid = mchid;
105    this.certificateSerialNo = certificateSerialNo;
106    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
107    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
108    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
109  }
110
111  public static class SubsidiesReturnRequest {
112    @SerializedName("sub_mchid")
113    public String subMchid;
114  
115    @SerializedName("out_order_no")
116    public String outOrderNo;
117  
118    @SerializedName("transaction_id")
119    public String transactionId;
120  
121    @SerializedName("refund_id")
122    public String refundId;
123  
124    @SerializedName("amount")
125    public Long amount;
126  
127    @SerializedName("description")
128    public String description;
129  
130    @SerializedName("subsidy_id")
131    public String subsidyId;
132  
133    @SerializedName("from")
134    public List<ReturnFrom> from;
135  }
136  
137  public static class SubsidiesReturnEntity {
138    @SerializedName("sub_mchid")
139    public String subMchid;
140  
141    @SerializedName("transaction_id")
142    public String transactionId;
143  
144    @SerializedName("subsidy_refund_id")
145    public String subsidyRefundId;
146  
147    @SerializedName("refund_id")
148    public String refundId;
149  
150    @SerializedName("out_order_no")
151    public String outOrderNo;
152  
153    @SerializedName("amount")
154    public Long amount;
155  
156    @SerializedName("description")
157    public String description;
158  
159    @SerializedName("result")
160    public ReturnStatus result;
161  
162    @SerializedName("success_time")
163    public String successTime;
164  
165    @SerializedName("subsidy_id")
166    public String subsidyId;
167  
168    @SerializedName("from")
169    public List<ReturnFrom> from;
170  }
171  
172  public static class ReturnFrom {
173    @SerializedName("account")
174    public ReturnAccount account;
175  
176    @SerializedName("amount")
177    public Long amount;
178  }
179  
180  public enum ReturnStatus {
181    @SerializedName("SUCCESS")
182    SUCCESS,
183    @SerializedName("FAIL")
184    FAIL
185  }
186  
187  public enum ReturnAccount {
188    @SerializedName("AVAILABLE")
189    AVAILABLE,
190    @SerializedName("UNAVAILABLE")
191    UNAVAILABLE
192  }
193  
194}
195

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 := &SubsidiesReturnRequest{
27		SubMchid:      wxpay_utility.String("1900000109"),
28		OutOrderNo:    wxpay_utility.String("P20150806125346"),
29		TransactionId: wxpay_utility.String("4208450740201411110007820472"),
30		RefundId:      wxpay_utility.String("3008450740201411110007820472"),
31		Amount:        wxpay_utility.Int64(10),
32		Description:   wxpay_utility.String("测试备注"),
33		SubsidyId:     wxpay_utility.String("3008450740201411110007820472"),
34		From: []ReturnFrom{ReturnFrom{
35			Account: RETURNACCOUNT_AVAILABLE.Ptr(),
36			Amount:  wxpay_utility.Int64(10),
37		}},
38	}
39
40	response, err := ReturnSubsidy(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 ReturnSubsidy(config *wxpay_utility.MchConfig, request *SubsidiesReturnRequest) (response *SubsidiesReturnEntity, err error) {
52	const (
53		host   = "https://api.mch.weixin.qq.com"
54		method = "POST"
55		path   = "/v3/ecommerce/subsidies/return"
56	)
57
58	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
59	if err != nil {
60		return nil, err
61	}
62	reqBody, err := json.Marshal(request)
63	if err != nil {
64		return nil, err
65	}
66	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
67	if err != nil {
68		return nil, err
69	}
70	httpRequest.Header.Set("Accept", "application/json")
71	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
72	httpRequest.Header.Set("Content-Type", "application/json")
73	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
74	if err != nil {
75		return nil, err
76	}
77	httpRequest.Header.Set("Authorization", authorization)
78
79	client := &http.Client{}
80	httpResponse, err := client.Do(httpRequest)
81	if err != nil {
82		return nil, err
83	}
84	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
85	if err != nil {
86		return nil, err
87	}
88	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
89		// 2XX 成功，验证应答签名
90		err = wxpay_utility.ValidateResponse(
91			config.WechatPayPublicKeyId(),
92			config.WechatPayPublicKey(),
93			&httpResponse.Header,
94			respBody,
95		)
96		if err != nil {
97			return nil, err
98		}
99		response := &SubsidiesReturnEntity{}
100		if err := json.Unmarshal(respBody, response); err != nil {
101			return nil, err
102		}
103
104		return response, nil
105	} else {
106		return nil, wxpay_utility.NewApiException(
107			httpResponse.StatusCode,
108			httpResponse.Header,
109			respBody,
110		)
111	}
112}
113
114type SubsidiesReturnRequest struct {
115	SubMchid      *string      `json:"sub_mchid,omitempty"`
116	OutOrderNo    *string      `json:"out_order_no,omitempty"`
117	TransactionId *string      `json:"transaction_id,omitempty"`
118	RefundId      *string      `json:"refund_id,omitempty"`
119	Amount        *int64       `json:"amount,omitempty"`
120	Description   *string      `json:"description,omitempty"`
121	SubsidyId     *string      `json:"subsidy_id,omitempty"`
122	From          []ReturnFrom `json:"from,omitempty"`
123}
124
125type SubsidiesReturnEntity struct {
126	SubMchid        *string       `json:"sub_mchid,omitempty"`
127	TransactionId   *string       `json:"transaction_id,omitempty"`
128	SubsidyRefundId *string       `json:"subsidy_refund_id,omitempty"`
129	RefundId        *string       `json:"refund_id,omitempty"`
130	OutOrderNo      *string       `json:"out_order_no,omitempty"`
131	Amount          *int64        `json:"amount,omitempty"`
132	Description     *string       `json:"description,omitempty"`
133	Result          *ReturnStatus `json:"result,omitempty"`
134	SuccessTime     *string       `json:"success_time,omitempty"`
135	SubsidyId       *string       `json:"subsidy_id,omitempty"`
136	From            []ReturnFrom  `json:"from,omitempty"`
137}
138
139type ReturnFrom struct {
140	Account *ReturnAccount `json:"account,omitempty"`
141	Amount  *int64         `json:"amount,omitempty"`
142}
143
144type ReturnStatus string
145
146func (e ReturnStatus) Ptr() *ReturnStatus {
147	return &e
148}
149
150const (
151	RETURNSTATUS_SUCCESS ReturnStatus = "SUCCESS"
152	RETURNSTATUS_FAIL    ReturnStatus = "FAIL"
153)
154
155type ReturnAccount string
156
157func (e ReturnAccount) Ptr() *ReturnAccount {
158	return &e
159}
160
161const (
162	RETURNACCOUNT_AVAILABLE   ReturnAccount = "AVAILABLE"
163	RETURNACCOUNT_UNAVAILABLE ReturnAccount = "UNAVAILABLE"
164)
165