---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4013071249.md"
title: "资金账单详细说明"
doc_id: 4013071249
---

>更新时间：2024.11.25

## 1、资金账单文件内容

明细内容：文件内包含商户账户内资金操作相关的业务单号、收支金额、记账时间等信息。

资金账单的明细数据表头、汇总数据表头所包含的字段具体如下：

| 明细数据表头字段 | 汇总数据表头字段 | 账单文件样例 |
| --- | --- | --- |
| 记账时间,微信支付业务单号,资金流水单号,业务名称,业务类型,收支类型,收支金额(元),账户结余(元),资金变更提交申请人,备注,业务凭证号 | 资金流水总笔数,收入笔数,收入金额,支出笔数,支出金额 | [资金账单.xlsx](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/attachment/a84c90eae7c6eb0da29662d4594c4dd3/资金账单.xlsx) |
| 注意事项：<br>- 文件内每个字段都使用英文逗号（,）间隔。明细数据和汇总数据每个字段前会增加1个（\`）字符（用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节）。<br>  <br>- 文件样例仅为展示示例，实际API下载的是数据流。 | 注意事项：<br>- 文件内每个字段都使用英文逗号（,）间隔。明细数据和汇总数据每个字段前会增加1个（\`）字符（用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节）。<br>  <br>- 文件样例仅为展示示例，实际API下载的是数据流。 | 注意事项：<br>- 文件内每个字段都使用英文逗号（,）间隔。明细数据和汇总数据每个字段前会增加1个（\`）字符（用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节）。<br>  <br>- 文件样例仅为展示示例，实际API下载的是数据流。 |

## 2、资金账单字段列表

| 字段名 | 描述 | 示例值 |
| --- | --- | --- |
| 明细数据 |  |  |
| 记账时间 | 指该笔资金流水实际在账户中发生增减的时间（注：不是退款成功时间），格式为yyyy-MM-dd HH:MM:SS | 2015-01-01 10:00:00 |
| 微信支付业务单号 | 该笔资金对应的业务，在微信支付侧的业务单号，该单号由微信生成。最大长度128字符 | 4200000008201712143733500001 |
| 资金流水单号 | 资金变动对应的流水单号。最大长度128字符 | outtradeno001 |
| 业务名称 | 该笔资金流水对应的业务分类，业务名称会由于业务发展做调整： `交易`、 `退款`、 `充值/提现`、 `企业付款`、 `代金券/立减/折扣`、 `分账` 等 | 交易 |
| 业务类型 | 该笔资金流水对应的细化业务分类，业务类型会由于业务发展做调整： `交易`、 `扣除交易手续费`、 `退款`、 `退款关闭`、 `退还交易手续费` 等 | 扣除交易手续费 |
| 收支类型 | 该笔资金流水的收支标识：<br>`收入`： 该笔流水为入账流水<br>`支出`：该笔流水为出账流水 | 收入 |
| 收支金额(元) | 指该笔流水的发生金额，收支类型是 `收入` 时表示余额的增加金额，收支类型是 `收入` 时表示余额的减少金额，单位元，保留到小数点后2位 | 8.88 |
| 账户结余(元) | 指该笔流水发生后，商户账户的余额，单位元，保留到小数点后2位 | 10.00 |
| 资金变更提交申请人 | 资金变更操作的发起人，该字段可能为空。例如 `员工账号@商户号`、 `商户号API`、 `system` | system |
| 备注 | 商户或业务的自定义备注，不同的业务有所区别，最大长度2048个字符，该字段可能为空。 | 小店入款 |
| 业务凭证号 | 资金变动对应的业务凭证号。一般为商户订单号，不同的业务有所区别 | 50401010122021000000038202001 |
| 汇总数据 |  |  |
| 资金流水总笔数 | 该份账单内明细数据的笔数 | 200 |
| 收入笔数 | 该份账单内收支类型为“收入”的明细数据总笔数 | 100 |
| 收入金额 | 账单内所有收支类型为“收入”的明细数据的“收支金额(元)”字段之和，保留小数点后2位 | 666.00 |
| 支出笔数 | 该份账单内收支类型为“支出”的明细数据总笔数 | 100 |
| 支出金额 | 账单内所有收支类型为“支出”的明细数据的“收支金额(元)”字段之和，保留小数点后2位 | 10.00 |

## 3、特殊字符转义

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

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

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