接口名称：统一收单线下交易查询
英文名称：alipay.trade.query
用于查询订单是否存在以及订单的详细信息；
一、文档地址
官方文档地址：[url]https://docs.open.alipay.com/api_1/alipay.trade.query/[/url]
二、开发前准备工作
调用步骤：[url]https://openclub.alipay.com/read.php?tid=12194&fid=69[/url]
注意事项：1、支持沙箱测试；2、需签约并添加功能；3、支持第三方调用。
如何签约以及签约无法成功等相关签约问题：[url]https://openclub.alipay.com/read.php?tid=276&fid=72[/url]
注：该接口为辅助接口，只要签约当面付、手机网站支付、电脑网站支付和APP支付，四个支付接口中其中一个就可以调用。
三、接口集成代码示例
1、参数说明
（1）out_trade_no：商户订单号，该参数值为支付接口中设置的out_trade_no参数值；
（2）trade_no：支付宝交易号，该参数值为支付接口订单创建后返回的trade_no参数值；
注：out_trade_no和trade_no至少必传其中一个参数，两者同时设置优先取值trade_no。
2、JAVA版请求示例
public static void main(String[] args) throws AlipayApiException { AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type); AlipayTradeQueryRequest request = new AlipayTradeQueryRequest(); //out_trade_no（外部订单号）和trade_no（支付宝交易号)二选一用 即可查询 AlipayTradeQueryModel model = new AlipayTradeQueryModel(); model.setOutTradeNo("20150320010101004498"); //model.setTradeNo("2019031222001494890500825908"); request.setBizModel(model); AlipayTradeQueryResponse response = alipayClient.execute(request); System.out.println(response.getBody());}返回的响应参数示例：
{"alipay_trade_query_response":{"code":"10000","msg":"Success","buyer_logon_id":"uqq***@sandbox.com","buyer_pay_amount":"2.00","buyer_user_id":"2088102175794899","buyer_user_type":"PRIVATE","fund_bill_list":[{"amount":"2.00","fund_channel":"ALIPAYACCOUNT"}],"invoice_amount":"2.00","out_trade_no":"20150320010101004498","point_amount":"0.00","receipt_amount":"2.00","send_pay_date":"2019-03-12 10:50:09","total_amount":"2.00","trade_no":"2019031222001494890500825908","trade_status":"TRADE_SUCCESS"},"sign":"gK9/bRceHVXou0vX4U+GgQv+F9pgL15lDtpQqR/y2glaWywOvYUsmV1/5UpbVFOP28yXHMEQJxqwp8j81GuF8zQsXlYmdlaOgZ0BaTa3Eh82zftejcRkIwgiLhUg3ZQBfbpjExgazhF0CvGoNaauyIfoKICJF61vsvN0ISAOXEPze+/XVmzjTueFUn3OWoknaD/mxtlGYOe67AU5vc+ueOUklaxis0ERivJB+eo9DWUDA3NzRvms2arkaQ3BEdZ4+HMMI4wK94RxpUchMbZHmta+msMTSpDtRRxWgr9gT9XFw59ZgYr/rpZYPCHKAAp/RbhzOLpnpBlAE/eqLSZqeA=="}3、PHP版请求示例
<?phprequire_once 'AopSdk.php';$aop = new AopClient ();$aop->appId = '填写您的appid';$aop->rsaPrivateKey = '填写您的私钥';$aop->alipayrsaPublicKey='填写您的支付宝公钥';$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';$aop->apiVersion = '1.0';$aop->signType = 'RSA2';$aop->postCharset='utf-8';$aop->format='json';$date=date("YmdHis");$arr=range(1000,9999);shuffle($arr);$request = new AlipayTradeQueryRequest ();$request->setBizContent("{" . "\"out_trade_no\":\"20150320010101004498\"," . "\"trade_no\":\"2019031222001494890500825908\"" . " }");$result = $aop->execute($request); //第三方调用//$result = $aop->execute($request,"","app_auth_token"); var_dump($result);返回的响应参数示例：
object(stdClass)[11] public 'alipay_trade_query_response' => object(stdClass)[9] public 'code' => string '10000' (length=5) public 'msg' => string 'Success' (length=7) public 'buyer_logon_id' => string 'uqq***@sandbox.com' (length=18) public 'buyer_pay_amount' => string '2.00' (length=4) public 'buyer_user_id' => string '2088102175794899' (length=16) public 'buyer_user_type' => string 'PRIVATE' (length=7) public 'fund_bill_list' => array (size=1) 0 => object(stdClass)[10] ... public 'invoice_amount' => string '2.00' (length=4) public 'out_trade_no' => string '20150320010101004498' (length=20) public 'point_amount' => string '0.00' (length=4) public 'receipt_amount' => string '2.00' (length=4) public 'send_pay_date' => string '2019-03-12 10:50:09' (length=19) public 'total_amount' => string '2.00' (length=4) public 'trade_no' => string '2019031222001494890500825908' (length=28) public 'trade_status' => string 'TRADE_SUCCESS' (length=13) public 'sign' => string 'gK9/bRceHVXou0vX4U+GgQv+F9pgL15lDtpQqR/y2glaWywOvYUsmV1/5UpbVFOP28yXHMEQJxqwp8j81GuF8zQsXlYmdlaOgZ0BaTa3Eh82zftejcRkIwgiLhUg3ZQBfbpjExgazhF0CvGoNaauyIfoKICJF61vsvN0ISAOXEPze+/XVmzjTueFUn3OWoknaD/mxtlGYOe67AU5vc+ueOUklaxis0ERivJB+eo9DWUDA3NzRvms2arkaQ3BEdZ4+HMMI4wK94RxpUchMbZHmta+msMTSpDtRRxWgr9gT9XFw59ZgYr/rpZYPCHKAAp/RbhzOLpnpBlAE/eqLSZqeA==' (length=344)
4、.NET版请求示例
IAopClient client = new DefaultAopClient(config.gatewayUrl, config.app_id, config.private_key, "json", "1.0", "RSA2", config.alipay_public_key, config.charset, false); AlipayTradeQueryRequest request = new AlipayTradeQueryRequest(); request.BizContent = "{" + "\"out_trade_no\":\"20150320010101004498\"," + "\"trade_no\":\"2019031222001494890500825908\"" + "}"; AlipayTradeQueryResponse response = client.Execute(request); Console.WriteLine(response.Body);返回的响应参数示例：
{"alipay_trade_query_response":{"code":"10000","msg":"Success","buyer_logon_id":"uqq***@sandbox.com","buyer_pay_amount":"2.00","buyer_user_id":"2088102175794899","buyer_user_type":"PRIVATE","fund_bill_list":[{"amount":"2.00","fund_channel":"ALIPAYACCOUNT"}],"invoice_amount":"2.00","out_trade_no":"20150320010101004498","point_amount":"0.00","receipt_amount":"2.00","send_pay_date":"2019-03-12 10:50:09","total_amount":"2.00","trade_no":"2019031222001494890500825908","trade_status":"TRADE_SUCCESS"},"sign":"gK9/bRceHVXou0vX4U+GgQv+F9pgL15lDtpQqR/y2glaWywOvYUsmV1/5UpbVFOP28yXHMEQJxqwp8j81GuF8zQsXlYmdlaOgZ0BaTa3Eh82zftejcRkIwgiLhUg3ZQBfbpjExgazhF0CvGoNaauyIfoKICJF61vsvN0ISAOXEPze+/XVmzjTueFUn3OWoknaD/mxtlGYOe67AU5vc+ueOUklaxis0ERivJB+eo9DWUDA3NzRvms2arkaQ3BEdZ4+HMMI4wK94RxpUchMbZHmta+msMTSpDtRRxWgr9gT9XFw59ZgYr/rpZYPCHKAAp/RbhzOLpnpBlAE/eqLSZqeA=="}四、注意事项
1、如何判断交易状态
根据接口返回响应参数trade_status（交易状态）进行判断，详见trade_status参数分析如下：
支付宝交易状态快速掌握：[url]https://openclub.alipay.com/read.php?tid=1295&fid=72[/url]
交易状态问题解析：[url]https://openclub.alipay.com/read.php?tid=5407&fid=72[/url]
2、如何判断用户支付渠道
根据接口返回响应参数fund_bill_list（交易支付使用的资金渠道）的fund_channel（交易使用的资金渠道参数）进行判断：
fund_channel返回对应渠道参考：[url]https://alipay.open.taobao.com/doc2/detail?treeId=26&articleId=103259&docType=1[/url]
五、常见报错
1、Q：报错ACQ.TRADE_NOT_EXIST（交易不存在）？
A：解决方案:[url]https://openclub.alipay.com/read.php?tid=13844&fid=56[/url]
如果还是报错，请按如下方式进行提问：
正确提问方式：使用环境（沙箱还是正式环境）+接口名称（中文+英文）+ 请求参数 + 报错信息详情
