微信支付-开发者文档

返回上一层文档首页 / 申请资金账单API

申请资金账单API

最新更新时间：2021.12.10 版本说明

微信支付按天提供微信支付账户的资金流水账单文件，服务商可以通过该接口获取账单文件的下载地址。文件内包含该账户资金操作相关的业务单号、收支金额、记账时间等信息，供商户进行核对。

注意：

• 资金账单中的数据反映的是商户微信支付账户资金变动情况；

• 对账单中涉及金额的字段单位为“元”。

接口说明

适用对象：服务商电商平台

请求URL：https://api.mch.weixin.qq.com/v3/bill/fundflowbill

请求方式：GET

path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
账单日期	bill_date	string[1,10]	是	query 格式yyyy-MM-dd 仅支持三个月内的账单下载申请。示例值：2019-06-11
资金账户类型	account_type	string[1,32]	否	query 不填则默认是BASIC 枚举值： BASIC：基本账户 OPERATION：运营账户 FEES：手续费账户示例值：BASIC
压缩类型	tar_type	string[1,32]	否	query 不填则默认是数据流枚举值： GZIP：返回格式为.gzip的压缩包账单示例值：GZIP

请求示例


https://api.mch.weixin.qq.com/v3/bill/fundflowbill?bill_date=2019-06-11

    
｛
JAVA示例代码
｝

返回参数

参数名	变量	类型[长度限制]	必填	描述
哈希类型	hash_type	string[1,32]	是	枚举值： SHA1：SHA1值示例值：SHA1
哈希值	hash_value	string[1,1024]	是	原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。示例值：79bb0f45fc4c42234a918000b2668d689e2bde04
账单下载地址	download_url	string[1,2048]	是	供下一步请求账单文件的下载地址，该地址30s内有效。示例值：https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx

返回示例

正常示例


{
	"download_url": "https://api.mch.weixin.qq.com/v3/billdownload/file?token=E-bFy6HgY_ffEOQutOpiFXX-SHI3EWhUQtPKAUd1iDGBGUA6Bfbzmcc-CWdJE23-",
	"hash_type": "SHA1",
	"hash_value": "8257296d67cd621531ddb3f6d3ed10d3ea45dd09"
}


    http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用
400	PARAM_ERROR	参数错误	请使用正确的参数重新调用
400	INVALID_REQUEST	参数错误	请检查bill_date，并重新调用
400	NO_STATEMENT_EXIST	账单文件不存在	请检查当前商户号是否在指定日期有交易或退款发生
400	NO_STATEMENT_EXIST	账单文件不存在	请先检查当前商户号的微信支付账户在指定日期内是否有资金操作
400	STATEMENT_CREATING	账单生成中	请先检查当前商户号的微信支付账户在指定日期内是否有资金操作，若有，则在T+1日上午10点后再重新下载

微信支付合作伙伴平台