解冻剩余资金

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/profitsharing/orders/unfreeze \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "transaction_id" : "4208450740201411110007820472",
8    "out_order_no" : "P20150806125346",
9    "description" : "解冻全部剩余资金"
10  }'
11

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

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	"time"
11)
12
13func main() {
14	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/merchant/4013070756
15	config, err := wxpay_utility.CreateMchConfig(
16		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756
17		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053
18		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
19		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816
20		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
21	)
22	if err != nil {
23		fmt.Println(err)
24		return
25	}
26
27	request := &UnfreezeOrderRequest{
28		TransactionId: wxpay_utility.String("4208450740201411110007820472"),
29		OutOrderNo:    wxpay_utility.String("P20150806125346"),
30		Description:   wxpay_utility.String("解冻全部剩余资金"),
31	}
32
33	response, err := UnfreezeOrder(config, request)
34	if err != nil {
35		fmt.Printf("请求失败: %+v\n", err)
36		// TODO: 请求失败，根据状态码执行不同的处理
37		return
38	}
39
40	// TODO: 请求成功，继续业务逻辑
41	fmt.Printf("请求成功: %+v\n", response)
42}
43
44func UnfreezeOrder(config *wxpay_utility.MchConfig, request *UnfreezeOrderRequest) (response *OrdersEntity, err error) {
45	const (
46		host   = "https://api.mch.weixin.qq.com"
47		method = "POST"
48		path   = "/v3/profitsharing/orders/unfreeze"
49	)
50
51	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
52	if err != nil {
53		return nil, err
54	}
55	reqBody, err := json.Marshal(request)
56	if err != nil {
57		return nil, err
58	}
59	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
60	if err != nil {
61		return nil, err
62	}
63	httpRequest.Header.Set("Accept", "application/json")
64	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
65	httpRequest.Header.Set("Content-Type", "application/json")
66	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
67	if err != nil {
68		return nil, err
69	}
70	httpRequest.Header.Set("Authorization", authorization)
71
72	client := &http.Client{}
73	httpResponse, err := client.Do(httpRequest)
74	if err != nil {
75		return nil, err
76	}
77	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
78	if err != nil {
79		return nil, err
80	}
81	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
82		// 2XX 成功，验证应答签名
83		err = wxpay_utility.ValidateResponse(
84			config.WechatPayPublicKeyId(),
85			config.WechatPayPublicKey(),
86			&httpResponse.Header,
87			respBody,
88		)
89		if err != nil {
90			return nil, err
91		}
92		response := &OrdersEntity{}
93		if err := json.Unmarshal(respBody, response); err != nil {
94			return nil, err
95		}
96
97		return response, nil
98	} else {
99		return nil, wxpay_utility.NewApiException(
100			httpResponse.StatusCode,
101			httpResponse.Header,
102			respBody,
103		)
104	}
105}
106
107type UnfreezeOrderRequest struct {
108	TransactionId *string `json:"transaction_id,omitempty"`
109	OutOrderNo    *string `json:"out_order_no,omitempty"`
110	Description   *string `json:"description,omitempty"`
111}
112
113type OrdersEntity struct {
114	TransactionId *string               `json:"transaction_id,omitempty"`
115	OutOrderNo    *string               `json:"out_order_no,omitempty"`
116	OrderId       *string               `json:"order_id,omitempty"`
117	State         *OrderStatus          `json:"state,omitempty"`
118	Receivers     []OrderReceiverDetail `json:"receivers,omitempty"`
119}
120
121type OrderStatus string
122
123func (e OrderStatus) Ptr() *OrderStatus {
124	return &e
125}
126
127const (
128	ORDERSTATUS_PROCESSING OrderStatus = "PROCESSING"
129	ORDERSTATUS_FINISHED   OrderStatus = "FINISHED"
130)
131
132type OrderReceiverDetail struct {
133	Amount      *int64            `json:"amount,omitempty"`
134	Description *string           `json:"description,omitempty"`
135	Type        *ReceiverType     `json:"type,omitempty"`
136	Account     *string           `json:"account,omitempty"`
137	Result      *DetailStatus     `json:"result,omitempty"`
138	FailReason  *DetailFailReason `json:"fail_reason,omitempty"`
139	CreateTime  *time.Time        `json:"create_time,omitempty"`
140	FinishTime  *time.Time        `json:"finish_time,omitempty"`
141	DetailId    *string           `json:"detail_id,omitempty"`
142}
143
144type ReceiverType string
145
146func (e ReceiverType) Ptr() *ReceiverType {
147	return &e
148}
149
150const (
151	RECEIVERTYPE_MERCHANT_ID     ReceiverType = "MERCHANT_ID"
152	RECEIVERTYPE_PERSONAL_OPENID ReceiverType = "PERSONAL_OPENID"
153)
154
155type DetailStatus string
156
157func (e DetailStatus) Ptr() *DetailStatus {
158	return &e
159}
160
161const (
162	DETAILSTATUS_PENDING DetailStatus = "PENDING"
163	DETAILSTATUS_SUCCESS DetailStatus = "SUCCESS"
164	DETAILSTATUS_CLOSED  DetailStatus = "CLOSED"
165)
166
167type DetailFailReason string
168
169func (e DetailFailReason) Ptr() *DetailFailReason {
170	return &e
171}
172
173const (
174	DETAILFAILREASON_ACCOUNT_ABNORMAL                DetailFailReason = "ACCOUNT_ABNORMAL"
175	DETAILFAILREASON_NO_RELATION                     DetailFailReason = "NO_RELATION"
176	DETAILFAILREASON_RECEIVER_HIGH_RISK              DetailFailReason = "RECEIVER_HIGH_RISK"
177	DETAILFAILREASON_RECEIVER_REAL_NAME_NOT_VERIFIED DetailFailReason = "RECEIVER_REAL_NAME_NOT_VERIFIED"
178	DETAILFAILREASON_NO_AUTH                         DetailFailReason = "NO_AUTH"
179	DETAILFAILREASON_RECEIVER_RECEIPT_LIMIT          DetailFailReason = "RECEIVER_RECEIPT_LIMIT"
180	DETAILFAILREASON_PAYER_ACCOUNT_ABNORMAL          DetailFailReason = "PAYER_ACCOUNT_ABNORMAL"
181	DETAILFAILREASON_INVALID_REQUEST                 DetailFailReason = "INVALID_REQUEST"
182)
183