支付宝同步通知说明 -凯发app官方网站

更新时间：2024-07-10 11:34:05

我的文档

设置

简介

支付宝同步通知根据 return_url 进行设置。

return_url 为同步跳转地址，支付接口的公共请求参数。可实现支付成功后跳转到商家页面的功能，而且跳转后的 return_url 页面的地址栏中会返回同步通知参数。

注意

：由于return_url 回跳的不可靠性，前台回跳只能作为商家支付结果页的入口，最终支付结果必须以异步通知或查询接口返回为准，不能依赖前台回跳。

如何设置同步地址

●

return_url 必须是 http 或 https 开头的完整的 url 地址。

●

return_url 地址后不可带自定义参数。

●

设置 return_url 时不要进行转义、urlencode 等数据处理。

●

当面付和 app 支付不支持 return_url 参数，即使设置了也没有任何效果。

设置示例

java 版

request.setreturnurl("商户设置的同步地址");

php 版

$request->setreturnurl("商户设置的同步地址");

.net 版

request.setreturnurl("商户设置的同步地址");

同步通知返回参数介绍

商户需使用 get 方式接收同步通知，如 returnurl 设置

。

return_url 参数后面？拼接的就是同步返回参数，返回的同步通知参数如下（以下示例报文仅供参考，实际返回的详细报文请以实际返回为准）

支付后同步跳转页面 returnurl 地址如下图（以电脑网站支付为例）：

同步通知验签

同步通知验签方式和异步验签方式相同。

为了帮助开发者调用开放接口，我们提供了

，包含 java、php 和 .net 等语言版本，封装了签名&验签、http 接口请求等基础功能。为了避免验签出错强烈建议先下载对应语言版本的 sdk 并引入您的开发工程进行快速接入。

验签步骤

在通知返回参数列表中，除去 sign、sign_type 两个参数外，凡是通知返回回来的参数皆是待验签的参数。将剩下参数进行 url_decode，然后进行字典排序，组成字符串，得到待签名字符串。

将签名参数（sign）使用 base64 解码为字节码串。

使用 rsa 的验签方法，通过签名字符串、签名参数（经过base64解码）及支付宝公钥验证签名。

在验证签名正确后，必须再严格按照如下描述校验通知数据的正确性。

注意事项

●

get 获取的同步通知需 url_decode 处理，不处理会导致验签失败。

●

由于同步通知中不含有 trade_status（交易状态），无法确认交易信息，建议根据异步通知或

返回的 trade_status（交易状态）为准。

同步不跳转

如用户遇到同步不跳转的问题，请根据以下说明进行排查：

●

接口是否支持 reurn_url，如 app 支付和当面付设置了 reurn_url 也是不生效的。

●

reurn_url 设置方式是否正确，传参方式、传参位置错误都会导致不生效。

●

同步未跳转时，就调用商家分账接口会进行干扰的。

●

已经跳转了，但是商户以为没有跳转。

详情请参见

。

相关问题