明确结论

return_url 是支付流程结束后前端页面的同步跳转地址。它不是支付结果通知地址，也不意味着只有支付成功时才会触发。

在常见的手机网站支付流程中：

• 支付成功后，支付页面通常会跳转到 return_url。
• 遇到风控拦截、余额不足或付款失败时，用户往往会停留在支付平台的错误提示页或收银台，通常不会立即跳转到 return_url。
• 用户取消支付、关闭页面、网络中断或浏览器拦截跳转时，也可能无法进入 return_url。
• 即使浏览器进入了 return_url，也不能直接认定支付成功。

在支付失败时，页面是否提供“返回商家”入口，以及用户点击后是否进入 return_url，取决于支付产品、客户端和收银台页面的具体行为。应以接入平台的当前文档和实际测试结果为准。

为什么不能依赖 return_url 判断支付结果

return_url 需要由用户浏览器完成跳转，可能受到多种情况影响：

1. 用户支付后直接关闭了页面。
2. 支付失败后停留在收银台，没有返回商户页面。
3. 网络异常导致跳转请求未能发出。
4. App、内置浏览器和系统浏览器相互切换时，跳转被中断。
5. 回跳参数可能被修改或重复提交。

因此，return_url 更适合用来展示“支付结果确认中”页面。订单的实际状态应由服务端异步通知或主动查询确定。

推荐处理方式

1. 配置异步通知地址

提交支付请求时，同时设置 notify_url。支付平台确认交易状态发生变化后，会向该地址发送服务端通知。

收到通知后，需要：

• 验证签名；
• 核对商户订单号；
• 核对交易金额和商户身份；
• 根据明确的交易状态更新订单；
• 做好幂等处理，避免重复通知导致重复入账；
• 按照支付平台的要求返回响应内容。

2. return_url 只负责结果展示

用户跳转回来后，页面不应直接显示“支付成功”，而应根据商户订单号向自己的服务端查询订单状态：

async function loadPaymentResult(outTradeNo) {
  const response = await fetch(
    `/api/orders/${encodeURIComponent(outTradeNo)}/payment-status`,
    {
      method: "GET",
      credentials: "include"
    }
  );

  if (!response.ok) {
    throw new Error("Failed to query payment status");
  }

  const result = await response.json();

  switch (result.status) {
    case "PAID":
      showSuccess();
      break;
    case "CLOSED":
    case "FAILED":
      showFailure();
      break;
    default:
      showPending();
  }
}

这段代码查询的是商户服务端保存的订单状态，而不是仅凭回跳地址中的参数判断支付结果。

3. 主动查询状态未确定的订单

异步通知可能会延迟。如果用户已经进入 return_url，订单却仍显示“待支付”，可以由服务端调用支付平台的交易查询接口，再根据查询结果决定是否更新订单。

下面是通用伪代码。实际使用的 API 名称和返回字段应以接入平台的文档为准：

public PaymentStatus getPaymentStatus(String outTradeNo) {
    Order order = orderRepository.findByOutTradeNo(outTradeNo);

    if (order.isPaid()) {
        return PaymentStatus.PAID;
    }

    PaymentQueryResult result = paymentClient.query(outTradeNo);

    if (result.isTradeSuccess()) {
        verifyMerchant(result);
        verifyAmount(order, result);
        markOrderPaidIdempotently(order, result.getTradeNo());
        return PaymentStatus.PAID;
    }

    if (result.isTradeClosed()) {
        return PaymentStatus.CLOSED;
    }

    return PaymentStatus.PENDING;
}

注意事项

• 不要将“进入 return_url”等同于“支付成功”。
• 用户没有跳回 return_url，也不代表支付失败，订单可能已经付款成功。
• 不要只校验回跳参数。还应校验异步通知签名，并通过服务端订单状态或交易查询结果确认交易状态。
• notify_url 必须是支付平台服务器能够访问的公网地址，不能依赖登录状态、Cookie 或前端页面。
• 异步通知可能重复发送，因此订单更新必须具备幂等性。
• 比较金额时应使用精确的小数类型或最小货币单位，避免浮点数误差。
• 对长时间处于待支付状态的订单，应通过定时查询、订单关闭机制或人工补单流程处理。

风控异常、余额不足等支付失败场景通常不会自动跳转到 return_url，但业务系统不能根据是否发生回跳来判断支付结果。可靠的处理方式是以 notify_url 的服务端异步通知为主，以交易查询为补充，return_url 只用于展示页面。

备注：内容仅供参考。