服务商银行来账查询

更新时间：2024.12.27

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

注意

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

# 接口说明

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

请求方式： 【GET】

请求URL： "https://api.mch.weixin.qq.com/v3/merchantfund/merchant/income-records"

# 请求参数

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

# 应答参数

total_count 必填 integer

经过条件筛选，查询到的银行来账记录总数

offset 必填 integer

该次请求资源的起始位置，请求中包含偏移量时应答消息返回相同偏移量，否则返回默认值0。

limit 必填 integer

经过条件筛选，本次查询到的银行来账记录条数

data 选填 array

单次查询返回的银行来账记录列表结果数组，如果查询结果为空时，则为空数组

数组

links 必填 ListIncomRecordsResponseLinks

返回前后页和当前页面的访问链接

属性

请求示例

1https://api.mch.weixin.qq.com/v3/merchantfund/merchant/income-records?account_type=BASIC&date=2021-04-21&offset=0&limit=100

应答示例

1{
2  "total_count": 100,
3  "offset": 0,
4  "limit": 100,
5  "data": [
6    {
7      "mchid": "2480253391",
8      "account_type": "BASIC",
9      "income_record_type": "OFFLINERECHARGE",
10      "income_record_id": "4200000811202011056138519459",
11      "amount": 100,
12      "success_time": "2017-12-08T00:08:00.00+08:00",
13      "bank_name": "招商银行",
14      "bank_account_name": "财付通支付科技有限公司",
15      "bank_account_number": "****6473"
16    }
17  ],
18  "links": {
19    "next": "/v3/merchantfund/merchant/income-records?offset=10&limit=5",
20    "prev": "/v3/merchantfund/merchant/income-records?offset=0&limit=5",
21    "self": "/v3/merchantfund/merchant/income-records?offset=5&limit=5"
22  }
23}

# 错误码

# 公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则 (opens new window)
401	SIGN_ERROR	验证不通过	请参阅签名常见问题 (opens new window)
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

# 业务错误码

状态码	错误码	描述	解决方案
400	PARAM ERROR	无效的账户类型	请使用正确的账户类型再重新调用
400	PARAM ERROR	无效的查询日期	请使用正确的查询日期再重新调用
400	INVALID_REQUEST	查询日期超限	请使用正确的查询日期再重新调用
403	NO_AUTH	“来账识别”产品权限未开通	请开通“来账识别”产品权限再重新调用

文档是否有帮助

商户文档

商户文档中心

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

服务商银行来账查询

# 接口说明

# 请求参数

# 应答参数

# 错误码

# 公共错误码

# 业务错误码

关于我们

服务支持

友情链接

客服帮助