---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012124894.md"
title: "下载账单"
doc_id: 4012124894
---

>更新时间：2025.04.16

## 一、下载账单描述

当商户调用[申请交易账单](https://pay.weixin.qq.com/doc/v3/partner/4012760667.md)/[申请资金账单](https://pay.weixin.qq.com/doc/v3/partner/4012760672.md)/[申请分账账单](https://pay.weixin.qq.com/doc/v3/partner/4012761131.md)接口，获取到下载账单链接download\_url后，需按照[V3接口规则生成签名](https://pay.weixin.qq.com/doc/v3/merchant/4012365337.md)，然后请求下载账单链接download\_url获取对应的账单文件。

账单详细字段请参考附录：[交易账单详细说明](https://pay.weixin.qq.com/doc/v3/partner/4013080599.md)、[资金账单详细说明](https://pay.weixin.qq.com/doc/v3/partner/4013080600.md)。

## 二、具体下载步骤

### 1、接口说明

请求方式： 【GET】

请求URL： 调用申请账单接口，返回参数“download\_url”对应的URL

### 2、请求下载账单

以[V3接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012365865.md)生成签名，并对“download\_url”发起请求，获取账单文件，具体示例如下：

申请账单返回参数示例

```
{
	"hash_type": "SHA1",
	"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
    "download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"
}
```

请求download\_url下载账单示例

```
$ curl https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx -H 'Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900000001",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="uOVRnA4qG/MNnYzdQxJxxxxxxxxxanN+zU+lTgIcH/84nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98xxxxxxx996DE7B47773A8C"'
```

注意事项：

- 下载账单响应的信息请求头中不包含微信接口响应的签名值，因此需要跳过验签的流程。

- 账单文件的下载地址的有效时间为5min。

- 建议服务商比对实际下载账单文件的哈希值和从接口获取到的哈希值是否一致，以确认下载账单数据的完整性。

- 微信将在次日9点开始生成前一天的对账单，建议服务商在10点后获取。


### 3、常见错误码

#### 3.1、业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | INVALID\_REQUEST | 参数错误 | 请按第一步申请账单的API指引，重新获取账单地址后再请求 |
| 403 | NO\_AUTH | 权限异常 | 请检查本次请求的服务商是否与第一步申请账单API的请求服务商一致 |

#### 3.2、公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012365875.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |