查询对账单下载地址

为方便商户快速查账，支持商户通过本接口获取商户离线账单下载地址

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	String	必选	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	必选	128	接口名称	alipay.data.dataservice.bill.downloadurl.query
format	String	可选	40	仅支持JSON	JSON
charset	String	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	String	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	String	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	String	必选	19	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	String	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	String	可选	40	详见应用授权概述
biz_content	String	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

请求参数

参数	类型	是否必选	最大长度	描述	示例值
bill_type	String	必选	20	账单类型，商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型。枚举值商户基于支付宝交易收单的业务账单: trade基于商户支付宝余额收入及支出等资金变动的账务账单: signcustomer营销活动账单，包含营销活动的发放，核销记录: merchant_act直付通二级商户查询交易的业务账单: trade_zft_merchant直付通平台商查询二级商户流水使用，返回所有二级商户流水。: zft_acc每日结算到卡的资金对应的明细，下载内容包含批次结算到卡明细文件（示例）和批次结算到卡汇总文件（示例）；若查询时间范围内有多个批次，会将多个批次的明细和汇总文件打包到一份压缩包中；: settlementMerge	trade
bill_date	String	必选	15	账单时间： * 日账单格式为yyyy-MM-dd，最早可下载2016年1月1日开始的日账单。不支持下载当日账单，只能下载前一日24点前的账单数据（T+1），当日数据一般于次日 9 点前生成，特殊情况可能延迟。 * 月账单格式为yyyy-MM，最早可下载2016年1月开始的月账单。不支持下载当月账单，只能下载上一月账单数据，当月账单一般在次月 3 日生成，特殊情况可能延迟。 * 当biz_type为settlementMerge时候，时间为汇总批次结算资金到账的日期，日期格式为yyyy-MM-dd，最早可下载2023年4月17日及以后的账单。	2016-04-05
smid	String	可选	20	二级商户smid，这个参数只在bill_type是trade_zft_merchant时才能使用	2088123412341234

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	String	必选	-	网关返回码,详见文档	40004
msg	String	必选	-	网关返回码描述,详见文档	Business Failed
sub_code	String	可选	-	业务返回码，参见具体的API接口文档	ACQ.TRADE_HAS_SUCCESS
sub_msg	String	可选	-	业务返回码描述，参见具体的API接口文档	交易已被支付
sign	String	必选	-	签名,详见文档	DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数	类型	是否必选	最大长度	描述	示例值
bill_download_url	String	必选	2048	账单下载地址链接，获取连接后30秒后未下载，链接地址失效。	http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=X&pid=X&fileType=X&bizDates=X&downloadFileName=X&fileId=X
bill_file_code	String	必选	64	描述本次申请的账单文件状态。 EMPTY_DATA_WITH_BILL_FILE：当天无账单业务数据&&可以获取到空数据账单文件。枚举值空账单数据文件：当前周期无数据时候产生的账单文件: EMPTY_DATA_WITH_BILL_FILE注意事项目前仅对默认配置用户生效，主动配置的不会返回当前字段。	EMPTY_DATA_WITH_BILL_FILE

请求示例

Java

PHP

HTTP

响应示例

json

xml

{
    "alipay_data_dataservice_bill_downloadurl_query_response": {
        "code": "10000",
        "msg": "Success",
        "bill_download_url": "http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=X&pid=X&fileType=X&bizDates=X&downloadFileName=X&fileId=X",
        "bill_file_code": "EMPTY_DATA_WITH_BILL_FILE"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

**说明：**本示例仅供参考。

异常示例

json

{
    "alipay_data_dataservice_bill_downloadurl_query_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

错误码

公共错误码

前往查看

业务错误码

错误码	错误描述	解决方案
BILL_NOT_EXIST	账单不存在	确认参数后重新查询
INVAILID_ARGUMENTS	入参不合法	确认参数后重新查询
UNKNOWN_ERROR	未知错误	稍后重试或联系小二排查问题

查询对账单下载地址

公共请求参数#

请求参数#

公共响应参数#

响应参数#

请求示例#

响应示例#

异常示例#

错误码#

公共错误码#

业务错误码#

公共请求参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

错误码

公共错误码

业务错误码