文档中心 > 担保交易(已下线)

服务器异步通知参数说明

更新时间:2016/01/11 访问次数:18764

支付宝对商户的请求数据处理完成后,会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

参数 参数名称 类型(长度范围) 参数说明 是否可为空 样例
notify_id 通知校验ID String 支付宝通知校验ID,商户可以用这个流水号询问支付宝该条通知的合法性。 不可空 70fec0c2730b27528665af4517c27b95
notify_type 通知类型 String 交易状态改变时发送的同步通知。 不可空 trade_status_sync
notify_time 通知时间 Date 通知的发送时间。格式为yyyy-MM-dd HH:mm:ss。 不可空 2009-08-12 11:08:32
sign 签名 String 请参见签名验证 不可空 _p_w_l_h_j0b_gd_aejia7n_ko4_m%2Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%3D%3D
sign_type 签名方式 String DSA、RSA、MD5三个值可选,必须大写。 不可空 DSA
trade_no 交易号 String(64) 创建订单生成的交易号。最短16位,最长64位。 不可空 2010121502618142
subject 商品名称 String 商品的标题/交易标题/订单标题/订单关键字等。 不可空 订单编号:20110105154925
price 商品单价 Number 单位为:RMB Yuan。取值范围为[0.01,1000000.00],精确到小数点后两位。 不可空 328.00
quantity 商品数量 Number 商品的数量。 不可空 1
seller_email 卖家支付宝账号 String 登录时,seller_email和seller_id两者必填一个。 不可空 zhoubo_seller@alitest.com
seller_id 卖家ID String 卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。登录时,seller_email和seller_id两者必填一个。 不可空 2088102010217433
buyer_email 买家支付宝账号 String 买家支付宝账号。 不可空 zhoubo_buyer@alitest.com
buyer_id 买家ID String 买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。 不可空 2088102008416044
discount 商品折扣 Number 支付宝系统会把discount的值加到交易金额上,如果需要折扣,本参数为负数。单位为:RMB Yuan,精确到小数点后两位。缺省值为0元。 不可空 0.00
total_fee 交易金额 Number 单笔交易金总额,单位为RMB-Yuan。取值范围为[0.01,1000000.00],精确到小数点后两位。 不可空 338.00
trade_status 交易状态 String 取值范围请参见“交易状态”。 不可空 WAIT_SELLER_SEND_GOODS
is_total_fee_adjust 总价是否调整过 String 总价是否调整过。 不可空 N
use_coupon 是否使用红包 String 是否使用红包。 不可空 N
body 商品描述 String 对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。 可空 2G录音笔
out_trade_no 商户网站唯一订单号 String 对应商户网站的订单系统中的唯一订单号,非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数,原样返回。 可空 709651609727679
payment_type 收款类型 String 收款类型,只支持1:商品购买。 可空 1
logistics_type 物流类型 String 取值范围请参见“物流类型”。 可空 EMS
logistics_fee 物流费用 String 物流运费。单位为:RMB Yuan。精确到小数点后两位。缺省值为0元。 可空 15.00
logistics_payment 货物支付类型 String 取值范围请参见“物流支付类型”。 可空 BUYER_PAY
gmt_logistics_modify 物流状态更新时间 Date 物流状态更新时间。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-30 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-30 18:42:12
gmt_payment 交易支付时间 Date 该笔交易的买家付款时间。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-30 18:42:19
refund_status 退款状态 String 取值范围请参见“退款状态”。 可空 WAIT_SELLER_AGREE
gmt_refund 交易退款时间 Date 卖家退款的时间,退款通知时会发送。格式为yyyy-MM-dd HH:mm:ss。 可空 2010-12-30 18:52:12
receive_name 收货人姓名 String 收货人姓名。 可空 张三
receive_address 收货人地址 String 收货人地址。 可空 上海普陀区XX路
receive_zip 收货人邮编 String 收货人邮编。 可空 123456
receive_phone 收货人电话 String 收货人电话。 可空 02161686888
receive_mobile 收货人手机 String 收货人手机。 可空 138000000
http://商户自定义地址/alipay/notify_url.php?discount=-3.00&logistics_type=EMS&receive_zip=200062&payment_type=1&subject=nokia+n8&logistics_fee=10.00&trade_no=2010123002662342&buyer_email=zhoubo_buyer%40alitest.com&notify_type=trade_status_sync&gmt_create=2010-12-30+11%3A34%3A40&quantity=1&logistics_payment=BUYER_PAY&out_trade_no=709651609727679&notify_time=2010-12-30+11%3A35%3A31&seller_id=2088102010217433&body=nokia+n8&trade_status=WAIT_SELLER_SEND_GOODS&is_total_fee_adjust=N&gmt_payment=2010-12-30+11%3A35%3A31&total_fee=3010.00&seller_email=zhoubo_seller%40alitest.com&price=3003.00&buyer_id=2088102010217422&receive_mobile=13816843057&gmt_logistics_modify=2010-12-30+11%3A34%3A40&receive_phone=02161686888&notify_id=8fd9bf041402c20669653e69b5cece3404&receive_name=%CB%D5%CB%CC&use_coupon=N&sign_type=MD5&sign=b18c14fadbc76d2def8fa65c1ca82751&receive_address=%C9%CF%BA%A3%C6%D5%CD%D3%C7%F8

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

服务器异步通知页面特性

  1. 必须保证服务器异步通知页面(notify_url)上无任何字符,如空格、HTML标签、开发系统自带抛出的异常提示信息等;
  2. 支付宝是用POST方式发送通知信息,因此该页面中获取参数的方式,如:
    request.Form(“out_trade_no”)、$_POST[‘out_trade_no’];
  3. 支付宝主动发起通知,该方式才会被启用;
  4. 只有在支付宝的交易管理中存在该笔交易,且发生了交易状态的改变,支付宝才会通过该方式发起服务器通知(即时到账中交易状态为“等待买家付款”的状态默认是不会发送通知的);
  5. 服务器间的交互,不像页面跳转同步通知可以在页面上显示出来,这种交互方式是不可见的;
  6. 第一次交易状态改变(即时到账中此时交易状态是交易完成)时,不仅页面跳转同步通知页面会启用,而且服务器异步通知页面也会收到支付宝发来的处理结果通知;
  7. 程序执行完后必须打印输出“success”(不包含引号)。如果商户反馈给支付宝的字符不是success这7个字符,支付宝服务器会不断重发通知,直到超过24小时22分钟。
    一般情况下,25小时以内完成8次通知(通知的间隔频率一般是:2m,10m,10m,1h,2h,6h,15h);
  8. 程序执行完成后,该页面不能执行页面跳转。如果执行页面跳转,支付宝会收不到success字符,会被支付宝服务器判定为该页面程序运行出现异常,而重发处理结果通知;
  9. cookies、session等在此页面会失效,即无法获取这些数据;
  10. 该方式的调试与运行必须在服务器上,即互联网上能访问;
  11. 该方式的作用主要防止订单丢失,即页面跳转同步通知没有处理订单更新,它则去处理;
  12. 当商户收到服务器异步通知并打印出success时,服务器异步通知参数notify_id才会失效。也就是说在支付宝发送同一条异步通知时(包含商户并未成功打印出success导致支付宝重发数次通知),服务器异步通知参数notify_id是不变的。

通知触发条件

触发条件名 触发条件描述 触发条件默认值
TRADE_FINISHED 交易完成 true(触发通知)
TRADE_SUCCESS 支付成功 true(触发通知)
WAIT_BUYER_PAY 交易创建 true(触发通知)
TRADE_CLOSED 交易关闭 true(触发通知)

FAQ

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