查询批量结算信息

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

path 路径参数

settle_batch_no 　必填　string(64)

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

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/platsolution/ecommerce/settle/prepay-settle-orders/123685544886666 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 

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: 用户入账成功扣费失败

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

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" : "ACCEPTED",
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}

code 必填 string(32)

【错误码】 详见错误码部分

message 必填 string(1024)

【失败原因】 不建议展示给用户，仅用于商户的开发人员定位失败原因

失败回调的参数示例

1{
2  code: "PARAM_ERROR",
3  message: "AppID 格式有误"
4}