微信支付订单号查询订单

更新时间:2025.02.20

订单支付成功后,商户可通过微信交易订单号或使用商户订单号查询订单;若订单未支付,则只能使用商户订单号查询订单

接口说明

支持商户:【普通商户】

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

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

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


path  路径参数

 transaction_id  必填   string(32)

【微信支付订单号】 微信支付侧订单的唯一标识,订单支付成功后,支付成功回调通知商户订单号查询订单会返回该参数。


query 查询参数

mchid  必填 string(32)

【商户号】商户下单时传入的商户号。

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/pay/transactions/id/1217752501201407033233368018?mchid=1230000109 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

 appid  必填  string(32)

【公众账号ID】商户下单时传入的公众账号ID。


 mchid  必填  string(32)

【商户号】商户下单时传入的商户号。


 out_trade_no  必填  string(32)

【商户订单号】商户下单时传入的商户系统内部订单号。


 transaction_id  必填  string(32)

【微信支付订单号】 微信支付侧订单的唯一标识。


 trade_type  必填   string(16)

【交易类型】 返回当前订单的交易类型,枚举值:

  • JSAPI:公众号支付、小程序支付

  • NATIVE:Native支付

  • APP:APP支付

  • MICROPAY:付款码支付

  • MWEB:H5支付

  • FACEPAY:刷脸支付


 trade_state  必填   string(32)

【交易状态】 返回订单当前交易状态。详细业务流转状态处理请参考开发指引-订单状态流转图。枚举值:

  • SUCCESS:支付成功

  • REFUND:转入退款

  • NOTPAY:未支付

  • CLOSED:已关闭

  • REVOKED:已撤销(仅付款码支付会返回)

  • USERPAYING:用户支付中(仅付款码支付会返回)

  • PAYERROR:支付失败(仅付款码支付会返回)


 trade_state_desc  必填   string(256)

【交易状态描述】 对交易状态的详细说明。


 bank_type  选填  string(32)

【银行类型】 用户支付方式说明,订单支付成功后返回,格式为银行简码_具体类型(DEBIT借记卡/CREDIT信用卡/ECNY数字人民币),例如ICBC_DEBIT代表工商银行借记卡,非银行卡支付类型(例如余额/零钱通等)统一为OTHERS,具体请参考《银行类型对照表》。


 attach  选填  string(128)

【商户数据包】商户下单时传入的自定义数据包,用户不可见,长度不超过128字符,若下单传入该参数,则订单支付成功后此接口和支付成功回调通知以及交易账单中会原样返回;若下单未传该参数,则不会返回。


 success_time  选填  string(64)

【支付完成时间】 

1、定义:用户完成订单支付的时间。该参数在订单支付成功后返回。

2、格式遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONEyyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。

示例:2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。


 payer   选填   object

【支付者信息】 订单的支付者信息。

属性

 openid  选填  string(128)

【用户标识】用户在商户下单的appid下唯一标识。


 amount  选填   object

【订单金额】 订单金额信息。

属性

 total  选填    integer

【总金额】 订单总金额,单位为分,整型。


 payer_total  选填   integer

【用户支付金额】用户实际支付金额,整型,单位为分,用户支付金额=总金额-代金券金额。


 currency  选填   string(16)

【货币类型】固定返回:CNY,代表人民币。


 payer_currency  选填    string(16)

【用户支付币种】 订单支付成功后固定返回:CNY,代表人民币。


 scene_info  选填   object

【场景信息】 下单时传入的支付场景描述,若下单传入该参数,则原样返回;若下单未传该参数,则不会返回。

属性

 device_id  必填   string(32)

【商户端设备号】 商户下单时传入的商户端设备号(门店号或收银设备ID)。


 promotion_detail  选填   array[object]

【优惠功能】 代金券信息,当订单有使用代金券时,该字段将返回所使用的代金券信息。

属性

 coupon_id  必填  string(32)

【券ID】 代金券id,微信为代金券分配的唯一标识,创券商户调用发放指定批次的代金券时返回的代金券ID coupon_id。


 name  必填   string(64)

【优惠名称】 优惠名称,创券商户创建代金券批次时传入的批次名称stock_name。


 scope  选填  string(32)

【优惠范围】优惠活动中代金券的适用范围,分为两种类型:
1、GLOBAL:全场代金券-以订单整体可优惠的金额为优惠门槛的代金券;
2、SINGLE:单品优惠-以订单中具体某个单品的总金额为优惠门槛的代金券


 type  选填  string(32)

【优惠类型】代金券资金类型,优惠活动中代金券的结算资金类型,分为两种类型:
1、CASH:预充值-带有结算资金的代金券,会随订单结算给订单收款商户;
2、NOCASH:免充值-不带有结算资金的代金券,无资金结算给订单收款商户。


 amount  必填   integer

