申请资金账单

更新时间:2023.12.07

微信支付按天提供微信支付账户的资金流水账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含该账户资金操作相关的业务单号、收支金额、记账时间等信息,供商户进行核对。

注意

  • 资金账单中的数据反映的是商户微信支付账户资金变动情况;
  • 对账单中涉及金额的字段单位为“元”。

# 接口说明

支持商户: 【普通商户】

请求URL: "https://api.mch.weixin.qq.com/v3/bill/fundflowbill"

请求方式: 【GET】

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
    Query 查询参数
  • bill_date 必填 string(10)
    【账单日期】 账单日期,格式yyyy-MM-DD,仅支持三个月内的账单下载申请。
  • account_type 选填 string
    【资金账户类型】 资金账户类型,不填默认是BASIC
    可选取值:
    • BASIC: 基本账户
    • OPERATION: 运营账户
    • FEES: 手续费账户
    • ALL: 所有账户(该枚举值只限电商平台下载二级商户资金流水账单场景使用)
  • tar_type 选填 string
    【压缩格式】 压缩格式,不填则以不压缩的方式返回数据流
    可选取值:
    • GZIP: GZIP格式压缩,返回格式为.gzip的压缩包账单
    200OK
  • hash_type 必填 string
    【哈希类型】 哈希类型
    可选取值:
    • SHA1: Secure Hash Algorithm 1
  • hash_value 必填 string(1024)
    【哈希值】 原始账单(gzip需要解压缩)的摘要值,用于校验文件的完整性
  • download_url 必填 string(2048)
    【下载地址】 供下一步请求账单文件的下载地址,该地址5min内有效。

请求示例

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 系统错误 系统异常,请使用相同参数稍后重新调用
反馈
咨询
目录