申请资金账单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=2019-06-11
    
{
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=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 STATEMENT_CREATING 账单生成中 请先检查当前商户号的微信支付账户在指定日期内是否有资金操作,若有,则在T+1日上午10点后再重新下载


技术咨询

文档反馈