---
url: "https://pay.weixin.qq.com/doc/v2/partner/4011989256.md"
title: "查询订单"
doc_id: 4011989256
---

>更新时间：2024.12.18

## 应用场景

该接口提供所有微信支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。

需要调用查询接口的情况：

◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知（查单实现可参考：[支付回调和查单实现指引](https://pay.weixin.qq.com/doc/v2/partner/4011984698.md)）；

◆ 调用支付接口后，返回系统错误或未知交易状态情况；

◆ 调用被扫支付API，返回USERPAYING的状态；

◆ 调用关单或撤销接口API之前，需确认支付状态；

## 接口链接

https://api.mch.weixin.qq.com/pay/orderquery

## 是否需要证书

不需要

## 请求参数

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 服务商的APPID | appid | 是 | String(32) | wx8888888888888888 | 服务商商户的APPID |
| 子商户公众账号ID | sub\_appid | 否 | String(32) | wx8888888888888888 | 微信分配的子商户公众账号ID |
| 商户号 | mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的商户号 |
| 子商户号 | sub\_mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的子商户号 |
| 微信订单号 | transaction\_id | 二选一 | String(32) | 013467007045764 | 微信的订单号，优先使用 |
| 随机字符串 | nonce\_str | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |
| 签名 | sign | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 签名，[详见签名生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |

举例如下：

```
<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <sub_appid>wx2421b1c4370ec43b</sub_appid>
   <mch_id>10000100</mch_id>
   <sub_mch_id>1900000109</sub_mch_id>
   <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
   <transaction_id>1008450740201411110005820873</transaction_id>
   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>
```

## 返回结果

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 返回状态码 | return\_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL<br>此字段是通信标识，非交易标识，交易是否成功需要查看trade\_state来判断 |
| 返回信息 | return\_msg | 否 | String(128) | 签名失败 | 返回信息，如非空，为错误原因，例如：签名失败、参数格式校验错误 |

以下字段在return\_code为SUCCESS的时候有返回

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 服务商的APPID | appid | 是 | String(32) | wx8888888888888888 | 服务商商户的APPID |
| 商户号 | mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的商户号 |
| 子商户公众账号ID | sub\_appid | 否 | String(32) | wx8888888888888888 | 微信分配的子商户公众账号ID |
| 子商户号 | sub\_mch\_id | 是 | String(32) | 1900000109 | 微信支付分配的子商户号 |
| 随机字符串 | nonce\_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名，详见[签名生成算法](https://pay.weixin.qq.com/doc/v2/partner/4011985884.md) |
| 业务结果 | result\_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 错误代码 | err\_code | 否 | String(32) | SYSTEMERROR | 详细参见第6节错误列表 |
| 错误代码描述 | err\_code\_des | 否 | String(128) | 系统错误 | 结果信息描述 |

以下字段在return\_code 、result\_code、trade\_state都为SUCCESS时有返回 。

交易成功判断条件： return\_code、result\_code和trade\_state都为SUCCESS

| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- | --- | --- |
| 设备号 | device\_info | 否 | String(32) | 013467007045764 | 微信支付分配的终端设备号， |
| 用户标识 | openid | 是 | String(128) | wxd930ea5d5a258f4f | 用户在商户appid下的唯一标识 |
| 该字段已废弃 | is\_subscribe | 是 | String(1) | N | 已废弃，默认统一返回N |
| 用户子标识 | sub\_openid | 否 | String(128) | wxd930ea5d5a258f4f | 用户在子商户appid下的唯一标识 |
| 该字段已废弃 | sub\_is\_subscribe | 否 | String(1) | N | 已废弃，默认统一返回N |
| 交易类型 | trade\_type | 是 | String(16) | JSAPI | 调用接口提交的交易类型，取值如下：JSAPI，NATIVE，APP，MICROPAY，详细说明见[参数规定](https://pay.weixin.qq.com/doc/v2/partner/4011941200.md) |
| 交易状态 | trade\_state | 是 | String(32) | SUCCESS | SUCCESS--支付成功<br>REFUND--转入退款<br>NOTPAY--未支付<br>CLOSED--已关闭<br>REVOKED--已撤销(刷卡支付)<br>USERPAYING--用户支付中<br>PAYERROR--支付失败(其他原因，如银行返回失败)<br>ACCEPT--已接收，等待扣款(委托代扣) |
| 付款银行 | bank\_type | 是 | String(32) | CMC | 银行类型，采用字符串类型的银行标识 |
| 商品详情 | detail | 否 | String(8192) | {<br>"discount\_detail":\[<br>{<br>"goods\_id":"iphone6s\_16G",<br>"goods\_name":"iPhone6s 16G",<br>"coupon\_batch\_id":888,<br>"coupon\_id":666888,<br>"coupon\_fee":1000<br>},<br>{<br>"goods\_id":"iphone6s\_32G",<br>"goods\_name":"iPhone6s 32G",<br>"coupon\_batch\_id":999,<br>"coupon\_id":666999,<br>"coupon\_fee":1500<br>}<br>\]<br>} | 商品详细列表，使用Json格式，传输签名前请务必使用CDATA标签将JSON文本串保护起来。如果使用了单品优惠，会有单品优惠信息返回<br>discount\_detail \[\]：<br>└ goods\_id String 必填 32 商品的编号<br>└ goods\_name String 必填 256 商品名称<br>└ coupon\_batch\_id String 必填 代金券批次ID<br>└ coupon\_id String 必填 代金卷ID<br>└ coupon\_fee int 必填 代金券支付金额，单位为分 |
| 标价金额 | total\_fee | 是 | int | 100 | 订单总金额，单位为分 |
| 标价币种 | fee\_type | 否 | String(8) | CNY | 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见[货币类型](https://pay.weixin.qq.com/doc/v2/partner/4011941200.md) |
| 应结订单金额 | settlement\_total\_fee | 否 | int | 100 | 当订单使用了免充值型优惠券后返回该参数，应结订单金额=订单金额-免充值优惠券金额。 |
| 现金支付金额 | cash\_fee | 是 | int | 100 | 现金支付金额订单现金支付金额，详见[支付金额](https://pay.weixin.qq.com/doc/v2/partner/4011941200.md) |
| 现金支付货币类型 | cash\_fee\_type | 否 | String(16) | CNY | 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见[货币类型](https://pay.weixin.qq.com/doc/v2/partner/4011941200.md) |
| 代金券金额 | coupon\_fee | 否 | int | 100 | “代金券或立减优惠”金额<=订单总金额，订单总金额-“代金券或立减优惠”金额=现金支付金额，详见[支付金额](https://pay.weixin.qq.com/doc/v2/partner/4011941200.md) |
| 代金券使用数量 | coupon\_count | 否 | int | 1 | 代金券或立减优惠使用数量 |
| 代金券ID | coupon\_id\_$n | 否 | String(20) | 10000 | 代金券或立减优惠ID, $n为下标，从0开始编号 |
| 代金券类型 | coupon\_type\_$n | 否 | String | CASH | CASH--充值代金券<br>NO\_CASH---非充值优惠券<br>开通免充值券功能，并且订单使用了优惠券后有返回（取值：CASH、NO\_CASH）。$n为下标,从0开始编号，举例：coupon\_type\_$0 |
| 单个代金券金额 | coupon\_fee\_$n | 否 | int | 100 | 单个代金券或立减优惠支付金额, $n为下标，从0开始编号 |
| 微信支付订单号 | transaction\_id | 是 | String(32) | 1217752501201407033233368018 | 微信支付侧订单的唯一标识，订单支付成功后返回。 |
| 商家数据包 | attach | 否 | String(128) | 123456 | 商家数据包，原样返回 |
| 支付完成时间 | time\_end | 是 | String(14) | 20141030133525 | 订单支付时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见[时间规则](https://pay.weixin.qq.com/doc/v2/partner/4011941200.md) |
| 交易状态描述 | trade\_state\_desc | 是 | String(256) | 支付失败，请重新下单支付 | 对当前查询订单状态的描述和下一步操作的指引 |

举例如下：

```
<xml>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></mch_id>
   <sub_mch_id><![CDATA[1900000109]]></sub_mch_id>
   <device_info><![CDATA[1000]]></device_info>
   <nonce_str><![CDATA[TN55wO9Pba5yENl8]]></nonce_str>
   <sign><![CDATA[BDF0099C15FF7BC6B1585FBB110AB635]]></sign>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid>
   <is_subscribe><![CDATA[N]]></is_subscribe>
   <trade_type><![CDATA[MICROPAY]]></trade_type>
   <bank_type><![CDATA[CCB_DEBIT]]></bank_type>
   <total_fee>1</total_fee>
   <fee_type><![CDATA[CNY]]></fee_type>
   <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
   <out_trade_no><![CDATA[1415757673]]></out_trade_no>
   <attach><![CDATA[订单额外描述]]></attach>
   <time_end><![CDATA[20141111170043]]></time_end>
   <trade_state><![CDATA[SUCCESS]]></trade_state>
</xml>
```

## 错误码

| 名称 | 描述 | 原因 | 解决方案 |
| --- | --- | --- | --- |
| ORDERNOTEXIST | 此交易订单号不存在 | 查询系统中不存在此交易订单号 | 该API只能查提交支付交易返回成功的订单，请商户检查需要查询的订单号是否正确 |
| SYSTEMERROR | 系统错误 | 后台系统返回错误 | 系统异常，请再调用发起查询 |