# 账单信息

# 下载商户微信账单信息

接口说明 本接口用于下载商户微信账单信息。

参考 https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_5_8.shtml 当获取到账单文件资源的下载地址信息后，如：

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

可以通过微信支付API发起请求，即可下载到账单文件的数据流。

curl https://api.mch.weixin.qq.com/v3/certificates -H 'Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900009191",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8alLDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/4nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'

请求地址 /trade/bill
请求方式 POST
请求参数 通用参数 + 业务参数

参数名称	类型	最大长度	必选	说明
bill_date	string	32	是	格式YYYY-MM-DD 仅支持三个月内的账单下载申请
bill_type	int	11	是
tar_type	int	11	是

bill_type 操作类型枚举值

0   返回当日所有订单信息（不含充值退款订单）
1   返回当日成功支付的订单（不含充值退款订单）                
2   返回当日退款订单（不含充值退款订单）

tar_type 操作类型枚举值

0   是数据流
1   返回格式为.gzip的压缩包账单

** 注意事项 **

1、timestamp 必须是1分钟内的时间戳
2、测试环境有IP白名单限制，需要提供IP，添加到白名单
3、有交易的日期才有账单
4、T+1的10点以后才生成账单
5、api_key、secert_key由出行服务提供

返回数据

参数名称	类型	最大长度	必选	说明
code	int	11	是
message	string	64	是
data	object
	hash_type	string	32	否	原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。示例值：SHA1
	hash_value	string	1024	否	原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。
	download_url	string	2048	否	供下一步请求账单文件的下载地址，该地址30s内有效。
	authorization	string		否	下载账单，微信需要的签名

请求数据示例

 {
    "api_key":"PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y",
    "seq_id":"38d42bd9-9f5a-415e-89d9-ea4ff9cffdf2",
    "timestamp":1572342076,
    "nonce":"157234207",
    "sign":"8A983278E5366EB93FEB0D4143E1C522",
    "bill_date":"2021-04-07",
    "bill_type":0,
    "tar_type":0   
}

返回数据示例

{
    "code":0,
    "message":"successful", 
    "data":{
        "hash_type":"SHA1",
        "hash_value":"79bb0f45fc4c42234a918000b2668d689e2bde04",
        "download_url":"https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx",
        "authorization":"authorization"
    }
}

← 订单中心零工市场 →