申请资金账单
更新时间:2023.12.07微信支付按天提供微信支付账户的资金流水账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含该账户资金操作相关的业务单号、收支金额、记账时间等信息,供商户进行核对。
注意
- 资金账单中的数据反映的是商户微信支付账户资金变动情况;
- 对账单中涉及金额的字段单位为“元”。
# 接口说明
支持商户: 【普通商户】
请求URL: "https://api.mch.weixin.qq.com/v3/bill/fundflowbill"
请求方式: 【GET】
# 请求参数
- Authorization 必填请参考 签名认证
生成认证信息 - Accept 必填请设置为
application/json
Header HTTP头参数
- bill_date 必填【账单日期】 账单日期,格式yyyy-MM-DD,仅支持三个月内的账单下载申请。
- account_type 选填【资金账户类型】 资金账户类型,不填默认是BASIC
可选取值:BASIC
: 基本账户OPERATION
: 运营账户FEES
: 手续费账户ALL
: 所有账户(该枚举值只限电商平台下载二级商户资金流水账单场景使用)
- tar_type 选填【压缩格式】 压缩格式,不填则以不压缩的方式返回数据流
可选取值:GZIP
: GZIP格式压缩,返回格式为.gzip的压缩包账单
Query 查询参数
- hash_type 必填【哈希类型】 哈希类型
可选取值:SHA1
: Secure Hash Algorithm 1
- hash_value 必填【哈希值】 原始账单(gzip需要解压缩)的摘要值,用于校验文件的完整性
- download_url 必填【下载地址】 供下一步请求账单文件的下载地址,该地址5min内有效。
200OK
请求示例
1https://api.mch.weixin.qq.com/v3/bill/fundflowbill?bill_date=2020-12-31
应答示例
1{2 "download_url": "https://api.mch.weixin.qq.com/v3/billdownload/file?token=6XIv5TUPto7pByrTQKhd6kwvyKLG2uY2wMMR8cNXqaA_Cv_isgaUtBzp4QtiozLO",3 "hash_type": "SHA1",4 "hash_value": "8823044c286bea726f149bfcfce0b0318122d755"5}
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 参数错误 | 请检查bill_date,并重新调用 |
400 | NO_STATEMENT_EXIST | 账单文件不存在 | 请检查当前商户号是否在指定日期有交易或退款发生 |
400 | NO_STATEMENT_EXIST | 账单文件不存在 | 请先检查当前商户号的微信支付账户在指定日期内是否有资金操作 |
400 | STATEMENT_CREATING | 账单生成中 | 请先检查当前商户号的微信支付账户在指定日期内是否有资金操作,若有,则在T+1日上午10点后再重新下载 |
500 | SYSTEM_ERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
文档是否有帮助