特约商户银行来账查询
更新时间:2024.12.27服务商通过本接口查询指定日期内特约商户银行来账记录列表。列表内包含特约商户银行来账相关的业务单号、金额、完成时间等信息,供服务商进行查询和核对。
注意
- 如需检索,请在前端缓存所有银行来账记录数据并自行完成检索功能;
- 调用该接口前,服务商需提前开通“来账识别”产品权限;
- 本接口对可查询的商户范围有所规定,仅支持对服务商的特约商户进行查询;
- 本接口仅提供近90天内的银行来账记录查询,且一次只能查询一天,服务商需确保查询记录日期在此范围内;
- 本接口返回的记录字段后续可能会有所扩充,服务商需做好接口兼容准备;
- API按照接口-服务商级别限频,单服务商单接口最大请求频率不超过50TPS。
# 接口说明
支持商户: 【普通服务商】
请求URL: /v3/merchantfund/partner/income-records
请求方式: GET
# 请求参数
- Authorization 必填请参考 签名认证
生成认证信息 - Accept 必填请设置为
application/json
Header HTTP头参数
- sub_mchid 必填【特约商户号】 需查询银行来账记录列表的特约商户的商户号,该商户号须为服务商的特约商户号
- account_type 必填【账户类型】 需查询银行来账记录商户的账户类型
枚举值:
BASIC:基本账户
OPERATION:运营账户
FEES:手续费账户 - date 必填【日期】 查询的日期,一次只能查询一天,最久可查询90天内的记录,格式为“YYYY-MM-DD”
- offset 选填【本次查询偏移量】 非负整数,表示该次请求资源的起始位置,从0开始计数。调用方选填,默认为0。offset为20,limit为100时,查询第20-119条数据
- limit 必填【本次请求最大查询条数】 非0非负的整数,该次请求可返回的最大资源条数,最大支持100条。
Query 查询参数
请求示例
GET
# 应答参数
- total_count 必填【查询数据总条数】 经过条件筛选,查询到的银行来账记录总数
- offset 必填【本次查询偏移量】 该次请求资源的起始位置,请求中包含偏移量时应答消息返回相同偏移量,否则返回默认值0。
- limit 必填【本次查询条数】 经过条件筛选,本次查询到的银行来账记录条数
- data 选填【银行来账记录列表】 单次查询返回的银行来账记录列表结果数组,如果查询结果为空时,则为空数组
- 属性
- links 必填【分页链接】 返回前后页和当前页面的访问链接
- 属性
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM ERROR | 无效的账户类型 | 请使用正确的账户类型再重新调用 |
400 | PARAM ERROR | 无效的查询日期 | 请使用正确的查询日期再重新调用 |
400 | INVALID_REQUEST | 查询日期超限 | 请使用正确的查询日期再重新调用 |
403 | NO_AUTH | 无权限查询该特约商户记录 | 请使用正确的特约商户号再重新调用 |
403 | NO_AUTH | “来账识别”产品权限未开通 | 请开通“来账识别”产品权限再重新调用 |
文档是否有帮助