接入指南 -凯发app官方网站

产品地图

支付产品

私域产品

公域产品

营销产品

资金产品

会员产品

信用产品

安全产品

广告产品

其他通用产品

小程序交易投诉处理

收单资金结算到银行账户的到账消息

蚂蚁门店管理

ccm 插件化能力

学校库

分享到支付宝

商家账单数据查询及下载接口

产品介绍

接入准备

接入指南

api 列表

商户自主监控

网站支付宝登录

支付宝卡包

电子发票

生活缴费

中小学教育缴费

地铁线上购票

车主平台停车在线缴费

口碑开店

私域营销

支付宝加油

商家费率申请

更新时间：2025-03-31 14:25:52

订阅更新

我的文档

设置

开发者可根据本文指引快速接入账单数据查询及账单下载服务功能，完成商家账户买入、卖出、充值等账单信息查询。接口示例仅用于展示说明，开发者需根据自身实际业务场景需求进行接入。

注意：

●

本功能仅支持商家自调用，不支持服务商代调用。

●

页面实时数据查询支持

一年内

的账单数据。

●

alipay.data.dataservice.bill.downloadurl.query

（查询对账单下载地址接口）支持查询自 2016 年 1 月 1 日以后的账单数据。

1 接口查询/下载账单数据

1.1 查询时间区间说明

●

