登录
基础
连接微信
办公
企业内部开发 服务端API 企业支付 对外收款 获取资金流水
获取资金流水
最后更新：2023/11/30
企业可通过此接口获取企业的资金流水。
请求方式：POST(HTTPS)
请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalpay/get_fund_flow?access_token=ACCESS_TOKEN
请求示例：
{
"begin_time":1605171726,
"end_time":1605172726,
"mch_id": "1234",
"cursor":"CURSOR",
"limit":10
}参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| begin_time | 是 | 资金流水记录开始时间 |
| end_time | 是 | 资金流水记录结束时间 |
| mch_id | 否 | 商户号ID，若不填写则拉取所有商户号的资金流水 |
| cursor | 否 | 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填 |
| limit | 否 | 返回的最大记录数，默认值100，最大不超过200 |
补充说明:
可以拉取不早于2022年12月1日的资金流水记录，资金流水记录最长保留3年。
当日的资金流水会在次日上午11点后生成。
资金流水的起止间隔不能超过31天。
会过滤操作人不在应用可见范围中的资金流水，因此返回的记录数可能会小于limit设置的最大记录数。
如果没有获取到next_cursor，说明已经拉取完所有的数据。
权限说明：
- 仅返回在企业微信开通的商户号资金流水
- 调用的应用需要满足如下的权限
应用类型 权限要求 自建应用 配置到「对外收款- 可调用接口的应用」中 代开发应用 暂不支持 第三方应用 暂不支持
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
返回结果：
{
"errcode":0,
"errmsg":"ok",
"next_cursor":"CURSOR",
"fund_flow_list":[
{
"timestamp": 1605171726,
"request_no": "1234567890",
"transaction_type": 3,
"fund_flow_type": 1,
"transaction_amount": 20,
"account_balance": 40,
"out_trade_no": "123456",
"mch_id": "123456",
"operator_userid": "ZhangSan",
"group_list":[
{
"group_name": "Rule1",
},
{
"group_name": "Rule2"
}
],
"remark": "REMARK"
}
]
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| next_cursor | 分页游标，在下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则不返回该字段 |
| fund_flow_list | 资金流水记录列表 |
| fund_flow_list[].timestamp | 动账时间 |
| fund_flow_list[].request_no | 关联单号，即微信支付资金流水单号 |
| fund_flow_list[].transaction_type | 动账类型。1：退款，2：交易手续费，3：收款，4：提现，5：其他 |
| fund_flow_list[].fund_flow_type | 收支类型。1：收入，2：支出 |
| fund_flow_list[].transaction_amount | 动账金额，整型数据，单位：分 |
| fund_flow_list[].account_balance | 账户余额，整型数据，单位：分 |
| fund_flow_list[].out_trade_no | 商户单号，即业务凭证号 |
| fund_flow_list[].mch_id | 商户号ID |
| fund_flow_list[].operator_userid | 操作人userid |
| fund_flow_list[].group_list | 所属规则组列表 |
| fund_flow_list[].group_list[].group_name | 规则组名称 |
| fund_flow_list[].remark | 备注 |
- 获取资金流水
本节内容
