---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012534441-java.md"
title: "查询订单-请求示例-java"
doc_id: 4012534441
example_lang: "java"
---

## Java


需配合微信支付工具库 WXPayUtility 使用，请参考 [Java](https://pay.weixin.qq.com/doc/v3/merchant/4014931831.md)

```
package com.java.demo;

import com.java.utils.WXPayUtility; // 引用微信支付工具库，参考：https://pay.weixin.qq.com/doc/v3/partner/4014985777

import com.google.gson.annotations.SerializedName;
import com.google.gson.annotations.Expose;
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;

import java.io.IOException;
import java.io.UncheckedIOException;
import java.security.PrivateKey;
import java.security.PublicKey;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * 查询订单
 */
public class QueryTransaction {
  private static String HOST = "https://api.mch.weixin.qq.com";
  private static String METHOD = "GET";
  private static String PATH = "/v3/vehicle/transactions/out-trade-no/{out_trade_no}";

  public static void main(String[] args) {
    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
    QueryTransaction client = new QueryTransaction(
      "19xxxxxxxx",                    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
      "1DDE55AD98Exxxxxxxxxx",         // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
      "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
      "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
      "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
    );

    QueryTransactionRequest request = new QueryTransactionRequest();
    request.outTradeNo = "20150806125346";
    request.subMchid = "1900000109";
    try {
      Transaction response = client.run(request);
        // TODO: 请求成功，继续业务逻辑
        System.out.println(response);
    } catch (WXPayUtility.ApiException e) {
        // TODO: 请求失败，根据状态码执行不同的逻辑
        e.printStackTrace();
    }
  }

  public Transaction run(QueryTransactionRequest request) {
    String uri = PATH;
    uri = uri.replace("{out_trade_no}", WXPayUtility.urlEncode(request.outTradeNo));
    Map<String, Object> args = new HashMap<>();
    args.put("sub_mchid", request.subMchid);
    String queryString = WXPayUtility.urlEncode(args);
    if (!queryString.isEmpty()) {
        uri = uri + "?" + queryString;
    }

    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
    reqBuilder.addHeader("Accept", "application/json");
    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo, privateKey, METHOD, uri, null));
    reqBuilder.method(METHOD, null);
    Request httpRequest = reqBuilder.build();

    // 发送HTTP请求
    OkHttpClient client = new OkHttpClient.Builder().build();
    try (Response httpResponse = client.newCall(httpRequest).execute()) {
      String respBody = WXPayUtility.extractBody(httpResponse);
      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
        // 2XX 成功，验证应答签名
        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
            httpResponse.headers(), respBody);

        // 从HTTP应答报文构建返回数据
        return WXPayUtility.fromJson(respBody, Transaction.class);
      } else {
        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
      }
    } catch (IOException e) {
      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
    }
  }

  private final String mchid;
  private final String certificateSerialNo;
  private final PrivateKey privateKey;
  private final String wechatPayPublicKeyId;
  private final PublicKey wechatPayPublicKey;

  public QueryTransaction(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
    this.mchid = mchid;
    this.certificateSerialNo = certificateSerialNo;
    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
  }

  public static class QueryTransactionRequest {
    @SerializedName("sub_mchid")
    @Expose(serialize = false)
    public String subMchid;

    @SerializedName("out_trade_no")
    @Expose(serialize = false)
    public String outTradeNo;
  }

  public static class Transaction {
    @SerializedName("appid")
    public String appid;

    @SerializedName("sub_appid")
    public String subAppid;

    @SerializedName("sp_mchid")
    public String spMchid;

    @SerializedName("sub_mchid")
    public String subMchid;

    @SerializedName("description")
    public String description;

    @SerializedName("create_time")
    public String createTime;

    @SerializedName("out_trade_no")
    public String outTradeNo;

    @SerializedName("transaction_id")
    public String transactionId;

    @SerializedName("trade_state")
    public String tradeState;

    @SerializedName("trade_state_description")
    public String tradeStateDescription;

    @SerializedName("success_time")
    public String successTime;

    @SerializedName("bank_type")
    public String bankType;

    @SerializedName("user_repaid")
    public String userRepaid;

    @SerializedName("attach")
    public String attach;

    @SerializedName("trade_scene")
    public String tradeScene;

    @SerializedName("parking_info")
    public ParkingTradeScene parkingInfo;

    @SerializedName("payer")
    public Payer payer;

    @SerializedName("amount")
    public QueryOrderAmount amount;

    @SerializedName("promotion_detail")
    public List<PromotionDetail> promotionDetail;
  }

  public static class ParkingTradeScene {
    @SerializedName("parking_id")
    public String parkingId;

    @SerializedName("plate_number")
    public String plateNumber;

    @SerializedName("plate_color")
    public PlateColor plateColor;

    @SerializedName("start_time")
    public String startTime;

    @SerializedName("end_time")
    public String endTime;

    @SerializedName("parking_name")
    public String parkingName;

    @SerializedName("charging_duration")
    public Long chargingDuration;

    @SerializedName("device_id")
    public String deviceId;
  }

  public static class Payer {
    @SerializedName("openid")
    public String openid;

    @SerializedName("sub_openid")
    public String subOpenid;
  }

  public static class QueryOrderAmount {
    @SerializedName("total")
    public Long total;

    @SerializedName("currency")
    public String currency;

    @SerializedName("payer_total")
    public Long payerTotal;

    @SerializedName("discount_total")
    public Long discountTotal;
  }

  public static class PromotionDetail {
    @SerializedName("coupon_id")
    public String couponId;

    @SerializedName("name")
    public String name;

    @SerializedName("scope")
    public String scope;

    @SerializedName("type")
    public String type;

    @SerializedName("stock_id")
    public String stockId;

    @SerializedName("amount")
    public Long amount;

    @SerializedName("wechatpay_contribute")
    public Long wechatpayContribute;

    @SerializedName("merchant_contribute")
    public Long merchantContribute;

    @SerializedName("other_contribute")
    public Long otherContribute;

    @SerializedName("currency")
    public String currency;
  }

  public enum PlateColor {
    @SerializedName("BLUE")
    BLUE,
    @SerializedName("GREEN")
    GREEN,
    @SerializedName("YELLOW")
    YELLOW,
    @SerializedName("BLACK")
    BLACK,
    @SerializedName("WHITE")
    WHITE,
    @SerializedName("LIMEGREEN")
    LIMEGREEN
  }

}

```