商家账单功能接口中起止日期都为左闭右开区间，即 [ start_time，end_time ），起止日期间隔不能超过 31 天。

●

若起止日期相同无法查询到账单数据。

●

如需查询当日数据 end_time 需大于当日时间，但与起始时间间隔不能超过 31 天。例如：假设当日日期为 2020-08-17 ，查询其记录数据，则截止日期 end_time 需为 2020-08-18 及之后不超过 31 天。

1.2 查询卖出交易明细

开发者可调用

（支付宝商家账户卖出交易查询接口）查询商家账户卖出交易数据信息。

1.2.1 示例代码

package com.java.sdk.demo;

import com.alipay.api.alipayapiexception;

import com.alipay.api.alipayclient;

import com.alipay.api.defaultalipayclient;

import com.alipay.api.alipayconfig;

import com.alipay.api.response.alipaydatabillsellqueryresponse;

import com.alipay.api.domain.alipaydatabillsellquerymodel;

import com.alipay.api.request.alipaydatabillsellqueryrequest;

import com.alipay.api.fileitem;

import java.util.base64;

import java.util.arraylist;

import java.util.list;

public class alipaydatabillsellquery {

public static void main(string[] args) throws alipayapiexception {

// 初始化sdk

alipayclient alipayclient = new defaultalipayclient(getalipayconfig());

// 构造请求参数以调用接口

alipaydatabillsellqueryrequest request = new alipaydatabillsellqueryrequest();

alipaydatabillsellquerymodel model = new alipaydatabillsellquerymodel();

// 设置卖出交易流水创建时间的起始范围

model.setstarttime("2019-01-01 00:00:00");

// 设置卖出交易流水创建时间的结束范围

model.setendtime("2019-01-02 00:00:00");

// 设置支付宝交易流水号

model.setalipayorderno("20190101***");

// 设置商户交易号

model.setmerchantorderno("tx***");

重要入参说明

●

alipay_order_no：可选，支付宝生成交易流水号。如果查询参数中指定流水号，则只查询流水号相关的记录。

●

merchant_order_no：可选，商家自定义交易号。如果查询参数中指定交易号，则只查询相关的记录。

●

store_no：门店编号，支持

支付宝（即蚂蚁）门店

、

口碑门店

。

注意：

同时传入 alipay_order_no、merchant_order_no 时，二者需对应同一笔订单。

1.3 查询买入交易明细

开发者可调用

（支付宝商家账户买入交易查询接口）查询商家支付宝账户买入交易信息，供对账使用。

1.3.1 示例代码

1.4 查询账务流水明细

开发者可调用

（支付宝商家账户账务明细查询接口）查询商家账户账务流水信息。

1.4.1 示例代码

1.5 查询充值、转账、提现记录

开发者可调用

（支付宝商家账户充值，转账，提现查询接口）查询商家账户充值，转账，提现信息。

1.5.1 示例代码

重要入参说明

type：必填，转账类型。枚举支持：

●

deposit：充值。

●

withdraw：提现。

●

transfer：转账。

1.6 查询保证金明细

开发者可调用

（支付宝商家账户保证金查询接口）查询商家账户保证金信息。

1.6.1 示例代码

重要入参说明

bail_type：保证金类型，目前支持：

●

tmall_bail：天猫保证金。

●

taobao_bail：淘宝保证金。

1.7 查询账户当前余额

开发者可调用

（支付宝商家账户当前余额查询接口）查询商家账户当前余额信息。

说明：

本接口无需业务入参，将根据 app_id 查询其归属商家主账号账户实时余额信息。

1.7.1 示例代码

1.8 查询账户历史余额

开发者可调用

（支付宝商家账户历史余额查询接口）查询商家账户指定自然日或自然月起止历史余额信息，供对账使用。

1.8.1 示例代码

重要入参说明

●

biz_date：查询指定自然日的起初余额和期末余额，与 biz_month 互斥二者只能传入其一。

●

biz_month ：查询指定自然月的起初余额和期末余额，与 biz_date 互斥二者只能传入其一。

1.8.2 响应示例

1.9 离线账单文件下载

目前离线账单文件下载方式有两种：一种是在商家平台下载账单；一种是通过调用接口的方式来获取账单下载地址。服务商的对账管理请查看

。

1.9.1 新企业版账单下载

商家财务人员登录新企业版

进入

对账中心

，可通过账单下载页面，下载登录账号的已完成结算的对账单，并使用该数据完成财务核算。

支持下载如下两种类型账单：

●

资金账单

用于表达支付宝账号的收支变化，对应 alipay.data.dataservice.bill.downloadurl.query（查询对账单下载地址接口）下载的

trabill_type = signcustomer

账单。

●

交易账单

用于表达支付宝收单业务中发生的交易订单，对应 alipay.data.dataservice.bill.downloadurl.query（查询对账单下载地址接口）下载的

trabill_type = trade

账单。

日账单下载

进入日账单下载页面，默认显示最近日账单的所在月份，默认选中最近日账单所在日期。鼠标移动到已完成结算的日期，显示可下载链接。点击所在日期可进行下载。

特殊说明

●

账单未生成：前一日的日账单在第二天生成，在第二天生成之前在下载区域提示

账单未生成

，不可点击下载。

●

本日无收支：若已完成结算的某日无任何收支，则在下载区域提示

本日无收支

，不可点击下载。

●

日账单下载，支持范围从 2013 年 1 月 1 日开始。

月账单下载

月账单下载功能同日账单下载。进入月账单下载页面，默认显示最近月账单的所在年份，默认选中最近月账单所在月份。鼠标移动到已完成结算的日期，显示可下载链接。点击所在月份可进行下载。

注意

：

●

月账单下载，支持范围从 2013 年 1 月开始。

●

每月账单一般会在次月 4 日或之前生成。

特殊说明

账单未生成

1.9.2 调用接口获取账单下载地址

开发者可调用

alipay.data.dataservice.bill.downloadurl.query

（查询对账单下载地址接口）查询商家对账单下载地址，可通过地址下载离线账单用于对账，支持下载接口中指定 appid 所对应 pid 下所有交易记录的对账单。

示例代码

重要入参说明

●

bill_type：必填，账单类型，开发者可通过接口以获取以下业务/账务对应的日/月账单。

○

trade：商家基于支付宝交易收单的业务账单，对应

对账中心

的

交易账单

。

○

signcustomer：基于商家支付宝余额收入及支出等资金变动的帐务账单，对应

对账中心

的

资金账单

。

●

bill_date：必填，账单时间：

○

日账单时间格式为

yyyy-mm-dd

，最早可下载从 2016 年 1 月 1 日以后的日账单，当天离线账单会在次日 9 点前，打包成压缩文件产出，包含了当天的所有相关类型流水，特殊情况可能延迟。

○

月账单时间格式为

yyyy-mm

，最早可下载从 2016 年 1 月以后的月账单，当月离线账单会在次月 3 号前，打包成压缩文件产出，包含了当月的所有相关类型流水，特殊情况可能延迟。

注意

：

●

下载地址有效时间为 30 s，请尽快下载。

●

下载的账单 excel 默认是 gbk 格式。

下载账单文件示例

2 附录

商家在下载账单后，会得到

业务账单

或

财务账单

对应压缩文件，解压后两种类型账单文件中都包含了

明细

和

汇总

两张表，详情如下。

2.1 业务账单文件示例

2.1.1 业务账单汇总

2.1.2 业务账单明细

2.1.3 账单与支付接口字段对应关系

部分业务账单字段与支付相关接口字段对应关系如下：

支付宝交易号

商家订单号

商品名称

门店编号

门店名称

终端号

订单金额（元）

商家实收（元）

集分宝（元）

商家优惠（元）

券核销金额（元）

券名称

退款批次号

服务费（元）

trade_no

out_trade_no

goods_detail#goods_name

store_id

store_name

terminal_id

total_amount

receipt_amount

point_amount

mdiscount_amount

voucher_detail_list#amount

voucher_detail_list#name

batch_no

charge_amount

支付宝系统中全局唯一标识用户一笔交易的流水号。

商家系统中唯一标识一笔用户交易的流水号。

商品名称。

商家门店编号。

请求交易支付中的商家店铺的名称。

商家机具终端编号。

订单总金额，

单位为元。

商家实收=订单金额 total_amount - 商家出资的优惠金额。

该笔交易过程中使用集分宝的付款金额。

该笔交易过程中使用的商家优惠金额。

该笔交易过程中使用优惠券核销的付款金额。

本笔交易使用的券名称。

该笔交易产生退款后退款批次识别号，对应退款 out_request_no 字段。

该笔交易收取商家服务费（手续费）金额。

2.2 账务账单文件示例

2.2.1 账务账单汇总

2.2.2 账务账单明细

2.3 账单下载设置

商家可在

商家平台

对账中心

页面点击

下载设置

，设置下载的业务及账务账单语言、包含字段等明细信息。

相关问题