下载资金账单

应用场景

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

说明:

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

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

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

接口链接

https://api.mch.weixin.qq.com/pay/downloadfundflow

是否需要证书

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

请求参数

字段名 变量名 必填 类型 示例值 描述
公众账号ID appid String(32) wx8888888888888888 微信分配的公众账号ID(企业号corpid即为此appId)
商户号 mch_id String(32) 1900000109 微信支付分配的商户号
随机字符串 nonce_str String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于32位。推荐随机数生成算法
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名,详见签名生成算法
签名类型 sign_type String(32) HMAC-SHA256 签名类型,目前仅支持HMAC-SHA256
资金账单日期 bill_date String(8) 20140603 下载对账单的日期,格式:20140603
资金账户类型 account_type String(8) Basic

账单的资金来源账户:

Basic  基本账户

Operation 运营账户

Fees 手续费账户

压缩账单 tar_type String(8) GZIP 非必传参数,固定值:GZIP,返回格式为.gzip的压缩包账单。不传则默认为数据流形式。

<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>

返回结果

接口请求成功时,数据以文本表格的方式返回

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签名返回

接口请求时如有协议错误,将返回以下字段
字段名 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) FAIL FAIL
返回信息 return_msg String(128) 签名失败

返回信息,如非空,为错误原因

如:签名失败、参数格式错误等。

当return_code为SUCCESS时,进一步返回以下字段指明业务失败的原因

字段名

变量名

必填

类型

示例值

描述

业务结果

result_code

string(16)

FAIL

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

错误代码

err_code

String(16)

SYSTEMERROR

见错误码列表

错误代码描述

err_code_des

String(128)

账单不存在

错误信息描述

请求协议错误示例:

<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>

错误码

错误码 描述 解决方案
SYSTEMERROR 微信支付内部错误 请稍后重试。
PARAM_ERROR 参数错误 请对照文档的请求参数说明检查参数。

NO_BILL_EXIST

账单不存在 请检查当前商户号在指定日期内是否有成功的交易。

BILL_CREATING

账单未生成 请先检查当前商户号在指定日期内是否有成功的交易,如指定日期有交易则表示账单正在生成中,请在上午10点以后再下载。