淘宝开放平台

登录
文档中心 > 担保交易（已下线）

页面跳转同步参数说明

更新时间：2016/08/05 访问次数：19531

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

参数 参数名称 类型（长度范围） 参数说明 是否可为空 样例
is_success 成功标识 String(1) 表示接口调用是否成功，并不表明业务处理结果。 不可空 T
partnerId 合作身份者ID String(16) 签约的支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。 不可空 2088102011070566
sign_type 签名方式 String DSA、RSA、MD5三个值可选，必须大写。 不可空 MD5
sign 签名 String 请参见签名验证。 不可空 98c50adcfac605f4033587684d00b002
charset 参数编码字符集 String 商户网站使用的编码格式，如UTF-8、GBK、gb2312等。 可空 GBK
notify_id 通知校验ID String 支付宝通知校验ID，商户可以用这个流水号询问支付宝该条通知的合法性。 不可空 RqPnCoPT3K9%2Fvwbh3I%2BFiox8ptihzJoEoaWZbNBCD%2FU8bYsc57yqnRUNEpX00RjhlXrf
notify_type 通知类型 String 通知类型。交易状态改变时发送的同步通知。 不可空 trade_status_sync
notify_time 通知时间 Date 通知时间（支付宝时间）。格式为yyyy-MM-dd HH:mm:ss。 不可空 2010-12-15 18:42:23
trade_no 交易号 String(64) 创建订单生成的交易号。最短16位，最长64位。 不可空 2010121502618142
subject 商品名称 String 商品的标题/交易标题/订单标题/订单关键字等。 不可空 订单编号：20110105154925
price 商品单价 Number 单位为：RMB Yuan。取值范围为[0.01，1000000.00]，精确到小数点后两位。 不可空 328
quantity 商品数量 Number 商品的数量。 不可空 1
seller_email 卖家支付宝账号 String 登录时，seller_email和seller_id两者必填一个。 不可空 zhoubo_seller@alitest.com
buyer_email 买家支付宝账号 String 买家支付宝账号。 不可空 zhoubo_buyer@alitest.com
seller_id 卖家支付宝账号对应的支付宝唯一用户号 String 卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。登录时，seller_email和seller_id两者必填一个。 不可空 2088102010217433
buyer_id 买家ID String 买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。 不可空 2088102010217422
discount 商品折扣 Number 支付宝系统会把discount的值加到交易金额上，如果需要折扣，本参数为负数。单位为：RMB Yuan，精确到小数点后两位。缺省值为0元。 不可空 0.00
total_fee 总额 Number 单笔交易金总额，单位为RMB-Yuan。取值范围为[0.01，1000000.00]，精确到小数点后两位。 不可空 338
trade_status 交易状态 String 取值范围请参见“交易状态”。 不可空 WAIT_SELLER_SEND_GOODS
is_total_fee_adjust 总价是否调整过 String 总价是否调整过。 不可空 N
use_coupon 是否使用红包 String 是否使用红包。 不可空 N
out_trade_no 商户网站唯一订单号 String 对应商户网站的订单系统中的唯一订单号，非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。 可空 5562802405885664
body 商品描述 String 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。 可空 2G录音笔
payment_type 收款类型 String 收款类型，只支持1：商品购买。 可空 1
logistics_type 物流类型 String 取值范围请参见“物流类型”。 可空 EMS
logistics_fee 物流运费 String 物流运费。单位为：RMB Yuan。精确到小数点后两位。 可空 15.00
logistics_payment 物流支付类型 String 取值范围请参见“物流支付类型”。 可空 BUYER_PAY
gmt_logistics_modify 物流状态更新时间 Date 物流状态更新时间。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-15 18:42:12
buyer_actions 买家动作集合 String 取值范围请参见“交易状态”。 可空 WAIT_SELLER_SEND_GOODS
seller_actions 卖家动作集合 String 取值范围请参见“交易状态”。 可空 SEND_GOODS
gmt_create 交易创建时间 Date 该笔交易创建的时间。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-15 18:42:12
gmt_payment 交易支付时间 Date 该笔交易的买家付款时间。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-15 18:42:19
refund_status 退款状态 String 取值范围请参见“退款状态”。 可空 WAIT_SELLER_AGREE
gmt_refund 交易退款时间 Date 卖家退款的时间，退款通知时会发送。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-15 18:52:12
receive_name 收货人姓名 String 收货人姓名。 可空 张三
receive_address 收货人地址 String 收货人地址。 可空 上海普陀区XX路
receive_zip 收货人邮编 String 收货人邮编。 可空 123456
receive_phone 收货人电话 String 收货人电话。 可空 02161686888
receive_mobile 收货人手机 String 收货人手机。 可空 13800000000 
http://商户自定义地址/alipay/return_url.php?body=2G%e5%bd%95%e9%9f%b3%e7%ac%94&buyer_email=zhoubo_buyer%40alitest.com&buyer_id=2088102010217422&discount=0.00&gmt_create=2011-01-05+16%3A04%3A22&gmt_logistics_modify=2011-01-05+16%3A04%3A30&gmt_payment=2011-01-05+16%3A05%3A26&is_success=T&is_total_fee_adjust=Y&logistics_fee=10.00&logistics_payment=BUYER_PAY&logistics_type=POST&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BFiox8ptihzJoEoaWZbNBCD%252FU8bYsc57yqnRUNEpX00RjhlXrf&notify_time=2011-01-05+16%3A05%3A27&notify_type=trade_status_sync&out_trade_no=3519962296059456&payment_type=1&price=338.00&quantity=1&receive_address=%e4%b8%8a%e6%b5%b7%e6%99%ae%e9%99%80%e5%8c%baXX%e8%b7%af&receive_mobile=18858194584&receive_name=%e5%bc%a0%e4%b8%89&receive_phone=57126888888&receive_zip=310099&seller_actions=SEND_GOODS&seller_email=zhoubo_seller%40alitest.com&seller_id=2088102010217433&subject=%e8%ae%a2%e5%8d%95%e7%bc%96%e5%8f%b7%ef%bc%9a20110105154925&total_fee=348.00&trade_no=2011010502667642&trade_status=WAIT_SELLER_SEND_GOODS&use_coupon=N&sign=b18c14fadbc76d2def8fa65c1ca82751&sign_type=MD5

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

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

  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
有用(9) 我要提问
返回
顶部