最新更新时间：2021.08.15 版本说明
该接口提供所有微信支付订单的查询，商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。
需要调用查询接口的情况：
1. 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
2. 调用扣款接口后，返回系统错误或未知交易状态情况；
适用对象：直连模式 机构模式
接口URL：https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/{transaction_id}
或
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out-trade-no/{out_trade_no}
请求方式：GET
接口规则：https://wechatpay-api.gitbook.io/wechatpay-api-v3/
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商户号 | sub_mchid | string[1,32] | 否 | query服务商模式必填，微信支付分配的子商户号 注意：仅适用于机构模式 示例值：10000097 |
| 微信订单号 | transaction_id | string[1,32] | 二选一 | path支付完成后，微信返回的微信支付订单号 示例值：4015463511252015071056489715 |
| 商户订单号 | out_trade_no | string[1,32] | path商户系统内部的订单号，可包含字母；更换授权码必须要换新的商户订单号 其他说明见商户订单号 示例值：1217752501201407033233368018 |
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/4015463511252015071056489715
或
https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out_trade_no/1217752501201407033233368018
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商户号 | mchid | string[1,32] | 是 | 微信支付分配的商户号 注意：仅适用于直连模式 示例值：10000091 |
| 应用ID | appid | string[1,32] | 是 | 商户号绑定的appid 注意：仅适用于直连模式 示例值：wxcbda96de0b165486 |
| 服务商商户号 | sp_mchid | string[1,32] | 是 | 微信支付分配的机构商户号 注意：仅适用于机构模式 示例值：10000098 |
| 子商户号 | sub_mchid | string[1,32] | 是 | 微信支付分配的子商户号 注意：仅适用于机构模式 示例值：10000097 |
| 服务商应用ID | sp_appid | string[1,32] | 是 | 服务商绑定的appid 注意：仅适用于机构模式 示例值：wxcbda96de0b165486 |
| 子商户应用ID | sub_appid | string[1,32] | 否 | 发起签约的子商户号绑定的appid 注意：仅适用于机构模式 示例值：wxcbda96de0b165484 |
| 商户订单号 | out_trade_no | string[1,32] | 是 | 返回的商户订单号 示例值：1217752501201407033233368018 |
| 微信支付订单号 | transaction_id | string[1,32] | 是 | 微信支付订单号 示例值：1217752501201407033233368018 |
| 商户数据 | attach | string[1,127] | 否 | 附加数据，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据 示例值：自定义数据 |
| 交易类型 | trade_type | string[1,16] | 是 | 代扣支付 示例值：AUTH |
| 付款银行 | bank_type | string[1,32] | 否 | 银行类型 示例值：WPHK：香港钱包支付 |
| 支付完成时间 | success_time | string[1,64] | 是 | 支付完成时间，格式为rfc3339格式，如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒 示例值：2018-06-08T10:34:56+08:00 |
| 交易状态 | trade_state | string[1,16] | 是 | 枚举值： SUCCESS：支付成功 REFUND：转入退款 NOTPAY：未支付 CLOSED：已关闭 PAYERROR：支付失败 USERPAYING：用户支付中 示例值：SUCCESS |
| 交易状态描述 | trade_state_desc | string[1,256] | 是 | 对当前订单状态的描述和下一步操作的指引 示例值：支付失败，请重新下单支付 |
| MCC码 | merchant_category_code | string[1,16] | 是 | 商户行业编码 示例值：1011 |
| +支付者 | payer | object | 否 | 成功时才返回。支付者信息，详细说明见下文 |
| +订单金额 | amount | object | 否 | 成功时才返回。订单金额信息，详细说明见下文 |
| +场景信息 | scene_info | object | 否 | 成功时才返回。场景信息对象，详细说明见下文 |
| +优惠功能 | promotion_detail | array | 否 | 成功时才返回。优惠功能信息，详细说明见下文 |
{
"mchid": "10000091",
"appid": "wxcbda96de0b165486",
"sp_mchid": "10000098",
"sub_mchid": "10000097",
"sp_appid": "wxcbda96de0b165486",
"sub_appid": "wxcbda96de0b165484",
"out_trade_no": "1217752501201407033233368018",
"transaction_id": "1217752501201407033233368018",
"attach": "自定义数据",
"trade_type": "AUTH",
"bank_type": "WPHK：香港钱包支付",
"success_time": "2018-06-08T10:34:56+08:00",
"trade_state": "SUCCESS",
"trade_state_desc": "支付失败，请重新下单支付",
"merchant_category_code": "1011",
"payer": {
"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6a",
"sp_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
"sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
},
"amount": {
"total": 888,
"payer_total": 888,
"currency": "CNY",
"payer_currency": "HKD",
"exchange_rate": {
"type": "SETTLEMENT_RATE",
"rate": 80000000
}
},
"scene_info": {
"device_id": "013467007045764",
"device_ip": "128.0.0.1"
},
"promotion_detail": [
{
"promotion_id": "109519",
"name": "单品惠-6",
"scope": "SINGLE",
"type": "COUPON",
"amount": 5,
"currency": "HKD",
"activity_id": "931386",
"wxpay_contribute_amount": 100,
"merchant_contribute_amount": 100,
"other_contribute_amount": 5,
"goods_detail": {
"goods_id": "1245454",
"goods_remark": "1001",
"discount_amount": 100,
"quantity": 1,
"price": 528800
}
}
]
}
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证