下载账单

更新时间：2024.12.11

一、下载账单描述

当商户调用申请交易账单/申请资金账单接口，获取到下载账单链接download_url后，需按照V3接口规则生成签名，然后请求下载账单链接download_url获取对应的账单文件。

账单详细字段请参考附录：交易账单详细说明、资金账单详细说明。

二、具体下载步骤

1、接口说明：

请求方式：【GET】

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

2、请求下载账单：

以V3接口规则生成签名，并对“download_url”发起请求，获取账单文件，具体示例如下：

申请账单返回参数示例

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

请求download_url下载账单示例

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

注意事项：

下载账单响应的请求头信息中不包含签名值，因此无需验签。
下载账单链接download_url的有效时间为5min，请及时下载。
建议商户在下载完成后，比对实际文件的哈希值与申请账单接口返回的哈希值是否一致，以确认下载账单数据的完整性。
微信将在次日9点开始生成前一天的对账单，建议商户在次日10点后获取。

3、常见错误码：

3.1、公共错误码：

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

3.2、业务错误码：

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

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服