如何通过 API 获取支付宝后台页面的交易记录？

2026-10-24支付小周

结论

可以通过支付宝开放平台 API 查询交易，具体方式取决于查询需求：

已知支付宝交易号或商户订单号，可以调用 alipay.trade.query 查询单笔订单。
需要批量获取支付宝后台的交易记录，通常可以先通过 alipay.data.dataservice.bill.downloadurl.query 获取账单下载地址，再下载并解析交易账单。

支付宝后台页面展示的数据，不一定有完全对应的”交易记录列表 API”。后台页面的筛选条件、统计口径和展示字段也可能与开放平台账单不同，不能直接将后台页面作为 API 数据源。

查询单笔交易

如果已经保存商户订单号 out_trade_no，或者已经取得支付宝交易号 trade_no，可以调用：

alipay.trade.query

这两个参数通常选择一个传入：

out_trade_no：商户系统生成的订单号。
trade_no：支付宝生成的交易号。

Java SDK 示例：

AlipayClient alipayClient = new DefaultAlipayClient(
    "https://openapi.alipay.com/gateway.do",
    APP_ID,
    MERCHANT_PRIVATE_KEY,
    "json",
    "UTF-8",
    ALIPAY_PUBLIC_KEY,
    "RSA2"
);

AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();

AlipayTradeQueryModel model = new AlipayTradeQueryModel();
model.setOutTradeNo("ORDER_202609090001");
// 也可以使用：model.setTradeNo("支付宝交易号");

request.setBizModel(model);

AlipayTradeQueryResponse response = alipayClient.execute(request);

if (response.isSuccess()) {
    System.out.println("trade_no: " + response.getTradeNo());
    System.out.println("out_trade_no: " + response.getOutTradeNo());
    System.out.println("trade_status: " + response.getTradeStatus());
    System.out.println("total_amount: " + response.getTotalAmount());
} else {
    System.out.println("code: " + response.getCode());
    System.out.println("sub_code: " + response.getSubCode());
    System.out.println("sub_msg: " + response.getSubMsg());
}

在实际项目中，应结合 code、sub_code 和 trade_status 判断业务结果，不能只看 HTTP 状态码。

批量获取交易记录

如果要按天获取全部交易、退款和手续费等明细，下载支付宝账单更合适。对应的接口是：

alipay.data.dataservice.bill.downloadurl.query

请求示例：

AlipayDataDataserviceBillDownloadurlQueryRequest request =
    new AlipayDataDataserviceBillDownloadurlQueryRequest();

AlipayDataDataserviceBillDownloadurlQueryModel model =
    new AlipayDataDataserviceBillDownloadurlQueryModel();

model.setBillType("trade");
model.setBillDate("2026-09-08");

request.setBizModel(model);

AlipayDataDataserviceBillDownloadurlQueryResponse response =
    alipayClient.execute(request);

if (response.isSuccess()) {
    String downloadUrl = response.getBillDownloadUrl();
    System.out.println("账单下载地址: " + downloadUrl);
} else {
    System.out.println("code: " + response.getCode());
    System.out.println("sub_code: " + response.getSubCode());
    System.out.println("sub_msg: " + response.getSubMsg());
}

取得下载地址后，服务端还需要下载账单压缩包，并根据账单文件的实际编码、字段和格式进行解析。下载地址通常有有效期，不适合长期保存。业务系统应保存解析后的账单数据或原始账单文件。

不同签约产品、账户类型和权限支持的 bill_type、账单周期及字段可能不同，具体要以当前应用在支付宝开放平台中可用的接口文档和实际返回结果为准。

注意事项

调用接口前，需要在支付宝开放平台创建应用、配置密钥，并为应用申请相应的产品和接口权限。
服务商代商户调用接口时，可能还需要 app_auth_token，是否需要取决于具体接入模式。
商户系统应保证 out_trade_no 唯一，并在创建订单时持久化。
收到异步通知后必须验证签名，同时核对 app_id、订单号、金额和收款方等字段。
账单数据和后台页面在时间范围、状态转换、退款展示方式或统计口径上可能存在差异。
不要通过爬取支付宝后台页面获取交易记录。页面结构可能发生变化，而且这种方式会带来登录凭证和账户安全风险。
API 权限、字段和账单规则可能调整。上线前，应以支付宝开放平台中对应应用当前可见的官方接口文档为准。

如何通过 API 获取支付宝后台页面的交易记录？

结论

查询单笔交易

批量获取交易记录

推荐的处理方式

注意事项