查询支付分订单

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/payscore/serviceorder?out_order_no=1234323JKHDFE1243252&service_id=2002000000000558128851361561536&appid=wxd678efh567hg6787&query_id=15646546545165651651 \
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/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 GetServiceOrder {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "GET";
28  private static String PATH = "/v3/payscore/serviceorder";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/merchant/4013070756
32    GetServiceOrder client = new GetServiceOrder(
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    GetServiceOrderRequest request = new GetServiceOrderRequest();
41    request.outOrderNo = "1234323JKHDFE1243252";
42    request.serviceId = "2002000000000558128851361561536";
43    request.appid = "wxd678efh567hg6787";
44    request.queryId = "15646546545165651651";
45    try {
46      ServiceOrderEntity response = client.run(request);
47        // TODO: 请求成功，继续业务逻辑
48        System.out.println(response);
49    } catch (WXPayUtility.ApiException e) {
50        // TODO: 请求失败，根据状态码执行不同的逻辑
51        e.printStackTrace();
52    }
53  }
54
55  public ServiceOrderEntity run(GetServiceOrderRequest request) {
56    String uri = PATH;
57    Map<String, Object> args = new HashMap<>();
58    args.put("out_order_no", request.outOrderNo);
59    args.put("service_id", request.serviceId);
60    args.put("appid", request.appid);
61    args.put("query_id", request.queryId);
62    String queryString = WXPayUtility.urlEncode(args);
63    if (!queryString.isEmpty()) {
64        uri = uri + "?" + queryString;
65    }
66
67    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
68    reqBuilder.addHeader("Accept", "application/json");
69    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
70    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo, privateKey, METHOD, uri, null));
71    reqBuilder.method(METHOD, null);
72    Request httpRequest = reqBuilder.build();
73
74    // 发送HTTP请求
75    OkHttpClient client = new OkHttpClient.Builder().build();
76    try (Response httpResponse = client.newCall(httpRequest).execute()) {
77      String respBody = WXPayUtility.extractBody(httpResponse);
78      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
79        // 2XX 成功，验证应答签名
80        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
81            httpResponse.headers(), respBody);
82
83        // 从HTTP应答报文构建返回数据
84        return WXPayUtility.fromJson(respBody, ServiceOrderEntity.class);
85      } else {
86        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
87      }
88    } catch (IOException e) {
89      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
90    }
91  }
92
93  private final String mchid;
94  private final String certificateSerialNo;
95  private final PrivateKey privateKey;
96  private final String wechatPayPublicKeyId;
97  private final PublicKey wechatPayPublicKey;
98
99  public GetServiceOrder(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
100    this.mchid = mchid;
101    this.certificateSerialNo = certificateSerialNo;
102    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
103    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
104    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
105  }
106
107  public static class GetServiceOrderRequest {
108    @SerializedName("out_order_no")
109    @Expose(serialize = false)
110    public String outOrderNo;
111  
112    @SerializedName("service_id")
113    @Expose(serialize = false)
114    public String serviceId;
115  
116    @SerializedName("appid")
117    @Expose(serialize = false)
118    public String appid;
119  
120    @SerializedName("query_id")
121    @Expose(serialize = false)
122    public String queryId;
123  }
124  
125  public static class ServiceOrderEntity {
126    @SerializedName("out_order_no")
127    public String outOrderNo;
128  
129    @SerializedName("service_id")
130    public String serviceId;
131  
132    @SerializedName("appid")
133    public String appid;
134  
135    @SerializedName("mchid")
136    public String mchid;
137  
138    @SerializedName("service_introduction")
139    public String serviceIntroduction;
140  
141    @SerializedName("state")
142    public String state;
143  
144    @SerializedName("state_description")
145    public String stateDescription;
146  
147    @SerializedName("post_payments")
148    public Payment postPayments;
149  
150    @SerializedName("post_discounts")
151    public List<ServiceOrderCoupon> postDiscounts;
152  
153    @SerializedName("risk_fund")
154    public RiskFund riskFund;
155  
156    @SerializedName("total_amount")
157    public Long totalAmount;
158  
159    @SerializedName("need_collection")
160    public Boolean needCollection;
161  
162    @SerializedName("collection")
163    public Collection collection;
164  
165    @SerializedName("time_range")
166    public TimeRange timeRange;
167  
168    @SerializedName("location")
169    public Location location;
170  
171    @SerializedName("attach")
172    public String attach;
173  
174    @SerializedName("notify_url")
175    public String notifyUrl;
176  
177    @SerializedName("openid")
178    public String openid;
179  
180    @SerializedName("order_id")
181    public String orderId;
182  }
183  
184  public static class Payment {
185    @SerializedName("name")
186    public String name;
187  
188    @SerializedName("amount")
189    public Long amount;
190  
191    @SerializedName("description")
192    public String description;
193  
194    @SerializedName("count")
195    public Long count;
196  }
197  
198  public static class ServiceOrderCoupon {
199    @SerializedName("name")
200    public String name;
201  
202    @SerializedName("description")
203    public String description;
204  
205    @SerializedName("amount")
206    public Long amount;
207  
208    @SerializedName("count")
209    public Long count;
210  }
211  
212  public static class RiskFund {
213    @SerializedName("name")
214    public String name;
215  
216    @SerializedName("amount")
217    public Long amount;
218  
219    @SerializedName("description")
220    public String description;
221  }
222  
223  public static class Collection {
224    @SerializedName("state")
225    public String state;
226  
227    @SerializedName("total_amount")
228    public Long totalAmount;
229  
230    @SerializedName("paying_amount")
231    public Long payingAmount;
232  
233    @SerializedName("paid_amount")
234    public Long paidAmount;
235  
236    @SerializedName("details")
237    public List<Detail> details;
238  }
239  
240  public static class TimeRange {
241    @SerializedName("start_time")
242    public String startTime;
243  
244    @SerializedName("end_time")
245    public String endTime;
246  
247    @SerializedName("start_time_remark")
248    public String startTimeRemark;
249  
250    @SerializedName("end_time_remark")
251    public String endTimeRemark;
252  }
253  
254  public static class Location {
255    @SerializedName("start_location")
256    public String startLocation;
257  
258    @SerializedName("end_location")
259    public String endLocation;
260  }
261  
262  public static class Detail {
263    @SerializedName("seq")
264    public Long seq;
265  
266    @SerializedName("amount")
267    public Long amount;
268  
269    @SerializedName("paid_type")
270    public String paidType;
271  
272    @SerializedName("paid_time")
273    public String paidTime;
274  
275    @SerializedName("transaction_id")
276    public String transactionId;
277  }
278  
279}
280

