---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012791837.md"
title: "微信支付订单号查询订单"
doc_id: 4012791837
---

>更新时间：2024.12.27

订单支付成功后，商户可通过微信交易订单号或使用[商户订单号查询订单](https://pay.weixin.qq.com/doc/v3/merchant/4013070356.md)；若订单未支付，则只能使用[商户订单号查询订单](https://pay.weixin.qq.com/doc/v3/merchant/4013070356.md)。




## 接口说明

支持商户：【普通商户】

请求方式：【GET】 `/v3/pay/transactions/id/{transaction_id}`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#1.1-%E8%AF%B7%E6%B1%82%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E6%8E%A5%E5%8F%A3) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| transaction_id | string(32) | true | 【微信支付订单号】 微信支付侧订单的唯一标识，订单支付成功后， [支付成功回调通知](https://pay.weixin.qq.com/doc/v3/merchant/4013070368.md) 和 [商户订单号查询订单](https://pay.weixin.qq.com/doc/v3/merchant/4013070356.md) 会返回该参数。 |
### Query 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| mchid | string(32) | true | 【商户号】商户下单时传入的商户号。 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| appid | string(32) | true | 【公众账号ID】商户下单时传入的公众账号ID。 |
| mchid | string(32) | true | 【商户号】商户下单时传入的商户号。 |
| out_trade_no | string(32) | true | 【商户订单号】商户下单时传入的商户系统内部订单号。 |
| transaction_id | string(32) | true | 【微信支付订单号】 微信支付侧订单的唯一标识。 |
| trade_type | string(16) | true | 【交易类型】 返回当前订单的交易类型，枚举值：<br><ul><li>JSAPI：公众号支付、小程序支付</li><li>NATIVE：Native支付</li><li>APP：APP支付</li><li>MICROPAY：付款码支付</li><li>MWEB：H5支付</li><li>FACEPAY：刷脸支付</li></ul> |
| trade_state | string(32) | true | 【交易状态】 返回订单当前交易状态。详细业务流转状态处理请参考开发指引-订单状态流转图。枚举值：<br><ul><li>SUCCESS：支付成功</li><li>REFUND：转入退款</li><li>NOTPAY：未支付</li><li>CLOSED：已关闭</li><li>REVOKED：已撤销（仅付款码支付会返回）</li><li>USERPAYING：用户支付中（仅付款码支付会返回）</li><li>PAYERROR：支付失败（仅付款码支付会返回）</li></ul> |
| trade_state_desc | string(256) | true | 【交易状态描述】 对交易状态的详细说明。 |
| bank_type | string(32) | false | 【银行类型】用户支付方式说明，订单支付成功后返回，格式为银行简码\_具体类型(DEBIT借记卡/CREDIT信用卡/ECNY数字人民币)，例如ICBC\_DEBIT代表工商银行借记卡，非银行卡支付类型(例如余额/零钱通等)统一为OTHERS，具体请参考《[银行类型对照表](https://pay.weixin.qq.com/doc/v3/merchant/4012076355.md)》。 |
| attach | string(128) | false | 【商户数据包】商户下单时传入的自定义数据包，用户不可见，长度不超过128字符，若下单传入该参数，则订单支付成功后此接口和 [支付成功回调通知](https://pay.weixin.qq.com/doc/v3/merchant/4013070368.md) 以及 [交易账单](https://pay.weixin.qq.com/doc/v3/merchant/4013071246.md) 中会原样返回；若下单未传该参数，则不会返回。 |
| success_time | string(64) | false | 【支付完成时间】<br>1、定义：用户完成订单支付的时间。该参数在订单支付成功后返回。<br>2、格式：遵循[rfc3339](https://datatracker.ietf.org/doc/html/rfc3339)标准格式： `yyyy-MM-DDTHH:mm:ss+TIMEZONE`。 `yyyy-MM-DD` 表示年月日； `T` 字符用于分隔日期和时间部分； `HH:mm:ss` 表示具体的时分秒； `TIMEZONE` 表示时区（例如， `+08:00` 对应东八区时间，即北京时间）。<br>示例： `2015-05-20T13:29:35+08:00` 表示北京时间2015年5月20日13点29分35秒。 |
| payer | object | false | 【支付者信息】 订单的支付者信息。 |
| payer.openid | string(128) | false | 【用户标识】用户在商户下单的appid下唯一标识。 |
| amount | object | false | 【订单金额】 订单金额信息。 |
| amount.total | integer | false | 【总金额】订单总金额，单位为分，整型。 |
| amount.payer_total | integer | false | 【用户支付金额】用户实际支付金额，整型，单位为分，用户支付金额=总金额-[代金券](https://pay.weixin.qq.com/doc/v3/merchant/4012084079.md)金额。 |
| amount.currency | string(16) | false | 【货币类型】固定返回：CNY，代表人民币。 |
| amount.payer_currency | string(16) | false | 【用户支付币种】 订单支付成功后固定返回：CNY，代表人民币。 |
| scene_info | object | false | 【场景信息】 下单时传入的支付场景描述，若下单传入该参数，则原样返回；若下单未传该参数，则不会返回。 |
| scene_info.device_id | string(32) | true | 【商户端设备号】 商户下单时传入的商户端设备号（门店号或收银设备ID）。 |
| promotion_detail | array[object] | false | 【优惠功能】 [代金券](https://pay.weixin.qq.com/doc/v3/merchant/4012084079.md) 信息，当订单有使用代金券时，该字段将返回所使用的代金券信息。 |
| promotion_detail.coupon_id | string(32) | true | 【券ID】 代金券id，微信为代金券分配的唯一标识，创券商户调用[发放指定批次的代金券](https://pay.weixin.qq.com/doc/v3/merchant/4012463767.md)时返回的代金券ID coupon\_id。 |
| promotion_detail.name | string(64) | true | 【优惠名称】 优惠名称，创券商户[创建代金券批次](https://pay.weixin.qq.com/doc/v3/merchant/4012534633.md)时传入的批次名称stock\_name。 |
| promotion_detail.scope | string(32) | false | 【优惠范围】优惠活动中代金券的适用范围，分为两种类型：<br>1、GLOBAL：全场代金券-以订单整体可优惠的金额为优惠门槛的代金券；<br>2、SINGLE：单品优惠-以订单中具体某个单品的总金额为优惠门槛的代金券 |
| promotion_detail.type | string(32) | false | 【优惠类型】代金券资金类型，优惠活动中代金券的结算资金类型，分为两种类型：<br>1、CASH：预充值-带有结算资金的代金券，会随订单结算给订单收款商户；<br>2、NOCASH：免充值-不带有结算资金的代金券，无资金结算给订单收款商户。 |
| promotion_detail.amount | integer | true | 【优惠券面额】代金券优惠的金额。 |
| promotion_detail.stock_id | string(32) | false | 【活动ID】单张代金券所对应的批次号 |
| promotion_detail.wechatpay_contribute | integer | false | 【微信出资】 代金券有三种出资类型：微信出资、商户出资和其他出资。本参数将返回选择“微信出资类型”时的优惠券面额。<br>1、创建代金券后默认为商户出资类型。如需使用其他两种类型，请与相关行业运营进行沟通。<br>2、在 wechatpay\_contribute、merchant\_contribute 和 other\_contribute 这三个字段中，仅有一个字段会返回出资金额。具体返回哪个字段取决于代金券批次的配置。 |
| promotion_detail.merchant_contribute | integer | false | 【商户出资】代金券有三种出资类型：微信出资、商户出资和其他出资。本参数将返回选择“商户出资类型”时的优惠券面额。<br>1、创建代金券后默认为商户出资类型。如需使用其他两种类型，请与相关行业运营进行沟通。<br>2、在 wechatpay\_contribute、merchant\_contribute 和 other\_contribute 这三个字段中，仅有一个字段会返回出资金额。具体返回哪个字段取决于代金券批次的配置。 |
| promotion_detail.other_contribute | integer | false | 【其他出资】代金券有三种出资类型：微信出资、商户出资和其他出资。本参数将返回选择“其他出资类型”时的优惠券面额。<br>1、创建代金券后默认为商户出资类型。如需使用其他两种类型，请与相关行业运营进行沟通。<br>2、在 wechatpay\_contribute、merchant\_contribute 和 other\_contribute 这三个字段中，仅有一个字段会返回出资金额。具体返回哪个字段取决于代金券批次的配置。 |
| promotion_detail.currency | string(16) | false | 【优惠币种】 代金券金额所对应的货币种类：固定为：CNY，人民币。 |
| promotion_detail.goods_detail | array[object] | false | 【单品列表】 单品列表。scope为SINGLE（单品优惠）时返回该参数 |
| promotion_detail.goods_detail.goods_id | string(32) | true | 【商品编码】 商品编码。 |
| promotion_detail.goods_detail.quantity | integer | true | 【商品数量】 商品数量。 |
| promotion_detail.goods_detail.unit_price | integer | true | 【商品单价】 商品单价，单位为分。 |
| promotion_detail.goods_detail.discount_amount | integer | true | 【商品优惠金额】 商品优惠金额。 |
| promotion_detail.goods_detail.goods_remark | string(128) | false | 【商品备注】 商品备注。创券商户在商户平台创建单品券时，若设置了商品备注则会返回。 |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) 检查 |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012365347.md) 排查 |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | INVALID\_REQUEST | 无效请求 | 请根据接口返回的详细信息检查 |
| 400 | MCH\_NOT\_EXISTS | 商户号不存在 | 请检查商户号是否正确，商户号获取方式请参考[普通商户模式开发必要参数说明](https://pay.weixin.qq.com/doc/v3/merchant/4013070756.md) |
| 401 | SIGN\_ERROR | 签名错误 | 请检查签名参数和方法是否都符合签名算法要求，参考：[如何生成签名](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#2.-%E4%BB%80%E4%B9%88%E6%97%B6%E5%80%99%E9%9C%80%E8%A6%81%E9%AA%8C%E7%AD%BE%EF%BC%9F%E5%A6%82%E4%BD%95%E9%AA%8C%E7%AD%BE%EF%BC%9F) |
| 403 | RULE\_LIMIT | 业务规则限制 | 因业务规则限制请求频率，请查看接口返回的详细信息 |
| 403 | TRADE\_ERROR | 交易错误 | 因业务原因交易失败，请查看接口返回的详细信息 |
| 404 | ORDER\_NOT\_EXIST | 订单不存在 | 请检查传入的微信支付订单号是否正确 |
| 429 | FREQUENCY\_LIMITED | 频率超限 | 请降低请求接口频率 |
| 500 | SYSTEM\_ERROR | 系统错误 | 系统异常，请用相同参数重新调用 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012791837-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012791837-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012791837-go.md)


应答示例

> 200 OK

```
{
  "appid" : "wxd678efh567hg6787",
  "mchid" : "1230000109",
  "out_trade_no" : "1217752501201407033233368018",
  "transaction_id" : "1217752501201407033233368018",
  "trade_type" : "MICROPAY",
  "trade_state" : "SUCCESS",
  "trade_state_desc" : "支付成功",
  "bank_type" : "CMC",
  "attach" : "自定义数据",
  "success_time" : "2018-06-08T10:34:56+08:00",
  "payer" : {
    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
  },
  "amount" : {
    "total" : 100,
    "payer_total" : 100,
    "currency" : "CNY",
    "payer_currency" : "CNY"
  },
  "scene_info" : {
    "device_id" : "013467007045764"
  },
  "promotion_detail" : [
    {
      "coupon_id" : "109519",
      "name" : "单品惠-6",
      "scope" : "GLOBAL",
      "type" : "CASH",
      "amount" : 100,
      "stock_id" : "931386",
      "wechatpay_contribute" : 0,
      "merchant_contribute" : 0,
      "other_contribute" : 0,
      "currency" : "CNY",
      "goods_detail" : [
        {
          "goods_id" : "M1006",
          "quantity" : 1,
          "unit_price" : 100,
          "discount_amount" : 1,
          "goods_remark" : "商品备注信息"
        }
      ]
    }
  ]
}

```
