查询对账单下载地址

开发环境

GET

https://openapi.alipay.com/v3/alipay/data/dataservice/bill/downloadurl/query

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

错误码

公共错误码

业务错误码

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://openapi.alipay.com/v3/alipay/data/dataservice/bill/downloadurl/query?bill_type&bill_date&smid'

响应示例

200 - 示例 1

{
  "bill_download_url": "string",
  "bill_file_code": "string"
}

请求参数

Query 参数

bill_type

string

必需

账单类型，商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型。
枚举值
商户基于支付宝交易收单的业务账单: trade
基于商户支付宝余额收入及支出等资金变动的账务账单: signcustomer
营销活动账单，包含营销活动的发放，核销记录: merchant_act
直付通二级商户查询交易的业务账单: trade_zft_merchant
直付通平台商查询二级商户流水使用，返回所有二级商户流水。: zft_acc
每日结算到卡的资金对应的明细，下载内容包含批次结算到卡明细文件（示例）和批次结算到卡汇总文件（示例）；若查询时间范围内有多个批次，会将多个批次的明细和汇总文件打包到一份压缩包中；: settlementMerge

bill_date

string

必需

账单时间： * 日账单格式为yyyy-MM-dd，最早可下载2016年1月1日开始的日账单。不支持下载当日账单，只能下载前一日24点前的账单数据（T+1），当日数据一般于次日 9 点前生成，特殊情况可能延迟。 * 月账单格式为yyyy-MM，最早可下载2016年1月开始的月账单。不支持下载当月账单，只能下载上一月账单数据，当月账单一般在次月 3 日生成，特殊情况可能延迟。 * 当biz_type为settlementMerge时候，时间为汇总批次结算资金到账的日期，日期格式为yyyy-MM-dd，最早可下载2023年4月17日及以后的账单。

smid

string

可选

二级商户smid，这个参数只在bill_type是trade_zft_merchant时才能使用

返回响应

🟢200成功

application/json

Body

bill_download_url

string

账单下载地址链接，获取连接后30秒后未下载，链接地址失效。

必需

bill_file_code

string

描述本次申请的账单文件状态。 EMPTY_DATA_WITH_BILL_FILE：当天无账单业务数据&&可以获取到空数据账单文件。枚举值空账单数据文件：当前周期无数据时候产生的账单文件: EMPTY_DATA_WITH_BILL_FILE 注意事项目前仅对默认配置用户生效，主动配置的不会返回当前字段。

必需

🟠400请求有误

修改于 2023-11-20 07:39:34

统一收单交易关闭接口

支付界面规范

查询对账单下载地址

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码