企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
企业支付
对外收款
获取资金流水
获取资金流水
最后更新:2024/07/18

企业可通过此接口获取企业的资金流水。

请求方式: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备注

 

上一篇获取收款项目的商户单号
下一篇签名算法
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们