解除免确认收款授权

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/partner/user-confirm-authorizations/plfk2020042013/close \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

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 CloseUserConfirmAuthorization {
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/user-confirm-authorizations/{out_authorization_no}/close";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32    CloseUserConfirmAuthorization client = new CloseUserConfirmAuthorization(
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    CloseUserConfirmAuthorizationRequest request = new CloseUserConfirmAuthorizationRequest();
41    request.outAuthorizationNo = "plfk2020042013";
42    try {
43      UserConfirmAuthorizationEntity response = client.run(request);
44        // TODO: 请求成功，继续业务逻辑
45        System.out.println(response);
46    } catch (WXPayUtility.ApiException e) {
47        // TODO: 请求失败，根据状态码执行不同的逻辑
48        e.printStackTrace();
49    }
50  }
51
52  public UserConfirmAuthorizationEntity run(CloseUserConfirmAuthorizationRequest request) {
53    String uri = PATH;
54    uri = uri.replace("{out_authorization_no}", WXPayUtility.urlEncode(request.outAuthorizationNo));
55
56    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
57    reqBuilder.addHeader("Accept", "application/json");
58    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
59    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo, privateKey, METHOD, uri, null));
60    reqBuilder.addHeader("Content-Type", "application/json");
61    RequestBody emptyBody = RequestBody.create(null, "");
62    reqBuilder.method(METHOD, emptyBody);
63    Request httpRequest = reqBuilder.build();
64
65    // 发送HTTP请求
66    OkHttpClient client = new OkHttpClient.Builder().build();
67    try (Response httpResponse = client.newCall(httpRequest).execute()) {
68      String respBody = WXPayUtility.extractBody(httpResponse);
69      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
70        // 2XX 成功，验证应答签名
71        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
72            httpResponse.headers(), respBody);
73
74        // 从HTTP应答报文构建返回数据
75        return WXPayUtility.fromJson(respBody, UserConfirmAuthorizationEntity.class);
76      } else {
77        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
78      }
79    } catch (IOException e) {
80      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
81    }
82  }
83
84  private final String mchid;
85  private final String certificateSerialNo;
86  private final PrivateKey privateKey;
87  private final String wechatPayPublicKeyId;
88  private final PublicKey wechatPayPublicKey;
89
90  public CloseUserConfirmAuthorization(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
91    this.mchid = mchid;
92    this.certificateSerialNo = certificateSerialNo;
93    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
94    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
95    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
96  }
97
98  public static class CloseUserConfirmAuthorizationRequest {
99    @SerializedName("out_authorization_no")
100    @Expose(serialize = false)
101    public String outAuthorizationNo;
102  }
103  
104  public static class UserConfirmAuthorizationEntity {
105    @SerializedName("out_authorization_no")
106    public String outAuthorizationNo;
107  
108    @SerializedName("appid")
109    public String appid;
110  
111    @SerializedName("openid")
112    public String openid;
113  
114    @SerializedName("user_display_name")
115    public String userDisplayName;
116  
117    @SerializedName("authorization_id")
118    public String authorizationId;
119  
120    @SerializedName("state")
121    public UserConfirmAuthorizationState state;
122  
123    @SerializedName("authorize_time")
124    public String authorizeTime;
125  
126    @SerializedName("close_info")
127    public UserConfirmAuthorizationCloseInfo closeInfo;
128  
129    @SerializedName("transfer_scene_id")
130    public String transferSceneId;
131  
132    @SerializedName("user_recv_perception")
133    public String userRecvPerception;
134  
135    @SerializedName("create_time")
136    public String createTime;
137  }
138  
139  public enum UserConfirmAuthorizationState {
140    @SerializedName("CLOSED")
141    CLOSED
142  }
143  
144  public static class UserConfirmAuthorizationCloseInfo {
145    @SerializedName("close_time")
146    public String closeTime;
147  
148    @SerializedName("close_reason")
149    public CloseReason closeReason;
150  }
151  
152  public enum CloseReason {
153    @SerializedName("CLOSE_VIA_MCH_API")
154    CLOSE_VIA_MCH_API
155  }
156  
157}
158

