申请资金账单 API
注意
资金账单中的数据反映的是商户微信支付账户资金变动情况；
对账单中涉及金额的字段单位为“元”。
接口说明
适用对象: 电商平台 服务商 直连商户
请求 URL: https://api.mch.weixin.qq.com/v3/bill/fundflowbill
请求方式: GET
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指该参数需在请求 URL 传参query 指该参数需在请求 JSON 传参
请求参数
变量 |类型 |必填 |参数名/描述/示例值
账单日期 bill_date string(10) 是 path 格式 YYYY-MM-DD 仅支持三个月内的账单下载申请。 |||2019-06-11 资金账户类型 account_type string(32) 否 path 不填则默认是 BASIC 枚举值: BASIC: 基本账户 OPERATION: 运营账户 FEES: 手续费账户 |||BASIC 压缩类型 tar_type string(32) 否 path 不填则默认是数据流 枚举值: GZIP: 返回格式为.gzip 的压缩包账单 |||GZIP
请求示例
URL https://api.mch.weixin.qq.com/v3/bill/fundflowbill?bill_date=2019-06-11&account_type=BASIC
返回参数
变量 |类型 |必填 |参数名/描述/示例值
哈希类型 hash_type string(32) 是 从 download_url 下载的文件的哈希类型, 用于校验文件的完整性。 |||SHA1 哈希值 hash_value string(1024) 是 从 download_url 下载的文件的哈希值, 用于校验文件的完整性。 |||79bb0f45fc4c42234a918000b2668d689e2bde04 账单下载地址 download_url string(2048) 是 供下一步请求账单文件的下载地址, 该地址 30s 内有效。 |||https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx
返回示例
{
"hash_type": "SHA1",
"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
"download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"
}
## 错误码<sub>公共错误码</sub>
|状态码 |错误码 |描述| 解决方案
|-
500 SYSTEM_ERROR 系统错误 系统异常, 请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 INVALID_REQUEST 参数错误 请检查 bill_date, 并重新调用
参数错误 请检查 sub_mchid, 并重新调用
403 NO_AUTH 权限异常(无该子商户账单的权限） 请使用正确的 sub_mchid 再重新调用
权限异常, 小微商户不单独提供对账单下载 可以不传 sub_mch_id, 以获取服务商下全量电商二级商户(包括小微商户和非小微商户）的对账单
400 NO_STATEMENT_EXIST 账单文件不存在 请检查当前商户号是否在指定日期有交易或退款发生
400 STATEMENT_CREATING 账单生成中 请先检查当前商户号在指定日期内是否有成功的交易或退款, 若有, 则在 T+1 日上午 8 点后再重新下载
400 NO_STATEMENT_EXIST 账单文件不存在 请检查当前商户号请求的微信支付账户在指定日期是否有资金操作
400 STATEMENT_CREATING 账单生成中 请先检查当前商户号的微信支付账户在指定日期内是否有资金操作, 若有, 则在 T+1 日上午 10 点后再重新下载
400 INVALID_REQUEST 参数错误 请按第一步申请账单的 API 指引, 重新获取账单地址后再请求
403 NO_AUTH 权限异常 请检查本次请求的商户是否与第一步申请账单 API 的请求商户一致
Feedback
Was this page helpful?
很高兴听到！ 请告诉我们，我们如何才能改善.
很遗憾听到这个消息。 请告诉我们，我们如何才能改善.