服务商通过本接口查询指定日期内本商户银行来账记录列表。列表内包含本商户银行来账相关的业务单号、金额、完成时间等信息，用于查询和核对。

注意

1. 如需检索，请在前端缓存所有银行来账记录数据并自行完成检索功能；
2. 调用该接口前，商户需提前开通“来账识别”产品权限；
3. 本接口对可查询的商户范围有所规定，仅支持对本商户进行查询；
4. 本接口仅提供近90天内的银行来账记录查询，且一次只能查询一天，商户需确保查询记录日期在此范围内；
5. 本接口返回的记录字段后续可能会有所扩充，商户需做好接口兼容准备；
6. 单商户单接口最大请求频率不超过50TPS。

接口说明

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

请求URL： /v3/merchantfund/merchant/income-records

请求方式： GET

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json

Query 查询参数
account_type 必填 string(32)
【账户类型】 需查询银行来账记录商户的账户类型
枚举值：
BASIC：基本账户
OPERATION：运营账户
FEES：手续费账户
date 必填 string(10)
【日期】 查询的日期，一次只能查询一天，最久可查询90天内的记录，格式为“YYYY-MM-DD”
offset 选填 integer
【本次查询偏移量】 非负整数，表示该次请求资源的起始位置，从0开始计数。调用方选填，默认为0。offset为20，limit为100时，查询第20-119条数据
limit 必填 integer
【本次请求最大查询条数】 非0非负的整数，该次请求可返回的最大资源条数，最大支持100条。

请求示例

GET

应答参数

200OK
total_count 必填 integer
【查询数据总条数】 经过条件筛选，查询到的银行来账记录总数
offset 必填 integer
【本次查询偏移量】 该次请求资源的起始位置，请求中包含偏移量时应答消息返回相同偏移量，否则返回默认值0。
limit 必填 integer
【本次查询条数】 经过条件筛选，本次查询到的银行来账记录条数
data 选填 array[IncomeRecordEntity]
【银行来账记录列表】 单次查询返回的银行来账记录列表结果数组，如果查询结果为空时，则为空数组
• 属性
links 必填 ListIncomRecordsResponseLinks
【分页链接】 返回前后页和当前页面的访问链接
• 属性

应答示例

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	“来账识别”产品权限未开通	请开通“来账识别”产品权限再重新调用