特约商户银行来账查询

更新时间：2024.11.18

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

注意

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

接口说明

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

请求方式：【GET】/v3/merchantfund/partner/income-records

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

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

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/merchantfund/partner/income-records?sub_mchid=2480253391&account_type=BASIC&date=2019-06-11&offset=0&limit=100 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

total_count 　必填 integer

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

offset 　必填 integer

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

limit 　必填 integer

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

data 　选填 array[object]

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

属性

links 　必填 object

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

属性

应答示例

200 OK

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}
25

错误码

公共错误码

状态码	错误码	描述	解决方案
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	“来账识别”产品权限未开通	请开通“来账识别”产品权限再重新调用

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服