支付宝支付成功后点击“完成”如何跳转到自定义页面？

2026-10-24支付小周

明确结论

跳转地址需要在服务端创建支付宝支付请求时通过 return_url 设置，不能在支付成功页面、前端路由或异步通知接口中配置。

在前后端分离项目中，前端可以把结果页的完整 URL 提供给后端，再由后端调用支付宝支付接口时写入。例如：

https://www.example.com/payment/result

如果接入的是第三方聚合支付平台，需要查看其下单接口是否提供 returnUrl、frontUrl 或“同步跳转地址”等参数。如果聚合平台没有把该参数传给支付宝，商户前端就无法直接控制支付宝右上角“完成”按钮的跳转地址。

为什么要在后端配置

支付宝支付结果页运行在支付宝环境中，商户页面里的 JavaScript 无法修改页面按钮的行为。用户点击“完成”后跳转到哪里，通常由创建支付请求时提交的同步返回地址决定。

下面两个参数很容易混淆：

return_url：用户在浏览器或支付宝客户端完成支付后返回的前端页面。
notify_url：支付宝向商户服务器发送异步通知的接口，供后端可靠地更新订单状态。

return_url 用于页面跳转，notify_url 用于确认支付结果，二者不能互相替代。

配置方式

以支付宝手机网站支付 alipay.trade.wap.pay 为例，后端可以在创建请求时设置 return_url：

AlipayTradeWapPayRequest request = new AlipayTradeWapPayRequest();

request.setReturnUrl("https://www.example.com/payment/result");
request.setNotifyUrl("https://api.example.com/alipay/notify");

request.setBizContent("""
{
  "out_trade_no": "ORDER_202609090001",
  "total_amount": "99.00",
  "subject": "订单支付",
  "product_code": "QUICK_WAP_WAY"
}
""");

AlipayTradeWapPayResponse response = alipayClient.pageExecute(request);

if (response.isSuccess()) {
    String paymentForm = response.getBody();
    // 将 paymentForm 返回给前端，或直接输出到浏览器
}

其中，return_url 指向支付完成后的用户页面，notify_url 则是后端接收异步通知的接口。

如果后端使用参数对象或配置文件统一管理地址，也可以采用类似的结构：

alipay:
  return-url: https://www.example.com/payment/result
  notify-url: https://api.example.com/alipay/notify

进入结果页后，前端可以根据订单号向后端查询支付状态：

const params = new URLSearchParams(window.location.search);
const orderNo = params.get("out_trade_no");

fetch(`/api/orders/${encodeURIComponent(orderNo)}/payment-status`)
  .then(response => response.json())
  .then(order => {
    if (order.paymentStatus === "PAID") {
      // 展示支付成功状态
    }
  });

前后端分离时的处理流程

可以按下面的流程处理：

前端向后端提交订单，请求创建支付。
后端生成商户订单号，并调用支付宝或聚合支付平台的下单接口。
后端在下单请求中设置 return_url 和 notify_url。
前端进入支付宝收银台并完成支付。
支付宝通过 notify_url 通知后端，后端验签后更新订单。
用户点击“完成”，进入 return_url 指向的前端页面。
前端根据订单号向后端查询最终支付状态。

如果结果页使用 SPA 路由，例如：

https://www.example.com/#/payment/result

需要确认支付宝或聚合支付平台能否完整保留 URL 中的 # 片段。使用 History 路由通常更稳妥：

https://www.example.com/payment/result

同时还要在 Nginx 等 Web 服务器中配置前端路由回退：

location / {
    try_files $uri $uri/ /index.html;
}

使用聚合支付时需要检查什么

“扫描聚合支付二维码”通常表示下单请求并非直接发给支付宝。此时需要查看聚合支付服务商的接口文档和管理后台，确认是否支持以下参数之一：

return_url
returnUrl
front_url
frontUrl
redirect_url
redirectUrl

具体参数名应以所用平台的接口文档为准，不能自行猜测。如果聚合支付接口没有提供同步返回地址，或者平台固定了支付宝收银台的退出行为，需要联系平台确认能否定制。

注意事项

return_url 通常应填写外网可以访问的完整 HTTPS 地址，不能使用 /payment/result 这样的相对路径。
生产环境中不要使用 localhost、内网 IP 或前端开发服务器地址作为跳转地址。
不能只根据跳转页面或 URL 参数判断支付是否成功。同步跳转可能被用户中断，参数也可能被伪造。
后端必须验证支付宝异步通知的签名，并核对商户订单号、金额和应用身份等信息。
如果跳转地址由前端传入，后端应通过白名单进行校验，避免产生开放重定向漏洞。
支付宝客户端版本、聚合支付平台的实现方式及具体支付产品都可能影响最终的退出行为。如果已经正确设置 return_url 但仍未跳转，应先确认聚合平台是否确实将该参数传给了支付宝。