订单查询接口
接口链接:https://api.mch.weixin.qq.com/pay/orderquery
该接口提供所有微信支付订单的查询,当支付通知处理异常戒丢失的情冴,商户可以通过该接口查询订单支付状态。
请求参数:
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 公众账号 |
ID appid |
是 |
String(32) |
微信分配的公众账号 ID |
| 商户号 |
mch_id |
是 |
String(32) |
微信支付分配的商户号 |
| 微信订单号 |
transaction_id |
否 |
String(32) |
微信的订单号,优先使用 |
| 商户订单号 |
out_trade_no |
是 |
String(32) |
商户系统内部的订单号,transaction_id、 out_trade_no 二选一,如果同时存在优先级:transaction_id> out_trade_no |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串,不长于 32 位 |
| 签名 |
sign |
是 |
String(32) |
签名,详细签名方法见 3.2 节 |
同步返回结果:
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 返回状态码 |
return_code |
是 |
String(16) |
SUCCESS/FAIL此字段是通信标识,非交易标识,交易是否成功需要查看 trade_state 来判断 |
| 返回信息 |
return_msg |
否 |
String(128) |
返回信息,如非空,为错误原因签名失败参数格式校验错误 |
以下字段在 return_code 为 SUCCESS 的时候有返回
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 公众账号 ID |
appid |
是 |
String(32) |
微信分配的公众账号 ID |
| 商户号 |
mch_id |
是 |
String(32) |
微信支付分配的商户号 |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串,不长于 32 位 |
| 签名 |
sign |
是 |
String(32) |
签名,详细签名方法见 3.2 节 |
| 业务结果 |
result_code |
是 |
String(16) |
SUCCESS/FAIL |
| 错误代码 |
err_code |
否 |
String(32) |
错误码见第 6 节 |
| 错误代码描述 |
err_code_des |
否 |
String(128) |
结果信息描述 |
以下字段在 return_code 和 result_code 都为 SUCCESS 的时候有返回
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 交易状态 |
trade_state |
是 |
String(32) |
SUCCESS—支付成功 REFUND—转入退款 NOTPAY—未支付 CLOSED—已关闭 REVOKED—已撤销 USERPAYING--用户支付中 NOPAY--未支付(输入密码或确认支付超时) PAYERROR-- 支付失败(其他原因,如银行返回失败) |
以下字段在 return_code 和 result_code 都为 SUCCESS 的时候有返回
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 设备号 |
device_info |
否 |
String(32) |
微信支付分配的终端设备号, |
| 用户标识 |
openid |
是 |
String(128) |
用户在商户 appid 下的唯一标识 |
| 是否关注公众账号 |
is_subscribe |
是 |
String(1) |
用户是否关注公众账号,Y-关注,N-未关注,仅在公众账号类型支付有效 |
| 交易类型 |
trade_type |
是 |
String(16) |
JSAPI、NATIVE、MICROPAY、APP |
| 付款银行 |
bank_type |
是 |
String(16) |
银行类型,采用字符串类型的银行标识 |
| 总金额 |
total_fee |
是 |
Int |
订单总金额,单位为分 |
| 现金券金额 |
coupon_fee |
否 |
Int |
现金券支付金额<=订单总金额,订单总金额-现金券金额为现金支付金额 |
| 货币种类 |
fee_type |
否 |
String(8) |
货币类型,符合 ISO 4217标准的三位字母代码,默认人民币:CNY |
| 微信支付订单号 |
transaction_id |
否 |
String(32) |
微信支付订单号 |
| 商户订单号 |
out_trade_no |
否 |
String(32) |
商户系统的订单号,与请求一致。 |
| 商家数据包 |
attach |
否 |
String(128) |
商家数据包,原样返回 |
| 支付完成时间 |
time_end |
是 |
String(14) |
支付完成时间,格式为yyyyMMddhhmmss,如 2009 年12 月 27 日 9 点 10 分 10 秒表示为 20091227091010。时区为 GMT+8beijing。该时间取自微信支付服务器 |