文档中心 > 网银支付(已下线)

页面跳转同步参数说明

更新时间:2015/10/22 访问次数:24043

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

参数 参数名称 类型(字节长度) 参数说明 是否可为空 样例
is_success 成功标识 String(1) 表示接口调用是否成功,并不表明业务处理结果。 不可空 T
sign_type 签名方式 String DSA、RSA、MD5三个值可选,必须大写。 不可空 MD5
sign 签名 String(32) 请参见签名验证 不可空 b1af584504b8e845ebe40b8e0e733729
out_trade_no 商户网站唯一订单号 String(64) 对应商户网站的订单系统中的唯一订单号,非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数,原样返回。 可空 6402757654153618
subject 商品名称 String(256) 商品的标题/交易标题/订单标题/订单关键字等。 可空 手套
payment_type 支付类型 String(4) 对应请求时的payment_type参数,原样返回。 可空 1
exterface 接口名称 String 标志调用哪个接口返回的链接。 可空 create_direct_pay_by_user
trade_no 支付宝交易号 String(64) 该交易在支付宝系统中的交易流水号。最长64位。 可空 2008102303210710
trade_status 交易状态 String 交易目前所处的状态。成功状态的值只有两个:
TRADE_FINISHED(普通即时到账的交易成功状态);
TRADE_SUCCESS(开通了高级即时到账或机票分销产品后的交易成功状态)
可空 TRADE_FINISHED
notify_id 通知校验ID String 支付宝通知校验ID,商户可以用这个流水号询问支付宝该条通知的合法性。 可空 RqPnCoPT3K9%2Fvwbh3I%2BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG
notify_time 通知时间 Date 通知时间(支付宝时间)。格式为yyyy-MM-dd HH:mm:ss。 可空 2008-10-23 13:17:39
notify_type 通知类型 String 返回通知类型。 可空 trade_status_sync
seller_email 卖家支付宝账号 String(100) 卖家支付宝账号,可以是Email或手机号码。 可空 chao.chenc1@alipay.com
buyer_email 买家支付宝账号 String(100) 买家支付宝账号,可以是Email或手机号码。 可空 tstable01@alipay.com
seller_id 卖家支付宝账户号 String(30) 卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。 可空 2088002007018916
buyer_id 买家支付宝账户号 String(30) 买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。 可空 2088101000082594
total_fee 交易金额 Number 该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。 可空 10.00
body 商品描述 String(400) 对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。 可空 Hello
bank_seq_no 网银流水 String(64) 网银流水号。只有开通了纯网关和伪网关的商户,才返回该参数。 可空 招行:9220031730;建行:20100329000000859967
extra_common_param 公用回传参数 String 用于商户回传参数,该值不能包含“=”、“&”等特殊字符。如果用户请求时传递了该参数,则返回给商户时会回传该参数。 可空 你好,这是测试商户的广告。
http://商户自定义地址/alipay/return_url.php?is_success=T&sign=b1af584504b8e845ebe40b8e0e733729&sign_type=MD5&body=Hello&buyer_email=xinjie_xj%40163.com&buyer_id=2088101000082594&exterface=create_direct_pay_by_user&out_trade_no=6402757654153618&payment_type=1&seller_email=chao.chenc1%40alipay.com&seller_id=2088002007018916&subject=%E5%A4%96%E9%83%A8FP&total_fee=10.00&trade_no=2008102303210710&trade_status=TRADE_FINISHED&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG&notify_time=2008-10-23+13%3A17%3A39&notify_type=trade_status_sync&extra_common_param=%E4%BD%A0%E5%A5%BD%EF%BC%8C%E8%BF%99%E6%98%AF%E6%B5%8B%E8%AF%95%E5%95%86%E6%88%B7%E7%9A%84%E5%B9%BF%E5%91%8A%E3%80%82&bank_seq_no=%E6%8B%9B%E8%A1%8C%E7%9A%84%E8%AE%A2%E5%8D%95%E5%8F%B7%E5%BD%A2%E5%A6%829220031730%3B%0D%0A%E5%BB%BA%E8%A1%8C%E7%9A%84%E5%BD%A2%E5%A6%8220100329000000859967

说明:
本样例仅供参考,实际网关为商户域名。

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

  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

关于此文档暂时还没有FAQ
返回
顶部