PAYATHON 2026

查询交易投诉列表成功但无支付交易投诉数据，如何处理？

支付阿杰

结论

这个返回结果说明接口调用成功，但在当前请求参数和商户身份范围内，没有查到匹配的交易投诉记录。

Code 为 "10000"、Msg 为 "Success"、IsError 为 false，表示接口没有发生业务错误或系统错误。TotalNum 和 TotalPageNum 都是 0，表示查询结果为空。此时 TradeComplainInfos 返回 null，业务代码通常应将其当作空列表处理，而不是接口调用失败。

响应中的 PageNum 为 0，这一点需要检查。如果接口要求页码从 1 开始，可以把请求页码改为 1 后重新查询。具体取值范围应以当前使用的支付宝开放平台接口文档和 SDK 定义为准。

返回字段说明

这些字段可以分为两组：

  • Code = "10000"、Msg = "Success"、IsError = false：接口已经正常受理并完成请求。
  • TotalNum = 0、TotalPageNum = 0、TradeComplainInfos = null：当前条件下没有符合要求的数据。

因此，不能只根据 TradeComplainInfos == null 判断接口异常。处理时应先检查 Code 和 IsError，确认调用成功，再根据 TotalNum 判断是否查到记录。

建议的排查步骤

1. 检查分页参数

当前响应中的 PageNum 为 0。如果请求传入了 page_num = 0，需要确认接口是否接受这个值。

如果接口文档规定页码从 1 开始，可以改为：

page_num = 1
page_size = 10

不同接口的分页规则可能不同，不要根据其他分页接口的习惯推断起始页码，应以【查询交易投诉列表】接口当前文档中的参数约束为准。

2. 放宽查询条件

如果请求中设置了投诉时间、投诉状态或交易号等筛选条件，可以先减少条件，再逐项排查：

  1. 使用合法的起止时间，并确认开始时间早于结束时间。
  2. 适当扩大查询的时间范围。
  3. 暂时去掉非必填的投诉状态、交易号等条件。
  4. 从第 1 页开始查询。
  5. 确认时间格式和时区符合接口要求。

如果放宽条件后可以查到数据，再逐个恢复筛选条件，就能判断是哪个条件导致结果为空。

3. 核对查询主体

交易投诉数据通常与查询所用的商户身份、应用授权关系以及交易归属有关。请检查以下内容：

  • 当前 app_id 是否对应正确的应用。
  • 请求使用的商户账号是否为相关交易的收款主体。
  • 服务商代商户调用时，是否使用了正确的被授权商户身份。
  • 授权令牌是否属于目标商户，并且仍然有效。
  • 投诉对应的交易是否发生在当前查询主体下。

例如，交易属于商户 A，但接口实际使用商户 B 的身份查询。即使调用成功，也可能返回零条记录。

4. 确认投诉类型和数据范围

先确认目标记录属于该接口支持查询的“交易投诉”。其他渠道产生的客诉、平台工单、退款争议或非支付交易投诉，不一定会出现在这个接口中。

还要检查目标投诉的创建时间是否处于接口允许查询的时间范围内。至于接口是否存在数据同步延迟或历史数据范围限制，应以当前官方接口文档为准，不能根据一次空结果直接下结论。

5. 使用已知记录进行验证

如果商户后台能看到一条确定存在的支付交易投诉，可以用这条记录进行对照测试：

  • 查询覆盖该投诉创建时间的时间段。
  • 使用该交易所属商户的身份发起请求。
  • 去掉不必要的状态筛选条件。
  • 从第 1 页开始查询。

如果后台存在记录，但使用正确的查询主体和时间范围后仍然返回 TotalNum = 0，建议保存完整的请求参数、响应报文和接口请求流水号，并提交给支付宝开放平台技术支持核查。

代码处理示例

业务代码应把调用成功但没有数据的响应转换为空集合，避免直接遍历 null。

if (response == null) {
    throw new IllegalStateException("查询交易投诉列表未返回响应");
}

if (response.isError() || !"10000".equals(response.getCode())) {
    throw new IllegalStateException(
        "查询交易投诉列表失败，code=" + response.getCode()
            + ", msg=" + response.getMsg()
            + ", subCode=" + response.getSubCode()
            + ", subMsg=" + response.getSubMsg()
    );
}

List<TradeComplainInfo> complainInfos =
    response.getTradeComplainInfos() == null
        ? Collections.emptyList()
        : response.getTradeComplainInfos();

if (response.getTotalNum() == 0) {
    // 接口调用成功，但当前条件下没有投诉记录
    System.out.println("当前查询条件下无交易投诉数据");
} else {
    for (TradeComplainInfo complainInfo : complainInfos) {
        // 处理投诉记录
    }
}

如果实际使用的 SDK 类型或方法名与示例不同，请按对应 SDK 调整。判断逻辑仍然是：

调用是否成功 → 是否存在匹配记录 → 安全处理 null 列表

请求参数检查示例

以下代码只用于说明排查思路，参数名称和格式应以实际 SDK 及当前接口文档为准：

Model model = new Model();

// 如果接口规定页码从 1 开始
model.setPageNum(1L);
model.setPageSize(10L);

// 设置一个合法且覆盖目标投诉的查询时间范围
model.setStartTime(startTime);
model.setEndTime(endTime);

// 排查阶段可暂不设置非必填的状态、交易号等过滤条件

不要试图通过反复修改 page_size 解决 TotalNum = 0。page_size 只控制每页返回的数量，不会让不符合查询条件的数据出现在结果中。

注意事项

  • 当 TotalNum = 0 时，应将 TradeComplainInfos = null 当作空集合处理。
  • Code = "10000" 只表示本次接口调用成功，不代表一定查到了投诉数据。
  • 不建议通过解析 Body 字符串判断结果，应优先使用 SDK 已经解析的响应字段。
  • 记录排查信息时，不要输出应用私钥、商户私钥、授权令牌等敏感内容。
  • sign 是响应签名，不属于投诉数据。使用 SDK 时，应确保响应验签配置正确。
  • 如果调整页码、时间范围和商户身份后仍然查不到数据，但商户后台确实存在对应投诉，应携带请求流水号以及脱敏后的请求、响应信息联系平台技术支持。

备注：内容仅供参考。