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

>更新时间：2026.04.24

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

注意：

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

- 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；


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


- 调用付款码支付API，返回USERPAYING的状态；


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




## 接口说明

适用对象：直连商户

请求URL： https://api.mch.weixin.qq.com/pay/orderquery

URL地址： https://api2.mch.weixin.qq.com/pay/orderquery(备用域名)[见跨城冗灾方案](https://pay.weixin.qq.com/doc/v2/merchant/4011984887.md)

请求方式： POST

数据格式： XML

是否需要证书： 否

## 请求参数

| 参数名 | 变量 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- | --- |
| 公众账号ID | appid | string\[1,32\] | 是 | 由微信生成的应用ID，全局唯一。<br>请求查单接口时请注意APPID的应用属性，例如公众号场景下，需使用应用属性为公众号的APPID<br>示例值：wx8888888888888888 |
| 商户号 | mch\_id | string\[1,32\] | 是 | 微信支付分配的商户号<br>示例值：1900000109 |
| 微信订单号 | transaction\_id | string\[1,32\] | 二选一 | 微信的订单号，建议优先使用<br>示例值：1009660380201506130728806387 |
| 随机字符串 | nonce\_str | string\[1,32\] | 是 | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md)<br>示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 签名 | sign | string\[1,32\] | 是 | 签名，[详见签名生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md)<br>示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 签名类型 | sign\_type | string\[1,32\] | 否 | 签名类型，目前支持HMAC-SHA256和MD5，默认为MD5<br>示例值：HMAC-SHA256 |

## 请求示例：

XML

```
<xml>
  <appid>wx8888888888888888</appid>
  <mch_id>1900000109</mch_id>
  <transaction_id>1008450740201411110005820873</transaction_id>
  <nonce_str>5K8264ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>
  <sign>C380BEC2BFD727A4B6845133519F3AD6</sign>
</xml>
```

## 返回参数

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

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

| 参数名 | 变量 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- | --- |
| 应用ID | appid | string\[1,32\] | 是 | 由微信生成的应用ID，全局唯一。<br>请求查单接口时请注意APPID的应用属性，例如公众号场景下，需使用应用属性为公众号的APPID<br>示例值：wx8888888888888888 |
| 商户号 | mch\_id | string\[1,32\] | 是 | 微信支付分配的商户号<br>示例值：1900000109 |
| 随机字符串 | nonce\_str | string\[1,32\] | 是 | 随机字符串，不长于32位。推荐[随机数生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md)<br>示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 签名 | sign | string\[1,32\] | 是 | 签名，[详见签名生成算法](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md)<br>示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 业务结果 | result\_code | string\[1,16\] | 是 | SUCCESS/FAIL<br>示例值：SUCCESS |
| 错误代码 | err\_code | string\[1,32\] | 否 | 当result\_code为FAIL时返回错误代码，详细参见下文错误列表<br>示例值：SYSTEMERROR |
| 错误代码描述 | err\_code\_des | string\[1,128\] | 否 | 当result\_code为FAIL时返回错误描述，详细参见下文错误列表<br>示例值：系统错误 |

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

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