1package main
2
3import (
4	"demo/wxpay_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/v3/merchant/4015119334
5	"encoding/json"
6	"fmt"
7	"net/http"
8	"net/url"
9)
10
11func main() {
12	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/merchant/4013070756
13	config, err := wxpay_utility.CreateMchConfig(
14		"19xxxxxxxx",                 // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756
15		"1DDE55AD98Exxxxxxxxxx",      // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053
16		"/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
17		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816
18		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
19	)
20	if err != nil {
21		fmt.Println(err)
22		return
23	}
24
25	request := &GetServiceOrderRequest{
26		OutOrderNo: wxpay_utility.String("1234323JKHDFE1243252"),
27		ServiceId:  wxpay_utility.String("2002000000000558128851361561536"),
28		Appid:      wxpay_utility.String("wxd678efh567hg6787"),
29		QueryId:    wxpay_utility.String("15646546545165651651"),
30	}
31
32	response, err := GetServiceOrder(config, request)
33	if err != nil {
34		fmt.Printf("请求失败: %+v\n", err)
35		// TODO: 请求失败，根据状态码执行不同的处理
36		return
37	}
38
39	// TODO: 请求成功，继续业务逻辑
40	fmt.Printf("请求成功: %+v\n", response)
41}
42
43func GetServiceOrder(config *wxpay_utility.MchConfig, request *GetServiceOrderRequest) (response *ServiceOrderEntity, err error) {
44	const (
45		host   = "https://api.mch.weixin.qq.com"
46		method = "GET"
47		path   = "/v3/payscore/serviceorder"
48	)
49
50	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
51	if err != nil {
52		return nil, err
53	}
54	query := reqUrl.Query()
55	if request.OutOrderNo != nil {
56		query.Add("out_order_no", *request.OutOrderNo)
57	}
58	if request.ServiceId != nil {
59		query.Add("service_id", *request.ServiceId)
60	}
61	if request.Appid != nil {
62		query.Add("appid", *request.Appid)
63	}
64	if request.QueryId != nil {
65		query.Add("query_id", *request.QueryId)
66	}
67	reqUrl.RawQuery = query.Encode()
68	httpRequest, err := http.NewRequest(method, reqUrl.String(), nil)
69	if err != nil {
70		return nil, err
71	}
72	httpRequest.Header.Set("Accept", "application/json")
73	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
74	authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), nil)
75	if err != nil {
76		return nil, err
77	}
78	httpRequest.Header.Set("Authorization", authorization)
79
80	client := &http.Client{}
81	httpResponse, err := client.Do(httpRequest)
82	if err != nil {
83		return nil, err
84	}
85	respBody, err := wxpay_utility.ExtractResponseBody(httpResponse)
86	if err != nil {
87		return nil, err
88	}
89	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
90		// 2XX 成功，验证应答签名
91		err = wxpay_utility.ValidateResponse(
92			config.WechatPayPublicKeyId(),
93			config.WechatPayPublicKey(),
94			&httpResponse.Header,
95			respBody,
96		)
97		if err != nil {
98			return nil, err
99		}
100		response := &ServiceOrderEntity{}
101		if err := json.Unmarshal(respBody, response); err != nil {
102			return nil, err
103		}
104
105		return response, nil
106	} else {
107		return nil, wxpay_utility.NewApiException(
108			httpResponse.StatusCode,
109			httpResponse.Header,
110			respBody,
111		)
112	}
113}
114
115type GetServiceOrderRequest struct {
116	OutOrderNo *string `json:"out_order_no,omitempty"`
117	ServiceId  *string `json:"service_id,omitempty"`
118	Appid      *string `json:"appid,omitempty"`
119	QueryId    *string `json:"query_id,omitempty"`
120}
121
122func (o *GetServiceOrderRequest) MarshalJSON() ([]byte, error) {
123	type Alias GetServiceOrderRequest
124	a := &struct {
125		OutOrderNo *string `json:"out_order_no,omitempty"`
126		ServiceId  *string `json:"service_id,omitempty"`
127		Appid      *string `json:"appid,omitempty"`
128		QueryId    *string `json:"query_id,omitempty"`
129		*Alias
130	}{
131		// 序列化时移除非 Body 字段
132		OutOrderNo: nil,
133		ServiceId:  nil,
134		Appid:      nil,
135		QueryId:    nil,
136		Alias:      (*Alias)(o),
137	}
138	return json.Marshal(a)
139}
140
141type ServiceOrderEntity struct {
142	OutOrderNo          *string              `json:"out_order_no,omitempty"`
143	ServiceId           *string              `json:"service_id,omitempty"`
144	Appid               *string              `json:"appid,omitempty"`
145	Mchid               *string              `json:"mchid,omitempty"`
146	ServiceIntroduction *string              `json:"service_introduction,omitempty"`
147	State               *string              `json:"state,omitempty"`
148	StateDescription    *string              `json:"state_description,omitempty"`
149	PostPayments        *Payment             `json:"post_payments,omitempty"`
150	PostDiscounts       []ServiceOrderCoupon `json:"post_discounts,omitempty"`
151	RiskFund            *RiskFund            `json:"risk_fund,omitempty"`
152	TotalAmount         *int64               `json:"total_amount,omitempty"`
153	NeedCollection      *bool                `json:"need_collection,omitempty"`
154	Collection          *Collection          `json:"collection,omitempty"`
155	TimeRange           *TimeRange           `json:"time_range,omitempty"`
156	Location            *Location            `json:"location,omitempty"`
157	Attach              *string              `json:"attach,omitempty"`
158	NotifyUrl           *string              `json:"notify_url,omitempty"`
159	Openid              *string              `json:"openid,omitempty"`
160	OrderId             *string              `json:"order_id,omitempty"`
161}
162
163type Payment struct {
164	Name        *string `json:"name,omitempty"`
165	Amount      *int64  `json:"amount,omitempty"`
166	Description *string `json:"description,omitempty"`
167	Count       *int64  `json:"count,omitempty"`
168}
169
170type ServiceOrderCoupon struct {
171	Name        *string `json:"name,omitempty"`
172	Description *string `json:"description,omitempty"`
173	Amount      *int64  `json:"amount,omitempty"`
174	Count       *int64  `json:"count,omitempty"`
175}
176
177type RiskFund struct {
178	Name        *string `json:"name,omitempty"`
179	Amount      *int64  `json:"amount,omitempty"`
180	Description *string `json:"description,omitempty"`
181}
182
183type Collection struct {
184	State        *string  `json:"state,omitempty"`
185	TotalAmount  *int64   `json:"total_amount,omitempty"`
186	PayingAmount *int64   `json:"paying_amount,omitempty"`
187	PaidAmount   *int64   `json:"paid_amount,omitempty"`
188	Details      []Detail `json:"details,omitempty"`
189}
190
191type TimeRange struct {
192	StartTime       *string `json:"start_time,omitempty"`
193	EndTime         *string `json:"end_time,omitempty"`
194	StartTimeRemark *string `json:"start_time_remark,omitempty"`
195	EndTimeRemark   *string `json:"end_time_remark,omitempty"`
196}
197
198type Location struct {
199	StartLocation *string `json:"start_location,omitempty"`
200	EndLocation   *string `json:"end_location,omitempty"`
201}
202
203type Detail struct {
204	Seq           *int64  `json:"seq,omitempty"`
205	Amount        *int64  `json:"amount,omitempty"`
206	PaidType      *string `json:"paid_type,omitempty"`
207	PaidTime      *string `json:"paid_time,omitempty"`
208	TransactionId *string `json:"transaction_id,omitempty"`
209}
210