微信支付订单号查询订单
更新时间:2025.04.07订单支付成功后,服务商可通过微信交易订单号或使用商户订单号查询订单;若订单未支付,则只能使用商户订单号查询订单。
接口说明
支持商户:【普通服务商】【平台商户】
请求方式:【GET】/v3/pay/partner/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 查询参数
sp_mchid 必填 string(32)
【服务商商户号】服务商下单时传入的服务商商户号sp_mchid。
sub_mchid 必填 string(32)
【子商户号(也叫特约商户号)】服务商下单时传入的子商户号sub_mchid。
请求示例
GET
应答参数
|
sp_appid 必填 string(32)
【服务商APPID】服务商下单时传入的服务商sp_appid。
sp_mchid 必填 string(32)
【服务商商户号】服务商下单时传入的服务商商户号sp_mchid。
sub_appid 选填 string(32)
【子商户APPID】服务商下单时传入的子商户sub_appid,若下单未传该参数,则不会返回。
sub_mchid 必填 string(32)
【子商户号】服务商下单时传入的子商户号sub_mchid。
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)
【银行类型】 用户支付方式,订单支付成功后返回,
1、使用银行卡支付,例如工商银行借记卡,该字段返回 ICBC_DEBIT,更多银行类型请参考《银行类型对照表》。
2、使用非银行卡支付,例如余额/零钱通等,该字段统一返回OTHERS。
attach 选填 string(128)
success_time 选填 string(64)
【支付完成时间】
1、定义:用户完成订单支付的时间。该参数在订单支付成功后返回。
2、格式:遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。
示例:2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。
payer 选填 object
【支付者信息】 支付者信息。
| 属性 | |
sp_openid 选填 string(128) 【用户服务商标识】用户在服务商sp_appid下唯一标识。 sub_openid 选填 string(128) 【用户子商户标识】 用户在子商户sub_appid下唯一标识,若下单未传sub_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) 【优惠范围】优惠活动中代金券的适用范围,分为两种类型: type 选填 string(32) 【优惠类型】代金券资金类型,优惠活动中代金券的结算资金类型,分为两种类型: amount 必填 integer 【优惠券面额】代金券优惠的金额。 stock_id 选填 string(32) 【活动ID】单张代金券所对应的批次号。 wechatpay_contribute 选填 integer 【微信出资】 代金券有三种出资类型:微信出资、商户出资和其他出资。本参数将返回选择“微信出资类型”时的优惠券面额。 merchant_contribute 选填 integer 【商户出资】代金券有三种出资类型:微信出资、商户出资和其他出资。本参数将返回选择“商户出资类型”时的优惠券面额。 other_contribute 选填 integer 【其他出资】代金券有三种出资类型:微信出资、商户出资和其他出资。本参数将返回选择“其他出资类型”时的优惠券面额。 currency 选填 string(16) 【优惠币种】 代金券金额所对应的货币种类:固定返回:CNY,人民币。 goods_detail 选填 array[object] 【单品列表】 单品列表。scope为SINGLE(单品优惠)时返回该参数
|
应答示例
200 OK
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
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 | 系统错误 | 系统异常,请用相同参数重新调用 |