| 参数名 | 变量 | 类型 | 必填 | 描述 |
| :-- | :-- | :-- | :-- | :-- |
| 设备号 | device\_info | string\[1,32\] | 否 | 调用接口提交的终端设备号，<br>示例值：013467007045764 |
| 用户标识 | openid | string\[1,128\] | 否 | 用户在主商户appid下的唯一标识<br>示例值：oUpF8uMuAJO\_M2pxb1Q9zNjWeS6o |
| 该字段已废弃 | is\_subscribe | string\[1,1\] | 是 | 已废弃，默认统一返回N<br>示例值：N |
| 交易类型 | trade\_type | string\[1,16\] | 是 | JSAPI：JSAPI支付（或小程序支付）<br>NATIVE：Native支付<br>APP：APP支付<br>MWEB：H5支付<br>PAP：委托代扣<br>示例值：PAP |
| 交易状态 | trade\_state | string\[1,32\] | 是 | SUCCESS：支付成功<br>REFUND：转入退款<br>NOTPAY：未支付<br>CLOSED：已关闭<br>REVOKED：已撤销(刷卡支付)<br>USERPAYING：用户支付中<br>PAYERROR：支付失败(其他原因，如银行返回失败)<br>ACCEPT：已接收，等待扣款<br>示例值：SUCCESS |
| 付款银行 | bank\_type | string\[1,32\] | 是 | 银行类型，采用字符串类型的[银行标识](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md)<br>示例值：CMC |
| 商品详情 | detail | string\[1,8192\] | 否 | 商品详细列表，使用Json格式。如果使用了单品优惠，会有单品优惠信息返回 |
| 单品列表 | goods\_detail | string\[1,8192\] | 否 | 单品信息，使用Json数组格式提交 |
| 商品编码 | goods\_id | string\[1,32\] | 是 | 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成<br>示例值：SZTX001 |
| 微信支付商品编码 | wxpay\_goods\_id | string\[1,32\] | 否 | 微信支付定义的统一商品编号（没有可不传）<br>示例值：1001 |
| 商品名称 | goods\_name | string\[1,6\] | 否 | 商品的实际名称<br>示例值：iPhone6s 16G |
| 商品数量 | quantity | int | 是 | 用户购买的数量<br>示例值：1 |
| 商品单价 | price | int | 是 | 单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50)<br>示例值：100 |
| 总金额 | total\_fee | int | 是 | 订单总金额，单位为分<br>示例值：100 |
| 货币种类 | fee\_type | string\[1,8\] | 否 | 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见[货币类型](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md)<br>示例值：CNY |
| 应结订单金额 | settlement\_total\_fee | int | 否 | 当订单使用了免充值型优惠券后返回该参数，应结订单金额=订单金额-免充值优惠券金额。<br>示例值：100 |
| 现金支付金额 | cash\_fee | int | 是 | 现金支付金额订单现金支付金额，详见[交易金额](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md)<br>示例值：100 |
| 现金支付货币类型 | cash\_fee\_type | string\[1,16\] | 否 | 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见[货币类型](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md)<br>示例值：CNY |
| 代金券金额 | coupon\_fee | int | 否 | “代金券或立减优惠”金额<=订单总金额，订单总金额-“代金券或立减优惠”金额=现金支付金额，详见[交易金额](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md)<br>示例值：100 |
| 代金券使用数量 | coupon\_count | int | 否 | 代金券或立减优惠使用数量<br>示例值：1 |
| 代金券ID | coupon\_id\_$n | string\[1,20\] | 否 | 代金券或立减优惠ID, $n为下标，从0开始编号<br>示例值：10000 |
| 代金券类型 | coupon\_type\_$n | String | 否 | CASH：充值代金券<br>NO\_CASH：非充值优惠券<br>开通免充值券功能，并且订单使用了优惠券后有返回（取值：CASH、NO\_CASH）。$n为下标,从0开始编号，举例：coupon\_type\_$0<br>示例值：CASH |
| 单个代金券金额 | coupon\_fee\_$n | int | 否 | 单个代金券或立减优惠支付金额, $n为下标，从0开始编号<br>示例值：100 |
| 微信支付订单号 | transaction\_id | string\[1,32\] | 是 | 微信支付订单号<br>示例值：1217752501201407033233368018 |
| 附加数据 | attach | string\[1,128\] | 否 | 附加数据，原样返回<br>示例值：123456 |
| 支付完成时间 | time\_end | string\[1,14\] | 是 | 订单支付时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见[时间规则](https://pay.weixin.qq.com/doc/v2/merchant/4011941162.md)<br>示例值：20141030133525 |
| 交易状态描述 | trade\_state\_desc | string\[1,256\] | 是 | 对当前查询订单状态的描述和下一步操作的指引<br>示例值：支付失败，请重新下单支付 |

## 返回示例：

正常示例

```

<xml>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></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 | 退款订单查询失败 | 系统异常，请再调用发起查询 |