# 统一收单交易查询接口 - Java 示例

## 请求示例

```java
package com.java.sdk.demo;

import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.AlipayConfig;
import com.alipay.api.response.AlipayTradeQueryResponse;
import com.alipay.api.request.AlipayTradeQueryRequest;
import com.alipay.api.domain.AlipayTradeQueryModel;

public class AlipayTradeQuery {

    public static void main(String[] args) throws AlipayApiException {
        // 初始化SDK（Java 使用 PKCS#8 格式私钥，C#/Python 使用 PKCS#1 格式，请勿混用）
        AlipayClient alipayClient = new DefaultAlipayClient(getAlipayConfig());

        AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();
        AlipayTradeQueryModel model = new AlipayTradeQueryModel();
        model.setOutTradeNo("MERCHANT_ORDER_NO_PLACEHOLDER");  // 商户订单号，与 tradeNo 二选一
        // model.setTradeNo("ALIPAY_TRADE_NO_PLACEHOLDER");  // 支付宝交易号，同时传时以 tradeNo 为准
        request.setBizModel(model);

        AlipayTradeQueryResponse response = alipayClient.execute(request);

        if (response.isSuccess()) {
            String businessState;
            String tradeStatus = response.getTradeStatus();
            switch (tradeStatus == null ? "" : tradeStatus) {
                case "TRADE_SUCCESS":
                case "TRADE_FINISHED":
                    businessState = "PAID";
                    break;
                case "WAIT_BUYER_PAY":
                    businessState = "PENDING_PAYMENT";
                    break;
                case "TRADE_CLOSED":
                    businessState = "CLOSED";
                    break;
                default:
                    businessState = "UNKNOWN";
            }
            System.out.println("业务状态: " + businessState + ", 支付宝状态: "
                + tradeStatus + ", 订单金额: " + response.getTotalAmount());
        } else {
            System.out.println("调用失败: " + response.getSubCode() + " - " + response.getSubMsg());
        }
    }

    private static AlipayConfig getAlipayConfig() {
        String privateKey  = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->";
        String alipayPublicKey = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->";
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com/gateway.do");
        // 沙箱环境: alipayConfig.setServerUrl("https://openapi-sandbox.dl.alipaydev.com/gateway.do");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：20190xxxxxx -->");
        alipayConfig.setPrivateKey(privateKey);
        alipayConfig.setFormat("json");
        alipayConfig.setAlipayPublicKey(alipayPublicKey);
        alipayConfig.setCharset("UTF-8");
        alipayConfig.setSignType("RSA2");
        return alipayConfig;
    }
}
```

## 响应示例
### 正常示例
```json
{
    "code": "10000",
    "msg": "Success",
    "trade_no": "ALIPAY_TRADE_NO_PLACEHOLDER",
    "out_trade_no": "MERCHANT_ORDER_NO_PLACEHOLDER",
    "trade_status": "TRADE_SUCCESS",
    "total_amount": "88.88",
    "buyer_pay_amount": "8.88",
    "receipt_amount": "15.25",
    "buyer_logon_id": "159****5620",
    "buyer_user_id": "<BUYER_USER_ID>",
    "send_pay_date": "2014-11-27 15:45:57"
}
```
### 异常示例
```json
{
    "code": "20000",
    "msg": "Service Currently Unavailable",
    "sub_code": "isp.unknow-error",
    "sub_msg": "系统繁忙"
}
```
