查询结算资金明细
更新时间:2025.01.07商户在交易完结之后,可按结算日期查询已结算资金明细(sette_state为SETTLED),也可以查询未结算资金明细(sette_state为UNSETTLE)。
|
1. 接口说明
适用对象:直连模式 机构模式
接口URL:https://apihk.mch.weixin.qq.com/v3/global/settle/settlements
请求方式:GET
Path 指该参数为路径参数
Query 指该参数为URL参数
Body 指该参数需在请求JSON传参
2. 请求参数
参数名 | 变量 | 类型 | 必填 | 描述 |
---|---|---|---|---|
子商户号 | sub_mchid | string(32) | 否 | Query 子商户,填写微信支付分配的商户号 1、若商户是直连商户、机构/银行服务商,无需填写该字段 2、若商户是普通服务商商户,需要填写该字段 示例值:1900000101 |
结算状态 | settle_state | string(32) | 是 | Query 资金结算状态,枚举值: |
结算开始日期 | settle_start_date | string(8) | 否 | Query 1、格式为yyyyMMdd,如2009年12月25日表示为20091225,时区为GMT+8 beijing |
结算结束日期 | settle_end_date | string(8) | 否 | Query 1、格式为yyyyMMdd,如2009年12月25日表示为20091226,时区为GMT+8 beijing |
最大记录条数 | limit | uint32 | 是 | Query 返回的最大记录条数,一般不超过10条为佳,系统最大支持30条 |
记录起始位置 | offset | uint32 | 是 | Query 该次请求资源的起始位置 |
请求示例:
URL
3. 返回参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 | |||
---|---|---|---|---|---|---|---|
结算信息列表 | data | array | 是 | 结算信息的详情 | |||
| |||||||
总记录条数 | total_count | int | 是 | 资源总条数。当offset=0或者当前查询为空时应该返回总条数 | |||
记录起始位置 | offset | int | 是 |
示例值:1 | |||
本次返回条数 | limit | int | 是 |
示例值:20 |
返回示例
正常示例
4. 错误码
错误码 | 描述 | 解决方案 |
---|---|---|
SYSTEM_ERROR | 系统错误 | 系统错误,请稍后再试 |
PARAM_ERROR | 参数错误 | 参数错误,请核对参数后重试 |
FREQUENCY_LIMITED | 请求频率过高 | 请求频率过高,请稍后重试 |
RESOURCE_NOT_EXISTS | 记录不存在 | 记录不存在,请调整参数后重试 |