下载账单

更新时间：2024.11.25

一、下载账单描述

当商户调用申请所有/单个子商户（也叫特约商户）交易账单/申请服务商资金账单接口，获取到下载账单链接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 -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 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

文档是否有帮助

更多支持

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