请求参数说明

请求参数是商户在与支付宝进行数据交互时，提供给支付宝的请求数据，以便支付宝根据这些数据进一步处理。

https://mapi.alipay.com/gateway.do?sign=301bf1672544be3fdb7bc9a717f78373&exter_invoke_ip=10.2.40.81&target_service=user.auth.quick.login&sign_type=MD5&service=alipay.auth.authorize&partner=2088101012319596&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm

说明：
本样例仅供参考，支付宝网关为https://mapi.alipay.com/gateway.do。

页面跳转参数说明

支付宝对商户的请求数据处理完成后，会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给商户网站。这些处理结果数据就是页面跳转同步通知参数。

http://商户自定义地址/alipay/return_url.php?is_success=T&notify_id=RqPnCoPT3K9%252Fvwbh3I7xsk%252BvCEcoKkr4ElTG1wX%252FYXl4%252BqIuUrJcYkwJxvYJXQpHX3tj&real_name=%D7%A8%D2%B5%B0%E6NOIV&token=201103296887f2954c914d4e81775e8b769ad4eb&user_id=2088101010749876&sign=c0f6821d5276e2f7a54439d19f349026&sign_type=MD5

注意：

• 由于etao主动跳转的url，和普通的快捷登录url相比，多一个target_url参数，因此，建议商户在集成快捷登录接口时，在目标跳转页面优先处理target_url，而后再处理正常的业务参数，便于区分两种跳转方式。
• 本样例仅供参考，实际网关为商户域名。

etao搜索结果跳转页面的处理

商户签约支付宝快捷登录时，如果提供了固定的快捷登录处理页面（一般为快捷登录接口中传递的return_url），则当买家在etao上进行商品搜索时，etao可以引导买家到相应的商品详情页面，这个跳转过程由支付宝完成。etao商品搜索的交互流程图如下：

目前对于etao搜索，支付宝的跳转方式有以下两种：

跳转方式一

• 商户签约了快捷登录；
• 商户向支付宝提供了快捷登录的登录后处理页面路径（即参数return_url的值）；
• 买家已经登录淘宝网站或者支付宝网站。

满足以上三个条件的情况下，支付宝会主动调用商户的页面跳转同步通知页面（参数return_url），并且会把本接口的所有页面跳转同步通知参数全部返回给商户。跳转url示例如下：

http://www.126.com/?is_success=T&notify_id=RqPnCoPT3K9%252Fvwbh3I7xtnO7far28tp8tXfvKVhVHdFp%252FTtgAJMM16LqkfSYXQLbR0Gn&real_name=wang0555s&target_url=http%3A%2F%2Fitem.mbaobao.com%2Fpshow-1201012803.html&token=2011042971db9a3ed2904d4e8d3fc4669a7758fe&user_id=2088102008703762&sign=8d8dc7d5048f7dece74bb341e37d19a3&sign_type=MD5

跳转方式二

• 商户签约了快捷登录；
• 商户向支付宝提供了快捷登录的登录后处理页面路径（即参数return_url的值）；
• 买家未登录淘宝网站或者支付宝网站。

满足以上三个条件的情况下，支付宝会主动调用商户的页面跳转同步通知页面（参数return_url），并且只返回快捷登录接口基本返回参数和target_url。示例如下：

http://www.126.com/?is_success=T&notify_id=RqPnCoPT3K9%252Fvwbh3I7xtnO7fa8zrjhCodocSH%252FjvG6LvT5pgMNnK24j5U9vRQKtSQRH&target_url=http%3A%2F%2Fitem.mbaobao.com%2Fpshow-1201012803.html&sign=f008dc826656a7d8ae66554c30034989&sign_type=MD5

注意：

• etao快捷登录跳转商户网站时，支付宝会对跳转url进行签名，签名时，会从目标商户网站支持的所有签名方式中进行选择，优先选择RSA；如果商户不支持RSA，则选择DSA，最后再选择MD5签名。商户验证签名时，需要根据返回url中的sign_type参数进行验签处理；
• 商户向支付宝提供了快捷登录的登录后处理页面路径并不是指调用快捷登录接口时使用return_url，而是指商户与支付宝签约时，商户需要提供一个页面路径地址让支付宝记录与配置，而这个页面路径地址就是快捷登录中页面跳转同步通知页面路径（参数return_url）的地址。

页面跳转同步通知页面特性

1. 用户在登录成功后会看到一个支付宝提示登录的页面，该页面会停留几秒，然后会自动跳转回商户指定的同步通知页面（参数return_url）。

2. 该页面中获得参数的方式，需要使用GET方式获取，如request.QueryString("out_trade_no")、$_GET['out_trade_no']。后续商户可根据获取的信息作处理，譬如，可以把获取到的token放入session中，以便于后续需要使用到token访问支付宝相应服务时，可以便捷地重用。

3. 该方式仅仅在用户登录完成以后进行自动跳转，因此只会进行一次。

4. 该方式不是支付宝主动去调用商户页面，而是支付宝的程序利用页面自动跳转的函数，使用户的当前页面自动跳转。

5. 该方式可在本机而不是只能在服务器上进行调试。

6. 返回URL只有一分钟的有效期，超过一分钟该链接地址会失效，验证则会失败。

7. 设置页面跳转同步通知页面（return_url）的路径时，不要在页面文件的后面再加上自定义参数。例如：

• 错误的写法：http://www.alipay.com/alipay/return_url.php?xx=11
• 正确的写法：http://www.alipay.com/alipay/return_url.php

8. 由于支付宝会对页面跳转同步通知页面（return_url）的域名进行合法有效性校验，因此设置页面跳转同步通知页面（return_url）的路径时，不要设置成本机域名，也不能带有特殊字符（如“!”），如：

• 错误的写法：
  http://localhost/alipay/return_url.php
  http://localhost:80/alipay/return_url.php
  http://商户自定义地址/alipay/return!url.do
• 正确的写法：
  能够正常访问的域名地址：http://商户自定义地址/alipay/return_url.php
  能够正常访问的IP地址：http://121.1.1.255/alipay/return_url.php

业务错误码

FAQ