查询在途异常资金付款指令执行结果

更新时间:2025.11.20

发起在途异常资金付款后,可通过该接口快速查询相关指令单的流程状态。

注:接口限频100次/秒。

接口说明

支持商户:【平台商户】 【普通服务商】

请求方式:【GET】/v3/abnormal-fund-processing/receipts/{receipt_id}/transfer-instructions/{out_instruction_no}

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


path  路径参数

 receipt_id  必填   string(64)

【微信支付在途异常资金付款单号】 微信支付在途异常资金付款单号


 out_instruction_no  必填   string(64)

【商户侧指令编号】 发起在途异常资金付款指令时传入的商户侧指令编号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/abnormal-fund-processing/receipts/0100011742874700562078230000/transfer-instructions/1200002 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

 out_instruction_no  必填   string(64)

【商户侧指令编号】 商户侧指令编号


 commander  必填   object

【在途异常资金付款指令的发起方】 在途异常资金付款指令的发起方

属性

 transfer_mode  必填   string

【付款方式】 资金处理规则

可选取值

  • TRANSFER_TO_ORIGINAL_RECEIVE_USER:  付款至原收款用户

  • TRANSFER_TO_ORIGINAL_RECEIVE_MERCHANT:  付款至原收款商户

  • TRANSFER_TO_SPECIFIED_RECEIVE_MERCHANT:  付款到指定的收款商户


 receiver  选填   object

【收款方】 收款方帐号信息仅在以下情况下返回:
1. 当 transfer_mode 为 TRANSFER_TO_ORIGINAL_RECEIVE_USER 且 instruction_state 为 INSTRUCTION_STATE_SUCCESS 时;
2. 当 transfer_mode 为 TRANSFER_MODE_TO_ORIGINAL_RECEIVE_MERCHANT 或 TRANSFER_MODE_TO_SPECIFIED_RECEIVE_MERCHANT。

属性

 instruction_state  必填   string

【在途异常资金付款指令状态】 在途异常资金付款指令状态

可选取值

  • INSTRUCTION_STATE_PENDING:  待执行

  • INSTRUCTION_STATE_IN_PROGRESS:  执行中

  • INSTRUCTION_STATE_CLOSED:  已关闭,此时可更换商户侧指令编号,并重新发起付款指令

  • INSTRUCTION_STATE_SUCCESS:  执行成功,可通过查询在途异常资金付款结果接口,进一步确认付款结果


 create_time  选填   string(64)

【在途异常资金付款指令创建时间】 在途异常资金付款指令的创建时间,遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。


 success_time  选填   string(64)

【入账成功时间】 在途异常资金付款指令的入账时间,遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。仅当 instruction_state = INSTRUCTION_STATE_SUCCESS 时返回。


 close_time  选填   string(64)

【在途异常资金付款指令关闭时间】 在途异常资金付款指令的关闭时间,遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。
仅当 instruction_state = INSTRUCTION_STATE_CLOSED 时返回。


 close_reason  选填   string(256)

【在途异常资金付款指令关闭原因】 在途异常资金付款指令的关闭原因,仅当 instruction_state = INSTRUCTION_STATE_CLOSED 时返回。


 notify_url  必填   string(255)

【回调通知地址】 回调通知地址,只支持HTTPS协议,需为外网可访问的URL,不能携带查询参数。设置后,在途异常资金的付款结果会通过该URL通知商户。


 instruction_instance_id  选填   string

【微信支付在途异常资金付款指令执行流水号】 仅 instruction_state = INSTRUCTION_STATE_SUCCESS 时返回

应答示例

200 OK

查询在途异常资金付款指令执行结果

1{
2  "out_instruction_no" : "1200002",
3  "commander" : {
4    "operator" : "MERCHANT",
5    "mchid" : "990055040"
6  },
7  "transfer_mode" : "TRANSFER_TO_SPECIFIED_RECEIVE_MERCHANT",
8  "receiver" : {
9    "mchid" : "1900001108"
10  },
11  "instruction_state" : "INSTRUCTION_STATE_PENDING",
12  "create_time" : "2023-10-01T12:34:56+08:00",
13  "success_time" : "2023-10-01T12:34:56+08:00",
14  "close_time" : "2023-10-01T12:34:56+08:00",
15  "close_reason" : "收款方商户状态异常",
16  "notify_url" : "https://weixin.qq.com"
17}
18

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

429

FREQUENCY_LIMIT_EXCEED

请求接口频率过快

请降低请求频率,稍后重试

404

NOT_FOUND

在途异常资金付款指令单不存在

检查传入的商户侧指令编号

 

元宝AI
反馈
目录
置顶