微信支付-开发者文档

返回上一层 API列表 / 申请资金账单API

申请资金账单API

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

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

注意：

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

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

接口说明

适用对象：直连商户

请求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=2020-12-31

    
｛
JAVA示例代码
｝

返回参数

参数名	变量	类型[长度限制]	必填	描述
哈希类型	hash_type	string[1,32]	是	原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。示例值：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=6XIv5TUPto7pByrTQKhd6kwvyKLG2uY2wMMR8cNXqaA_Cv_isgaUtBzp4QtiozLO",
	"hash_type": "SHA1",
	"hash_value": "8823044c286bea726f149bfcfce0b0318122d755"
}


    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点后再重新下载

微信支付商户平台