通用场景
为方便商户快速查账，支持商户通过本接口获取商户离线账单下载地址
公共请求参数
业务请求参数
bill_type必选string(20)
【描述】账单类型，商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型。
【枚举值】
商户基于支付宝交易收单的业务账单: trade
基于商户支付宝余额收入及支出等资金变动的账务账单: signcustomer
营销活动账单，包含营销活动的发放，核销记录: merchant_act
【示例值】trade
bill_date必选string(15)
【描述】账单时间：
* 日账单格式为yyyy-mm-dd，最早可下载近6年的日账单。不支持下载当日账单，只能下载前一日24点前的账单数据（t 1），当日数据一般于次日 9 点前生成，特殊情况可能延迟。
* 月账单格式为yyyy-mm，最早可下载近6年的月账单。不支持下载当月账单，只能下载上一月账单数据，当月账单一般在次月 3 日生成，特殊情况可能延迟。
* 当biz_type为settlementmerge时候，时间为汇总批次结算资金到账的日期，日期格式为yyyy-mm-dd，最早可下载2023年4月17日及以后的账单。
* 接口调用仅支持下载近6年的账单，更多账单请前往 b.alipay.com 对账中心-账单下载页下载。
【示例值】2025-05-01
smid可选string(20)
【描述】二级商户smid，这个参数只在bill_type是trade_zft_merchant时才能使用
【示例值】2088123412341234
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.data.dataservice.bill.downloadurl.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"bill_type":"trade",
"bill_date":"2025-05-01",
"smid":"2088123412341234"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
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"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| bill_date_before_registration | 请求的账单时间早于注册时间 | 请求的账单时间早于注册时间 确认参数后重新查询 |
| bill_not_exist | 账单不存在 | 确认参数后重新查询 |
| invailid_arguments | 入参不合法 | 确认参数后重新查询 |
| no_bill_data | 商户在请求的账单时间内没有发生当前账单类型的业务 | 确认参数后重新查询 |
| system_rate_limit | 系统当前负载较高，请求被限流，请稍后重试 | 间隔1分钟后重试 |
| type_not_supported | 此账单类型不支持下载 | 请根据不同的 bill_type 传参，确定不同凯发app官方网站的解决方案
（1）bill_type = trade，需签约支付宝支付产品（支付产品范围详见：），且有对应产品产生的实际流水。 （2）bill_type = signcustomer，非支付宝商家身份，建议先签约收钱码或经营码产品。 （3）bill_type = merchant_act，一年内无营销动作，具体请参考：营销账单使用 （4）bill_type = trade_zft_merchant，请联系直付通平台商提供对应账单数据 （5）bill_type = zft_acc，请先签约【互联网平台直付通】产品： （6）bill_type = settlementmerge，请先签约【收款到银行账户】产品： （7）其他，该账单类型不支持下载操作，请再次确认账单类型，以及所选日期。 如有需求，请联系支付宝小二排查 |
| unknown_error | 未知错误 | 稍后重试或联系小二排查问题 |
| user_rate_limit | 调用频率超限 | 间隔1分钟后重试，查看 调用频率限制 中新增的2.4请求频次 |