写在前面

本文将介绍交易账单文件的格式，阅读本文前可先浏览：

• 产品介绍
• 关键概念

数据组成说明

微信支付的资金账单的出账周期是“每日”，日切时间是每日的00:00:00。资金账单的数据包括不同的业务类型，可通过账单中的业务名称、业务类型字段区分。

文件格式说明

每一份账单文件在结构上都包含以下四个部分：

• 明细数据表头
• 明细数据
• 汇总数据表头
• 汇总数据

其中，文件内每个字段都使用英文逗号“,” 间隔。明细数据和汇总数据每个字段前会增加1个字符（用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节）。

具体格式可参考以下文件样例：

• 《资金账单》 (opens new window)

注意

以上样例为文件展示示例，实际API下载的是数据流。

下面针资金账单文件，说明具体字段处理方式和字段含义：

账单文件具体字段

明细数据:

字段名	描述	示例值
记账时间	指该笔资金流水实际在账户中发生增减的时间，格式为yyyy-MM-dd HH:MM:SS	2019-07-18 04:11:47
微信支付业务单号	微信支付为该笔资金流水对应的业务分配的订单号，最大长度128字符	4200000263201902167700134212
资金流水单号	微信支付为该笔资金流水分配的单号，最大长度128字符	1900009301190219001019884779094940
业务名称	该笔资金流水对应的业务分类，业务名称会由于业务发展做调整：交易、退款、充值/提现、企业付款、代金券/立减/折扣、分账等	交易
业务类型	该笔资金流水对应的细化业务分类，业务类型会由于业务发展做调整：交易、扣除交易手续费、退款、退款关闭、退还交易手续费等	交易
收支类型	该笔资金流水的收支标识： 收入： 该笔流水为入账流水 支出：该笔流水为出账流水	收入
收支金额(元)	指该笔流水的发生额，收支类型是收入时表示余额的增加金额，收支类型是收入时表示余额的减少金额，单位元，保留到小数点后2位	0.03
账户结余(元)	指该笔流水发生后，商户账户的余额，单位元，保留到小数点后2位	51.39
资金变更提交申请人	例如员工账号@商户号、商户号API、system	system
备注	商户或业务的自定义备注，不同的业务有所区别，最大长度2048个字符	小店入款
业务凭证号	一般为商户订单号，不同的业务有所区别	20190219015157_13391

汇总数据:

字段名	描述	示例值
资金流水总笔数	该份账单内明细数据的笔数	72.0
收入笔数	账单内所有收支类型为收入的数据的笔数	42.0
收入金额	账单内所有收支类型为收入的字段之和，单位元	6.65
支出笔数	账单内所有收支类型为支出的数据的笔数	30.0
支出金额	账单内所有收支类型为支出的字段之和，单位元	6.22

特殊字符转义

会对字段取值中含有的\1字符、\r字符、\n字符做替换处理，其中\1会替换为空格，\r字符和\n字符会分别替换为\\r字符,\\n字符

针对明细数据中的备注、业务凭证号这两个商户自定义字段，账单在处理过程中对其进行了特殊字符的转义，具体规则包括：

原始特殊字符 Unicode	含义	转义后 Unicode	含义
\u000a	换行符(LF)	\u005c\u006e	\n
\u000d	回车符(CR)	\u005c\u0072	\r
\u0001	控制字符SOH(\001)	\u0020	空格