【优惠券面额】代金券优惠的金额。


 stock_id  选填   string(32)

【活动ID】单张代金券所对应的批次号


 wechatpay_contribute  选填   integer

【微信出资】 代金券有三种出资类型:微信出资、商户出资和其他出资。本参数将返回选择“微信出资类型”时的优惠券面额。
1、创建代金券后默认为商户出资类型。如需使用其他两种类型,请与相关行业运营进行沟通。
2、在 wechatpay_contribute、merchant_contribute 和 other_contribute 这三个字段中,仅有一个字段会返回出资金额。具体返回哪个字段取决于代金券批次的配置。


 merchant_contribute  选填   integer

【商户出资】代金券有三种出资类型:微信出资、商户出资和其他出资。本参数将返回选择“商户出资类型”时的优惠券面额。
1、创建代金券后默认为商户出资类型。如需使用其他两种类型,请与相关行业运营进行沟通。
2、在 wechatpay_contribute、merchant_contribute 和 other_contribute 这三个字段中,仅有一个字段会返回出资金额。具体返回哪个字段取决于代金券批次的配置。


 other_contribute  选填   integer

【其他出资】代金券有三种出资类型:微信出资、商户出资和其他出资。本参数将返回选择“其他出资类型”时的优惠券面额。
1、创建代金券后默认为商户出资类型。如需使用其他两种类型,请与相关行业运营进行沟通。
2、在 wechatpay_contribute、merchant_contribute 和 other_contribute 这三个字段中,仅有一个字段会返回出资金额。具体返回哪个字段取决于代金券批次的配置。


 currency  选填   string(16)

【优惠币种】 代金券金额所对应的货币种类:固定为:CNY,人民币。


 goods_detail  选填   array[object]

【单品列表】 单品列表。scopeSINGLE(单品优惠)时返回该参数

属性

 goods_id  必填   string(32)

【商品编码】 商品编码。


 quantity  必填   integer

【商品数量】 商品数量。


 unit_price  必填   integer

【商品单价】 商品单价,单位为分。


 discount_amount  必填   integer

【商品优惠金额】 商品优惠金额。


 goods_remark  选填   string(128)

【商品备注】 商品备注。创券商户在商户平台创建单品券时,若设置了商品备注则会返回。

应答示例

200 OK

1{
2  "appid" : "wxd678efh567hg6787",
3  "mchid" : "1230000109",
4  "out_trade_no" : "1217752501201407033233368018",
5  "transaction_id" : "1217752501201407033233368018",
6  "trade_type" : "MICROPAY",
7  "trade_state" : "SUCCESS",
8  "trade_state_desc" : "支付成功",
9  "bank_type" : "CMC",
10  "attach" : "自定义数据",
11  "success_time" : "2018-06-08T10:34:56+08:00",
12  "payer" : {
13    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
14  },
15  "amount" : {
16    "total" : 100,
17    "payer_total" : 100,
18    "currency" : "CNY",
19    "payer_currency" : "CNY"
20  },
21  "scene_info" : {
22    "device_id" : "013467007045764"
23  },
24  "promotion_detail" : [
25    {
26      "coupon_id" : "109519",
27      "name" : "单品惠-6",
28      "scope" : "GLOBAL",
29      "type" : "CASH",
30      "amount" : 100,
31      "stock_id" : "931386",
32      "wechatpay_contribute" : 0,
33      "merchant_contribute" : 0,
34      "other_contribute" : 0,
35      "currency" : "CNY",
36      "goods_detail" : [
37        {
38          "goods_id" : "M1006",
39          "quantity" : 1,
40          "unit_price" : 100,
41          "discount_amount" : 1,
42          "goods_remark" : "商品备注信息"
43        }
44      ]
45    }
46  ]
47}
48

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则 检查

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题 排查

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

无效请求

请根据接口返回的详细信息检查

400

MCH_NOT_EXISTS

商户号不存在

请检查商户号是否正确,商户号获取方式请参考普通商户模式开发必要参数说明

401

SIGN_ERROR

签名错误

请检查签名参数和方法是否都符合签名算法要求,参考:如何生成签名

403

RULE_LIMIT

业务规则限制

因业务规则限制请求频率,请查看接口返回的详细信息

403

TRADE_ERROR

交易错误

因业务原因交易失败,请查看接口返回的详细信息

404

ORDER_NOT_EXIST

订单不存在

请检查传入的微信支付订单号是否正确

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

500

SYSTEM_ERROR

系统错误

系统异常,请用相同参数重新调用

 

 

元宝AI
反馈
目录
置顶