支付宝电脑网站支付及回调

最新推荐文章于 2024-10-22 15:34:33 发布

原创

最新推荐文章于 2024-10-22 15:34:33 发布 · 3.2k 阅读

7 ·

CC 4.0 BY-SA版权

本文详细介绍了支付宝电脑网站支付接口`alipay.trade.page.pay`的调用顺序，包括用户确认支付后的同步返回和异步通知。强调支付结果必须依赖异步通知或查询接口，而非同步跳转，并提醒商户进行验签和一致性检查。同时，提供了JAVA SDK的使用示例，包括下单支付、查询交易状态和验签的代码片段。最后，指出了新版支付接口的特性及回调成功后的返回要求。

官方文档：https://docs.open.alipay.com/270

支付

电脑网站支付的支付接口 alipay.trade.page.pay 调用时序图如下：
电脑网站支付.png

调用顺序如下：

商户系统请求支付宝接口 alipay.trade.page.pay，支付宝对商户请求参数进行校验，而后重新定向至用户登录页面。
用户确认支付后，支付宝通过 get 请求 returnUrl（商户入参传入），返回同步返回参数。
交易成功后，支付宝通过 post 请求 notifyUrl（商户入参传入），返回异步通知参数。
若由于网络等问题异步通知没有到达，商户可自行调用交易查询接口 alipay.trade.query 进行查询，根据查询接口获取交易以及支付信息（商户也可以直接调用查询接口，不需要依赖异步通知）。

注意：

由于同步返回的不可靠性，支付结果必须以异步通知或查询接口返回为准，不能依赖同步跳转。
商户系统接收到异步通知以后，必须通过验签（验证通知中的 sign 参数）来确保支付通知是由支付宝发送的。详细验签规则参考异步通知验签。
接收到异步通知并验签通过后，一定要检查通知内容，包括通知中的 app_id、out_trade_no、total_amount 是否与请求中的一致，并根据 trade_status 进行后续业务处理。
在支付宝端，partnerId 与 out_trade_no 唯一对应一笔单据，商户端保证不同次支付 out_trade_no 不可重复；若重复，支付宝会关联到原单据，基本信息一致的情况下会以原单据为准进行支付。

开放平台提供了支持主流开发语言的 SDK 接入的方式。对于页面跳转类 API，SDK 不会也无法像系统调用类 API 一样自动请求支付宝并获得结果，而是在接受 request 请求对象后，为开发者生成前台页面请求需要的完整 form 表单的 html（包含自动提交脚本），商户直接将这个表单的 String 输出到 http response 中即可。

以 JAVA 语言为例，调用统一收单下单并支付页面接口 alipay.trade.page.pay 的代码示例如下：

public void doPost(HttpServletRequest httpRequest,
                      HttpServletResponse httpResponse) throws ServletException, IOException {
    AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE); //获得初始化的AlipayClient
    AlipayTradePagePayRequest alipayRequest = new AlipayTradePagePayRequest();//创建API对应的request
    alipayRequest.setReturnUrl("http://domain.com/CallBack/return_url.jsp");
    alipayRequest.setNotifyUrl("http://domain.com/CallBack/notify_url.jsp");//在公共参数中设置回跳和通知地址
    alipayRequest.se