下载资金账单

应用场景

商户可以通过该接口下载自2017年6月1日起的历史资金流水账单。

说明：

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

2、当日账单在次日上午9点开始生成，建议商户在上午10点以后获取；

3、资金账单中涉及金额的字段单位为“元”。

是否需要证书

请求需要双向证书。详见证书使用

返回结果
接口请求成功时，数据以文本表格的方式返回
1）第一行为表头
记账时间,微信支付业务单号,资金流水单号,业务名称,业务类型,收支类型,收支金额（元）,账户结余（元）,资金变更提交申请人,备注,业务凭证号
2)从第二行起，为资金流水数据，各参数以逗号分隔，参数前增加`符号，为标准键盘1左边键的字符，字段顺序与表头一致
3）倒数第二行为资金账单统计标题
资金流水总笔数,收入笔数,收入金额,支出笔数,支出金额
4）最后一行为统计数据
账单示例如下：

记账时间,微信支付业务单号,资金流水单号,业务名称,业务类型,收支类型,收支金额（元）,账户结余（元）,资金变更提交申请人,备注,业务凭证号

`2018-02-01 04:21:23,`50000305742018020103387128253,`1900009231201802015884652186,`退款,`退款,`支出,`0.02,`0.17,`system,`缺货,`REF4200000068201801293084726067

资金流水总笔数,收入笔数,收入金额,支出笔数,支出金额

`20.0,`17.0,`0.35,`3.0,`0.18

5）header中Digest为完整性校验信息，内容格式为：签名类型=签名

举例如下：

Digest: SHA=ec45d7c24492dcd62d92472b0f2816c8d9a2d773

注：当前仅支持sha1签名返回

错误码

错误码	描述	解决方案
SYSTEMERROR	微信支付内部错误	请稍后重试。
PARAM_ERROR	参数错误	请对照文档的请求参数说明检查参数。
NO_BILL_EXIST	账单不存在	请检查当前商户号在指定日期内是否有成功的交易。
BILL_CREATING	账单未生成	请先检查当前商户号在指定日期内是否有成功的交易，如指定日期有交易则表示账单正在生成中，请在上午10点以后再下载。

curl --location --request POST 'https://api.mch.weixin.qq.com/pay/downloadfundflow' \ --header 'Content-Type: application/xml' \ --data-raw '<xml> <appid>wx2421b1c4370ec43b</appid> <bill_date>20141110</bill_date> <account_type>Basic</account_type> <mch_id>10000100</mch_id> <nonce_str>21df7dc9cd8616b56919f20d9f679233</nonce_str> <sign>332F17B766FC787203EBE9D6E40457A1</sign> </xml>'

<xml> <return_code><![CDATA[SUCCESS]]></return_code> <return_msg><![CDATA[OK]]></return_msg> <result_code><![CDATA[FAIL]]></result_code> <err_code><![CDATA[NO_BILL_EXIST]]></err_code> <err_code_des><![CDATA[商户查询账户当日无资金账单]]></err_code_des> </xml>

请求参数

Body 参数application/xml

appid

string

公众账号ID

必需

微信分配的公众账号ID（企业号corpid即为此appId）

bill_date

string

资金账单日期

必需

下载对账单的日期，格式：20140603

account_type

string

资金账户类型

必需

账单的资金来源账户： Basic 基本账户 Operation 运营账户 Fees 手续费账户

mch_id

string

商户号

必需

微信支付分配的商户号

nonce_str

string

随机字符串

必需

随机字符串，不长于32位。推荐随机数生成算法

sign

string

签名

必需

签名，详见签名生成算法

sign_type

string

签名类型

可选

签名类型，目前仅支持HMAC-SHA256

tar_type

string

压缩账单

可选

非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。

示例

返回响应

🟢200错误

application/json

Body

return_code

string

返回状态码

必需

SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看trade_state来判断

return_msg

string

返回信息

必需

当return_code为FAIL时返回信息为错误原因，例如签名失败参数格式校验错误请求频率过快，请稍后再试

result_code

string

业务结果

必需

FAIL 此字段是业务标识，表示业务是否成功。目前只在失败时返回这个字段，所以只会出现FAIL值

err_code

string

错误代码

必需

见错误码列表

err_code_des

string

错误代码描述

可选

错误信息描述

应用场景#

是否需要证书#

错误码#

请求参数

返回响应

应用场景

是否需要证书

错误码