查询对账单下载地址接口 -凯发app官方网站

产品地图

支付产品

当面付

app支付

产品介绍

接入准备

接入指南

api 列表

交易

账单

查询对账单下载地址接口

常见问题

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
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

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

参数	类型	是否必选	最大长度	描述	示例值
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

常见请求示例

默认示例

javac#phphttp

package com.java.sdk.demo;
import com.alipay.api.alipayapiexception;
import com.alipay.api.alipayclient;
import com.alipay.api.defaultalipayclient;
import com.alipay.api.certalipayrequest;
import com.alipay.api.alipayconfig;
import com.alipay.api.request.alipaydatadataservicebilldownloadurlqueryrequest;
import com.alipay.api.response.alipaydatadataservicebilldownloadurlqueryresponse;
import com.alipay.api.domain.alipaydatadataservicebilldownloadurlquerymodel;
import com.alipay.api.fileitem;
import java.util.base64;
import java.util.arraylist;
import java.util.list;
public class alipaydatadataservicebilldownloadurlquery {
    public static void main(string[] args) throws alipayapiexception {
        string privatekey = "<-- 请填写您的应用私钥，例如：miievqibadanb ... ... -->";
        string alipaypublickey = "<-- 请填写您的支付宝公钥，例如：miibijanbg... -->";
        alipayconfig alipayconfig = new alipayconfig();
        alipayconfig.setserverurl("https://openapi.alipay.com/gateway.do");
        alipayconfig.setappid("<-- 请填写您的appid，例如：2019091767145019 -->");
        alipayconfig.setprivatekey(privatekey);
        alipayconfig.setformat("json");
        alipayconfig.setalipaypublickey(alipaypublickey);
        alipayconfig.setcharset("utf-8");
        alipayconfig.setsigntype("rsa2");
        alipayclient alipayclient = new defaultalipayclient(alipayconfig);
        alipaydatadataservicebilldownloadurlqueryrequest request = new alipaydatadataservicebilldownloadurlqueryrequest();
        alipaydatadataservicebilldownloadurlquerymodel model = new alipaydatadataservicebilldownloadurlquerymodel();
        model.setsmid("2088123412341234");
        model.setbilltype("trade");
        model.setbilldate("2016-04-05");
        request.setbizmodel(model);
        alipaydatadataservicebilldownloadurlqueryresponse response = alipayclient.execute(request);
        system.out.println(response.getbody());
        if (response.issuccess()) {
            system.out.println("调用成功");
        } else {
            system.out.println("调用失败");
            // sdk版本是"4.38.0.all"及以上,可以参考下面的示例获取诊断链接
            // string diagnosisurl = diagnosisutils.getdiagnosis;
            // system.out.println(diagnosisurl);
        }
    }
}

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
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

参数	类型	是否必选	最大长度	描述	示例值
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

响应示例

正常示例

异常示例

{
    "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"
}