发起在途异常资金付款指令

更新时间：2025.06.26

商户有在途异常资金时，可以通过该接口发起在途异常资金付款，转付给符合条件的接收方

注：接口限频100次/秒。

接口说明

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

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

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

path 路径参数

receipt_id 　必填 string(64)

【微信支付在途异常资金付款单号】微信支付在途异常资金付款业务的唯一标识

body 包体参数

out_instruction_no 　必填 string(64)

【商户侧指令编号】商户侧指令编号，商户需保证同一笔在途异常资金付款单下唯一

appid 　必填 array[string(32)]

【商户AppID】允许拉起收款场景的AppID，一个指令最多只能绑定5个AppID

transfer_mode 　必填 string

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

可选取值

TRANSFER_TO_ORIGINAL_RECEIVE_USER: 付款至原收款用户

notify_url 　选填 string(255)

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

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/abnormal-fund-processing/receipts/0100011742874700562078230000/transfer-instructions \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_instruction_no" : "1200002",
8    "appid" : [
9      "wxf636efh567hg4356"
10    ],
11    "transfer_mode" : "TRANSFER_TO_ORIGINAL_RECEIVE_USER",
12    "notify_url" : "https://weixin.qq.com"
13  }'
14

应答参数

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: 付款至原收款用户

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

appid 　必填 array[string(32)]

【可发起收款的AppID】允许拉起收款页面的AppID，仅收款方为微信用户时有效，一个指令最多只能绑定5个AppID

notify_url 　必填 string(255)

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

应答示例

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    "success_time" : "2023-10-01T12:34:56+08:00",
19    "appid" : [
20      "wxf636efh567hg4356"
21    ],
22    "notify_url" : "https://weixin.qq.com"
23  }
24}
25

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
429	FREQUENCY_LIMIT_EXCEED	请求接口频率过快	请降低请求频率，稍后重试
400	ALREADY_EXISTS	当前在途异常资金付款单已在处理中或处理成功	请勿重复操作

文档是否有帮助

更多支持

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