申请异常结算批次单处理

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

path 路径参数

settle_batch_no 　必填 string(64)

【微信支付结算批次单号】 微信支付系统内部的生成的结算批次单号，全局唯一对应一笔商户结算批次单号。

body 包体参数

individual_auth_id 　必填 string(64)

【商品单个人收款方受理授权ID】 标识一个微信用户在该平台用于个人收款的微信支付账户，平台邀请微信用户完成个人收款授权后获得此id，详见 查询个人收款方授权结果

out_abnormal_settle_batch_no 　必填 string(32)

【商户异常结算批次单号】 商户系统内部生成的异常结算批次单号，商户号下保证唯一，只能由数字、大小写字母_-|*@组成。同一笔商户异常结算批次单号多次请求，需保证请求内容完全一致。

abnormal_settle_type 　必填 string

【异常结算批次单处理方式】 异常结算批次单处理方式

可选取值

• TRANSFER_TO_ORIGINAL_RECEIVE_USER: 转付至原收款用户

description 　选填 string(128)

【异常处理说明】 异常处理说明，后续体现在转付流程的转账说明中

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/platsolution/ecommerce/settle/prepay-settle-orders/123685544886666/apply-abnormal-settle \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "individual_auth_id" : "256322110225",
8    "out_abnormal_settle_batch_no" : "1236698745558870",
9    "abnormal_settle_type" : "TRANSFER_TO_ORIGINAL_RECEIVE_USER",
10    "description" : "xx结算失败，转付至原用户"
11  }'
12

200 OK

out_settle_batch_no 　必填 string(32)

【商户结算批次单号】 商户结算批次单号

settle_batch_no 　必填 string(64)

【微信支付结算批次单号】 微信支付系统内部生成的结算批次单号，全局唯一对应一笔商户结算批次单号。

individual_auth_id 　必填 string(64)

【商品单个人收款方受理授权ID】 标识一个微信用户在该平台用于个人收款的微信支付账户，平台邀请微信用户完成个人收款授权后获得此id，详见 查询个人收款方授权结果

description 　必填 string(255)

【收款方描述】 收款方描述

state 　必填 string

【批次状态】 批次状态

可选取值

• ACCEPTED: 结算已受理

• RECEIVED: 用户入账成功

• SUCCESS: 结算完成

• DEDUCT_FEE_FAIL: 用户入账成功扣费失败

• ABNORMAL: 结算异常

• ABNORMAL_SETTLE_SUCCESS: 异常结算处理申请成功

trade_scenario 　必填 string

【交易场景】 交易场景

可选取值

• RECOMMERCE: 二手交易

create_time 　必填 string(32)

【批次创建时间】 遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。

finish_time 　选填 string(32)

【批次完成时间】 仅在批次状态为【结算成功】或【用户入账成功扣费失败】的时候有值。遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。

abnormal_type 　选填 string

【异常原因类型】 异常原因类型，仅当批次状态为结算异常的时候返回

可选取值

• AUTH_RELATIONSHIP_INVALID: 收款方授权关系已失效

• USER_PAY_QUOTA_LIMIT: 个人卖家支付额度超限

abnormal_settle_result 　选填 object

【异常结算处理结果】 异常结算处理结果，仅当批次状态为异常结算处理申请成功的时候返回

属性

abnormal_settle_type 　必填 string 【处理方式】 异常结算批次单处理方式 可选取值 TRANSFER_TO_ORIGINAL_RECEIVE_USER: 转付至原收款用户 apply_success_time 　必填 string(32) 【申请成功时间】 遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。 abnormal_fund_receipt_id 　必填 string(64) 【微信支付异常资金付款单号】 微信支付异常资金付款单号，可以通过调用【查询在途异常资金付款结果】的接口获取付款结果 out_abnormal_settle_batch_no 　必填 string(32) 【商户异常结算批次单处理单号】 商户异常结算批次单处理单号

应答示例

200 OK

1{
2  "out_settle_batch_no" : "123699878455555",
3  "settle_batch_no" : "123688554855555666",
4  "individual_auth_id" : "1900000109",
5  "description" : "共计2笔订单，订单金额xxx元，平台服务费xxx元，合计收款xxx元",
6  "state" : "SUCCESS",
7  "trade_scenario" : "RECOMMERCE",
8  "create_time" : "2024-06-08T10:34:56+08:00",
9  "finish_time" : "2024-06-08T10:34:56+08:00",
10  "abnormal_type" : "AUTH_RELATIONSHIP_INVALID",
11  "abnormal_settle_result" : {
12    "abnormal_settle_type" : "TRANSFER_TO_ORIGINAL_RECEIVE_USER",
13    "apply_success_time" : "2025-04-22T10:34:56+08:00",
14    "abnormal_fund_receipt_id" : "2123685544886666",
15    "out_abnormal_settle_batch_no" : "1236698745558870"
16  }
17}
18