1package main
2
3import (
4	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/partner/4015119446
5	"encoding/json"
6	"fmt"
7	"net/http"
8	"net/url"
9	"strings"
10	"time"
11)
12
13func main() {
14	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
15	config, err := wxpay_utility.CreateMchConfig(
16		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
17		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
18		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
19		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
20		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
21	)
22	if err != nil {
23		fmt.Println(err)
24		return
25	}
26
27	request := &CloseUserConfirmAuthorizationRequest{
28		OutAuthorizationNo: wxpay_utility.String("plfk2020042013"),
29	}
30
31	response, err := CloseUserConfirmAuthorization(config, request)
32	if err != nil {
33		fmt.Printf("请求失败: %+v\n", err)
34		// TODO: 请求失败，根据状态码执行不同的处理
35		return
36	}
37
38	// TODO: 请求成功，继续业务逻辑
39	fmt.Printf("请求成功: %+v\n", response)
40}
41
42func CloseUserConfirmAuthorization(config *wxpay_utility.MchConfig, request *CloseUserConfirmAuthorizationRequest) (response *UserConfirmAuthorizationEntity, err error) {
43	const (
44		host   = "https://api.mch.weixin.qq.com"
45		method = "POST"
46		path   = "/v3/fund-app/mch-transfer/partner/user-confirm-authorizations/{out_authorization_no}/close"
47	)
48
49	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
50	if err != nil {
51		return nil, err
52	}
53	reqUrl.Path = strings.Replace(reqUrl.Path, "{out_authorization_no}", url.PathEscape(*request.OutAuthorizationNo), -1)
54	httpRequest, err := http.NewRequest(method, reqUrl.String(), nil)
55	if err != nil {
56		return nil, err
57	}
58	httpRequest.Header.Set("Accept", "application/json")
59	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
60	httpRequest.Header.Set("Content-Type", "application/json")
61	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), nil)
62	if err != nil {
63		return nil, err
64	}
65	httpRequest.Header.Set("Authorization", authorization)
66
67	client := &http.Client{}
68	httpResponse, err := client.Do(httpRequest)
69	if err != nil {
70		return nil, err
71	}
72	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
73	if err != nil {
74		return nil, err
75	}
76	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
77		// 2XX 成功，验证应答签名
78		err = wxpay_utility.ValidateResponse(
79			config.WechatPayPublicKeyId(),
80			config.WechatPayPublicKey(),
81			&httpResponse.Header,
82			respBody,
83		)
84		if err != nil {
85			return nil, err
86		}
87		response := &UserConfirmAuthorizationEntity{}
88		if err := json.Unmarshal(respBody, response); err != nil {
89			return nil, err
90		}
91
92		return response, nil
93	} else {
94		return nil, wxpay_utility.NewApiException(
95			httpResponse.StatusCode,
96			httpResponse.Header,
97			respBody,
98		)
99	}
100}
101
102type CloseUserConfirmAuthorizationRequest struct {
103	OutAuthorizationNo *string `json:"out_authorization_no,omitempty"`
104}
105
106func (o *CloseUserConfirmAuthorizationRequest) MarshalJSON() ([]byte, error) {
107	type Alias CloseUserConfirmAuthorizationRequest
108	a := &struct {
109		OutAuthorizationNo *string `json:"out_authorization_no,omitempty"`
110		*Alias
111	}{
112		// 序列化时移除非 Body 字段
113		OutAuthorizationNo: nil,
114		Alias:              (*Alias)(o),
115	}
116	return json.Marshal(a)
117}
118
119type UserConfirmAuthorizationEntity struct {
120	OutAuthorizationNo *string                            `json:"out_authorization_no,omitempty"`
121	Appid              *string                            `json:"appid,omitempty"`
122	Openid             *string                            `json:"openid,omitempty"`
123	UserDisplayName    *string                            `json:"user_display_name,omitempty"`
124	AuthorizationId    *string                            `json:"authorization_id,omitempty"`
125	State              *UserConfirmAuthorizationState     `json:"state,omitempty"`
126	AuthorizeTime      *string                            `json:"authorize_time,omitempty"`
127	CloseInfo          *UserConfirmAuthorizationCloseInfo `json:"close_info,omitempty"`
128	TransferSceneId    *string                            `json:"transfer_scene_id,omitempty"`
129	UserRecvPerception *string                            `json:"user_recv_perception,omitempty"`
130	CreateTime         *time.Time                         `json:"create_time,omitempty"`
131}
132
133type UserConfirmAuthorizationState string
134
135func (e UserConfirmAuthorizationState) Ptr() *UserConfirmAuthorizationState {
136	return &e
137}
138
139const (
140	USERCONFIRMAUTHORIZATIONSTATE_CLOSED UserConfirmAuthorizationState = "CLOSED"
141)
142
143type UserConfirmAuthorizationCloseInfo struct {
144	CloseTime   *string      `json:"close_time,omitempty"`
145	CloseReason *CloseReason `json:"close_reason,omitempty"`
146}
147
148type CloseReason string
149
150func (e CloseReason) Ptr() *CloseReason {
151	return &e
152}
153
154const (
155	CLOSEREASON_CLOSE_VIA_MCH_API CloseReason = "CLOSE_VIA_MCH_API"
156)
157