支付宝对商户的请求数据处理完成后,会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给商户网站。这些处理结果数据就是页面跳转同步通知参数。
参数 | 参数名称 | 类型(字节长度) | 参数说明 | 是否可为空 | 样例 |
---|---|---|---|---|---|
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¬ify_id=RqPnCoPT3K9%252Fvwbh3I%252BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG¬ify_time=2008-10-23+13%3A17%3A39¬ify_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
说明:
本样例仅供参考,实际网关为商户域名。
设置页面跳转同步通知页面(return_url)的路径时,不要在页面文件的后面再加上自定义参数。例如:
- 错误的写法:
http://www.alipay.com/alipay/return_url.php?xx=11
- 正确的写法:
http://www.alipay.com/alipay/return_url.php
由于支付宝会对页面跳转同步通知页面(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