特约商户银行来账查询

更新时间：2024.12.27

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

注意

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

# 接口说明

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

请求方式： 【GET】

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

# 请求参数

Query 查询参数

sub_mchid 必填 string(32)

需查询银行来账记录列表的特约商户的商户号，该商户号须为服务商的特约商户号

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/partner/income-records?sub_mchid=2480253391&account_type=BASIC&date=2019-06-11&offset=0&limit=100

应答示例

1{
2    "total_count" : 100,
3    "offset" : 0,
4    "limit" : 20,
5    "data" : [
6      {
7        "sub_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        "recharge_remark" : "单号：202106010001"
17      }
18    ],
19    "links" : {
20      "next" : "/v3/merchantfund/partner/income-records?offset=10&limit=5",
21      "prev" : "/v3/merchantfund/partner/income-records?offset=0&limit=5",
22      "self" : "/v3/merchantfund/partner/income-records?offset=5&limit=5"
23    }
24}

# 错误码

# 公共错误码

状态码	错误码	描述	解决方案
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	无权限查询该特约商户记录	请使用正确的特约商户号再重新调用
403	NO_AUTH	“来账识别”产品权限未开通	请开通“来账识别”产品权限再重新调用

文档是否有帮助

商户文档

商户文档中心

更多支持

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

特约商户银行来账查询

# 接口说明

# 请求参数

# 应答参数

# 错误码

# 公共错误码

# 业务错误码

关于我们

服务支持

友情链接

客服帮助