企业可通过此接口获取企业的资金流水。
请求方式: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,说明已经拉取完所有的数据。
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「对外收款- 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
返回结果:
{
"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 | 备注 |