查询在途异常资金付款结果

更新时间：2025.06.26

资金交易异常未能及时完成时，可通过该接口快速查询在途异常资金付款流程状态，支持查看付款金额、入账账户、处理进度等信息。

注：接口限频100次/秒。

接口说明

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

请求方式：【GET】/v3/abnormal-fund-processing/receipts/{receipt_id}

请求域名：【主域名】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)

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

请求示例

GET

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

应答参数

200 OK

product_name 　必填 string

【产品名称】发起在途异常资金付款的业务产品名称

receipt_id 　必填 string(64)

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

transfer_amount 　必填 object

【金额】付款金额信息

属性

total 　必填 integer

【总金额】在途异常资金付款总金额，单位为分，整型。

currency 　必填 string

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

可选取值

CNY: 人民币

receipt_state 　必填 string

【在途异常资金付款状态】当前单据处理进度

可选取值

RECEIPT_STATE_PENDING: 待处理
RECEIPT_STATE_PROGRESS: 处理中
RECEIPT_STATE_COMPLETED: 处理成功

create_time 　选填 string(64)

【在途异常资金付款单据创建时间】微信支付在途异常资金付款单据的创建时间，遵循rfc3339标准格式：yyyy-MM-DDTHH:mm:ss+TIMEZONE。

last_update_time 　选填 string(64)

【在途异常资金付款单据更新时间】微信支付在途异常资金付款单据的最新更新时间，遵循rfc3339标准格式：yyyy-MM-DDTHH:mm:ss+TIMEZONE。

instruction 　选填 object

【在途异常资金付款指令信息】在途异常资金付款指令信息

属性

out_instruction_no 　选填 string(64)

【商户侧指令编号】商户侧指令编号，仅当在途异常资金付款状态为"处理中"或"处理成功"且当前付款操作由商户发起时才返回

commander 　必填 object

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

属性

operator 　必填 string

【发起在途异常资金付款请求的角色】发起在途异常资金付款请求的角色

可选取值

MERCHANT: 微信支付商户

mchid 　选填 string(32)

【微信支付商户号】发起在途异常资金付款请求的微信支付商户号，仅当操作角色是"微信支付商户"时返回

transfer_mode 　必填 string

【付款方式】资金处理规则，当前仅支持付款至原收款用户

可选取值

TRANSFER_TO_ORIGINAL_RECEIVE_USER: 付款至原收款用户

receiver 　选填 object

【入账用户】在途异常资金的入账用户，仅在付款成功时返回。

属性

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秒。

应答示例

200 OK

1{
2  "product_name" : "C2C",
3  "receipt_id" : "0100011742874700562078230000",
4  "transfer_amount" : {
5    "total" : 100,
6    "currency" : "CNY"
7  },
8  "receipt_state" : "RECEIPT_STATE_PENDING",
9  "create_time" : "2023-10-01T12:34:56+08:00",
10  "last_update_time" : "2023-10-01T12:34:56+08:00",
11  "instruction" : {
12    "out_instruction_no" : "1200002",
13    "commander" : {
14      "operator" : "MERCHANT",
15      "mchid" : "990055040"
16    },
17    "transfer_mode" : "TRANSFER_TO_ORIGINAL_RECEIVE_USER",
18    "receiver" : {
19      "account_type" : "OTHERS",
20      "openid" : "eoCuiA7RW33Tc3jtz_5CNLegC9kN0",
21      "appid" : "wxf636efh567hg4356"
22    },
23    "success_time" : "2023-10-01T12:34:56+08:00"
24  }
25}
26

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
429	FREQUENCY_LIMIT_EXCEED	请求接口频率过快	请降低请求频率，稍后重试

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服