alipay.trade.close 与 app支付接口2.0 状态问题

2026-10-24支付老李

结论

用户还没有输入密码时，通常可以关闭交易。
只要支付宝服务端的交易状态仍是 WAIT_BUYER_PAY，调用 alipay.trade.close 一般可以成功。用户是否停留在收银台或已经进入密码输入页面，都不能作为判断依据，最终要看支付宝服务端记录的交易状态。
交易已经支付成功时，关闭通常会失败。
如果交易状态已经变为 TRADE_SUCCESS 或 TRADE_FINISHED，就不能再通过 alipay.trade.close 撤销支付。需要退回资金时，应根据业务情况调用退款接口。
用户输入密码后，商户系统不一定能立即确认交易结果。
输入密码不代表商户端已经收到最终支付结果。网络延迟、客户端中断、异步通知延迟或支付仍在处理中，都可能让商户暂时无法确认结果。最终应以支付宝服务端查询结果和异步通知为准，不能只看 App 返回的 resultStatus。

为什么会出现这些情况

alipay.trade.app.pay、alipay.trade.close 和支付宝的实际支付处理可能同时进行，因此会产生状态竞争：

创建交易
  ↓
WAIT_BUYER_PAY
  ├─ 商户先关闭成功 → TRADE_CLOSED
  └─ 支付先完成     → TRADE_SUCCESS

例如，用户已经输入密码，但支付宝还没有完成支付处理。此时商户发起关闭请求，可能出现以下结果：

关闭操作先成功，交易进入 TRADE_CLOSED，之后无法再完成支付；
支付操作先成功，交易进入 TRADE_SUCCESS，关闭请求失败；
调用过程中发生超时或通信异常，仅凭这次接口响应无法确定最终状态，必须重新查询。

所以，不能根据用户是否输入密码来判断交易能否关闭，也不能把关闭请求报错直接当成已经支付成功。请求参数错误、交易不存在、权限问题或当前交易状态不允许关闭，也可能导致关闭失败。排查时应检查返回的 code、sub_code 和 sub_msg。

Java 处理示例

下面的示例只展示核心判断逻辑。具体异常类型、SDK 初始化方式和日志实现，应以项目实际使用的支付宝 SDK 为准。

public void closeOrderSafely(String outTradeNo) throws AlipayApiException {
    // 1. 先查询支付宝侧状态
    AlipayTradeQueryRequest queryRequest = new AlipayTradeQueryRequest();
    queryRequest.setBizContent(
        "{\"out_trade_no\":\"" + outTradeNo + "\"}"
    );

    AlipayTradeQueryResponse queryResponse = alipayClient.execute(queryRequest);

    if (!queryResponse.isSuccess()) {
        // 查询失败不代表未支付，保留处理中状态并安排补偿查询
        throw new IllegalStateException(
            "Query failed, code=" + queryResponse.getCode()
                + ", subCode=" + queryResponse.getSubCode()
                + ", subMsg=" + queryResponse.getSubMsg()
        );
    }

    String tradeStatus = queryResponse.getTradeStatus();

    if ("TRADE_SUCCESS".equals(tradeStatus)
            || "TRADE_FINISHED".equals(tradeStatus)) {
        markOrderPaidIdempotently(
            outTradeNo,
            queryResponse.getTradeNo()
        );
        return;
    }

    if ("TRADE_CLOSED".equals(tradeStatus)) {
        markOrderClosedIdempotently(outTradeNo);
        return;
    }

    if (!"WAIT_BUYER_PAY".equals(tradeStatus)) {
        // 未识别或处于暂不能关闭的状态，暂不修改为已关闭
        scheduleQueryRetry(outTradeNo);
        return;
    }

    // 2. 交易待支付，尝试关闭
    AlipayTradeCloseRequest closeRequest = new AlipayTradeCloseRequest();
    closeRequest.setBizContent(
        "{\"out_trade_no\":\"" + outTradeNo + "\"}"
    );

    AlipayTradeCloseResponse closeResponse =
        alipayClient.execute(closeRequest);

    if (closeResponse.isSuccess()) {
        markOrderClosedIdempotently(outTradeNo);
        return;
    }

    // 3. 关闭失败可能是并发支付导致，再查询一次最终状态
    logCloseFailure(
        outTradeNo,
        closeResponse.getCode(),
        closeResponse.getSubCode(),
        closeResponse.getSubMsg()
    );

    reconcileOrderByQuery(outTradeNo);
}

实际项目中不要通过字符串拼接生成 JSON。这里采用这种写法只是为了突出处理流程，正式代码应使用 SDK 提供的业务模型或可靠的 JSON 序列化组件。

异步通知示例

public String handleAlipayNotify(
        Map<String, String> params) throws AlipayApiException {

    boolean verified = AlipaySignature.rsaCheckV1(
        params,
        alipayPublicKey,
        "UTF-8",
        "RSA2"
    );

    if (!verified) {
        return "failure";
    }

    String outTradeNo = params.get("out_trade_no");
    String tradeNo = params.get("trade_no");
    String tradeStatus = params.get("trade_status");
    String totalAmount = params.get("total_amount");

    // 还应校验 app_id、金额、收款方等是否与本地订单一致
    validateNotify(outTradeNo, totalAmount, params);

    if ("TRADE_SUCCESS".equals(tradeStatus)
            || "TRADE_FINISHED".equals(tradeStatus)) {
        // 必须幂等，避免重复记账或重复发货
        markOrderPaidIdempotently(outTradeNo, tradeNo);
    }

    return "success";
}

注意事项

alipay.trade.close 只能关闭尚未支付的交易，不能用于退款。
如果交易已经扣款且状态为 TRADE_SUCCESS，应先核对订单和资金状态，再按照业务规则退款。
接口超时、网络断开或没有收到响应，都表示结果未知，不能直接判定操作失败。
App 返回取消、失败或未知状态，不能证明支付宝侧没有扣款。
主动查询和异步通知可能乱序到达。本地状态更新必须保持幂等，同时防止后到的关闭结果覆盖已经成功支付的订单状态。
自动关单应给用户留出合理的支付时间，并在关单前后核对交易状态，尽量减少用户付款过程中发生的状态竞争。

alipay.trade.close 与 app支付接口2.0 状态问题

结论

为什么会出现这些情况

推荐处理流程

1. 使用同一个商户订单号

2. 关闭前先查询交易

3. 根据关闭结果更新订单

4. 以服务端结果确认支付

Java 处理示例

异步通知示例

注意事项